ghlabels

GitHub Labels

A command line tool that helps you manage your GitHub repository issue labels.

Installation

Using npm:

npm install --global ghlabels

Or Yarn:

yarn global add ghlabels

Usage

Basic usage

You can provide options as arguments or leave then blank and they will be prompted.

ghlabels --repository foo/bar --token foobar --file ./path/somefile

Note: As an alternative you can provide options as enviroment variables (e.g. GITHUB_LABELS_TOKEN).

Copy from another repo

ghlabels copy --source seegno/github-labels --target foo/bar --token foobar

List

ghlabels list --repository seegno/github-labels

Client

You can also import ghlabels client and use it as a module:

import { copyLabelsFromRepo, listLabels, updateLabels } from 'ghlabels';
 
// Example of copying labels from a source repo.
copyLabelsFromRepo({
  source: 'seegno/github-labels'
  target: 'foo/bar',
  token: 'foobar'
});
 
// Example of listing all labels from a repo.
listLabels({
  repository: 'seegno/github-labels',
  token: 'foobar'
});
 
// Example of updating all labels from a repo.
updateLabels({
  repository: 'foo/bar',
  token: 'foobar'
});

Contributing & Development

Contributing

Found a bug or want to suggest something? Take a look first on the current and closed issues. If it is something new, please submit an issue.

Develop

It will be awesome if you can help us evolve github-labels. Want to help?

1. Fork it.
2. npm install.
3. Hack away.
4. Run the tests: npm test.
5. Create a Pull Request.

Release

npm version [<newversion> | major | minor | patch] -m "Release %s"

License

MIT