Skip to content
tag

GitHub Action

PR labels

v1.0.9 Latest version

PR labels

tag

PR labels

Extract labels from the PR that this build belongs to and make them available to other actions.

Installation

Copy and paste the following snippet into your .yml file.

              

- name: PR labels

uses: joerick/[email protected]

Learn more about this action in joerick/pr-labels-action

Choose a version

PR Labels Github Action

Screenshot

A Github action that extracts labels from the PR that this build belongs to, and makes them available to other actions. Labels are available as step outputs and environment variables that you can use in later steps in your action.

Outputs

labels

The labels on this PR. A string containing tag identifiers surrounded with spaces for easy use with contains.

labels-object

The labels on this PR. A dictionary containing true where a label exists.

Example usage

jobs:
  test:
    steps:
      - name: Get PR labels
        id: pr-labels
        uses: joerick/[email protected]

How do I use this?

Perhaps you have a test that you only want to run when PR label Test Flimbomble is set. Your workflow should look like this:

jobs:
  test:
    steps:
      - name: Get PR labels
        id: pr-labels
        uses: joerick/[email protected]

      # GITHUB_PR_LABEL_TEST_FLIMBOMBLE was set by pr-labels-action
      - run: |
          bin/run_normal_tests
          if [ -n "$GITHUB_PR_LABEL_TEST_FLIMBOMBLE" ]; then
            bin/run_flimbomble_tests
          fi

      # or you can use the action output.
      # For the label name, use lowercase kebab-case and surround with spaces
      - run: |
          bin/publish_flimbomble_test_results
        if: contains(steps.pr-labels.outputs.labels, ' test-flimbomble ')