GitHub Action to manage labels

The GitHub Action for managing labels of the GitHub repository from a provided file. It is particularly helpful when you want to setup the same labels for all your repositories.

Usage

Example Workflow file

• Synchronize labels from a YAML file:

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout
        uses: actions/checkout@v2

      - name: Synchronize labels
        uses: julbme/gh-action-manage-label@v1
        with:
          from: .github/config/labels.yml
          skip_delete: false
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

• Synchronize labels from multiple YAML files:

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout
        uses: actions/checkout@v2

      - name: Synchronize labels
        uses: julbme/gh-action-manage-label@v1
        with:
          from: |
            https://raw.githubusercontent.com/my-org/my-repositorty/path-to-folder-with/common-labels.yml
            .github/config/labels.yml
            .github/config/other-labels.yml
          skip_delete: false
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

• Label configuration structure in YAML file:

- name: "bug"
  color: "D73A4A"
  description: "Something isn't working"

- name: "critical"
  color: "FF1493"
  description: "High urgency label"

- name: "docs"
  color: "808000"
  description: "Improvements or additions to documentation"

Inputs

Name	Type	Default	Description
from	string	.github/config/labels.yml	Path of the file containing the labels. Can be .yml, .yaml or .json. A HTTP/HTTPS URL can be provided if the file is stored in another repository.
skip_delete	boolean	false	If true, the process will not delete existing labels that are not defined in the file.

Note : the from field also accepts a multi-line parameter in order to accept multiple source files. If there is an overlap on the labels between the files, the last one will take over the others.

Outputs

No output.

Contributing

This project is totally open source and contributors are welcome.