A tool to fix some issues with GitLab's handling of global admin labels
![Black Lives Matter!][badge-blm]
![!!UNMAINTAINED!!][badge-unmaintained]
[!CAUTION]
This old thing served its purpose dutifully and without complaint, but the
time where it was useful has long since passed. GitLab has better label
support these days… plus I switched to GitHub 🙃
This tool will help propagate into the repos of your choice those nice shiny new
GitLab global admin labels you worked so hard on. See
below.
This was built to address
these issues with
GitLab.
npm install -g gitlab-fix-labels
General command syntax:
gitlab-fix-labels GITLAB_API_STARTPOINT_URI YOUR_AUTH_TOKEN YOUR_ACTION YOUR_TARGET
Possible actions:
add
- add your admin labels to your target repo(s); existing labels will not
be touched; any duplicates will be skipped.
delete
- completely and utterly delete all of a repository’s labels.
replace
- the same as calling delete
followed by add
.
Your target:
The target must either be the string all
(case sensitive) or an integer larger
than 0.
gitlab-fix-labels https://git.mysite.org/api/v4 myspecial_tokenhere add 10
gitlab-fix-labels https://newgitlab.com/api/v5 my2ndspecial_tokenhere delete all
gitlab-fix-labels http://git.lol/api/v4/ myotherspecial_tokenhere replace all
gitlab-fix-labels http://git.lol/api/v5/ special_token2 replace 555
To completely replace the labels on one project with your custom admin global
defaults (set in the administrator area of GitLab):
gitlab-fix-labels GITLAB_API_STARTPOINT_URI YOUR_AUTH_TOKEN replace YOUR_TARGET
To completely replace the labels on ALL projects with your global admin
defaults:
gitlab-fix-labels GITLAB_API_STARTPOINT_URI YOUR_AUTH_TOKEN replace all
To append your global admin defaults to ALL projects (not deleting existing
labels):
gitlab-fix-labels GITLAB_API_STARTPOINT_URI YOUR_AUTH_TOKEN add all
In lieu of a formal styleguide, take care to maintain the existing coding style.
Lint and test your code!
[badge-blm]: https://xunn.at/badge-blm ‘Join the movement!’
[badge-unmaintained]:
https://xunn.at/badge-unmaintained
‘Unfortunately, this project is unmaintained (forks welcome!)’