# gh-labeler
This is a simple CLI tool to create, delete and synchronise labels
on a github repo.
## Install
The simplest method is to install `stack` and then:
```
stack install gh-labeler
```
## Usage
Create a github OAuth token with the `public_repo` priviledge (in `repo` section),
and copy the token into a file in your HOME directory called `.gh-labeler`.
Then:
* Listing labels:
```
gh-labeler vincenthz gh-labeler list
```
* Create a label
```
gh-labeler vincenthz gh-labeler create myLabel eeb2d3
```
* Delete a label
```
gh-labeler vincenthz gh-labeler delete myLabel
```
* Synchronise from a file (See Example label file for the format):
```
gh-labeler vincenthz gh-labeler sync my-labels.txt
```
## Caveats
* The tools doesn't yet support label description, since the underlying library doesn't support them.
## Example label file
Very simple syntax of `<color> <name>`:
Example:
```
b60205 B - Bug
0e8a16 D - easy
d93f0b D - hard
fbca04 D - medium
006b75 P - high
006b75 P - low
cccccc R - duplicate
cccccc R - invalid
cccccc R - wontfix
4ef47d X - WIP
fef2c0 X - code-structure
fef2c0 X - for-discussion
fef2c0 X - help wanted
fef2c0 X - question
fef2c0 X - voting
```