Github Labeler
The purpose of this application is to sync your default labels with a repository hosted by Github. Labeler automatically merges your labels into the repository using a template file.
After the run, missing labels are added, unknown labels are removed and existing labels are checked for changes.
Please note that label links to issues are lost when a label is removed.
Usage
Just run the binary and define the following arguments:
-tYour Github Token used for Github API requests-oYour Github Username-rThe related repository name
labeler merge -t <token> -o <owner> -r <repo>
Optional arguments:
--dry-modeActivates dry mode (sumulation, no changes are made)--skip-deleteSkips deletion of unknown labels
You can also use the following environment variables to define default values.
LABELER_TOKENLABELER_OWNERLABELER_REPO
Define labels
Labeler uses a JSON template file to merge the labels. The file must be placed under ~/.config/labeler/labels.json.
See labels.json for an example.
Development
Debugging
To set arguments in debug mode, create an .env file in the root of the repository.
Then add the following content to it:
LABELER_TOKEN=<GH API bearer token>
LABELER_OWNER=<GH username>
LABELER_REPO=<GH repository name>
If the file exists, VSCode applies the parameters as environment variables for the running process.
Alternatively, you can override the parameter by setting the args section in the .vscode/launch.json file.
Please make sure you never push that file to Github. Because of this, the .env file is already excluded in the .gitignore file.
Build
Currently the app has not been added to any package manager.
If you want to use the app, you need to install and build it yourself.
go build -o labeler ./cmd/app/*.go
After that, just copy the binary to your preferred location.
cp labeler /usr/bin/
Alternatively, Go can also take care for the installation:
go install cmd/app/*.go
