Last active
December 22, 2023 08:16
-
-
Save douglascayers/9fbc6f2ad899f12030c31f428f912b5c to your computer and use it in GitHub Desktop.
Export and import GitHub labels between projects by running bash script with jq and curl. Uses GitHub REST API. Requires personal access token.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
# This script uses the GitHub Labels REST API | |
# https://developer.github.com/v3/issues/labels/ | |
# Provide a personal access token that can | |
# access the source and target repositories. | |
# This is how you authorize with the GitHub API. | |
# https://help.github.com/en/articles/creating-a-personal-access-token-for-the-command-line | |
GH_TOKEN="YOUR_TOKEN" | |
# If you use GitHub Enterprise, change this to "https://<your_domain>/api/v3" | |
GH_DOMAIN="https://api.github.com" | |
# The source repository whose labels to copy. | |
SRC_GH_USER="me" | |
SRC_GH_REPO="my-repo" | |
# The target repository to add or update labels. | |
TGT_GH_USER="you" | |
TGT_GH_REPO="your-repo" | |
# --------------------------------------------------------- | |
# Headers used in curl commands | |
GH_ACCEPT_HEADER="Accept: application/vnd.github.symmetra-preview+json" | |
GH_AUTH_HEADER="Authorization: Bearer $GH_TOKEN" | |
# Bash for-loop over JSON array with jq | |
# https://starkandwayne.com/blog/bash-for-loop-over-json-array-using-jq/ | |
sourceLabelsJson64=$(curl --silent -H "$GH_ACCEPT_HEADER" -H "$GH_AUTH_HEADER" ${GH_DOMAIN}/repos/${SRC_GH_USER}/${SRC_GH_REPO}/labels?per_page=100 | jq '[ .[] | { "name": .name, "color": .color, "description": .description } ]' | jq -r '.[] | @base64' ) | |
# for each label from source repo, | |
# invoke github api to create or update | |
# the label in the target repo | |
for sourceLabelJson64 in $sourceLabelsJson64; do | |
# base64 decode the json | |
sourceLabelJson=$(echo ${sourceLabelJson64} | base64 --decode | jq -r '.') | |
# try to create the label | |
# POST /repos/:owner/:repo/labels { name, color, description } | |
# https://developer.github.com/v3/issues/labels/#create-a-label | |
createLabelResponse=$(echo $sourceLabelJson | curl --silent -X POST -d @- -H "$GH_ACCEPT_HEADER" -H "$GH_AUTH_HEADER" ${GH_DOMAIN}/repos/${TGT_GH_USER}/${TGT_GH_REPO}/labels) | |
# if creation failed then the response doesn't include an id and jq returns 'null' | |
createdLabelId=$(echo $createLabelResponse | jq -r '.id') | |
# if label wasn't created maybe it's because it already exists, try to update it | |
if [ "$createdLabelId" == "null" ] | |
then | |
updateLabelResponse=$(echo $sourceLabelJson | curl --silent -X PATCH -d @- -H "$GH_ACCEPT_HEADER" -H "$GH_AUTH_HEADER" ${GH_DOMAIN}/repos/${TGT_GH_USER}/${TGT_GH_REPO}/labels/$(echo $sourceLabelJson | jq -r '.name | @uri')) | |
echo "Update label response:\n"$updateLabelResponse"\n" | |
else | |
echo "Create label response:\n"$createLabelResponse"\n" | |
fi | |
done |
This is a great script - thank you 😄
Would be cool to first delete any of the existing default repo labels as well!
To work around the 100 limit I had to add &page=2
(per 100)
${GH_DOMAIN}/repos/${SRC_GH_USER}/${SRC_GH_REPO}/labels?per_page=100&page=2
so for the next 100 it would be page 3, etc.
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
This is nice! I tried updating it to have a config file, and to transfer issues, but for some reason it only imports 9 into my other repo... i thought maybe a sleep to give the API a break would fix it... but that didn't work.. any ideas?: