Repo Creator

This is a small tool to quickly prepare GitHub repositories, bootstrapped with files, projects and labels. It is meant to be used in education to let students work under a specific GitHub org with some files, labels and settings pre-setup.

Usage

This is a CLI tool, you can find binaries for all major operating systems under releases.

Auth

This tool uses a GitHub personal token, set in env vars (or --auth-token flag).

$ export AUTH_TOKEN=<token>
$ repo-create

Create repositories

This command will create empty repositories in a given org with a given prefix, these can also be set to private.

Example:

$ repo-create create --org itfactory-tm -n 22 --prefix Keuzeproject1-MIN  --private

Clone to repositories

Clone will clone a repo from a given source and will automatically push the content to the empty repositories.

Example:

$ repo-create clone --org itfactory-tm -n 22 --prefix Keuzeproject1-MIN --source https://github.com/itfactory-tm/Keuzeproject1_MIN.git

Add labels

This will create a new label in all repositories with a given color and name

Example:

$ repo-create label --org itfactory-tm -n 22 --prefix Keuzeproject1-MIN --name "21:45 - 23:15" --color "ffffff"

Remove labels

This will remove a label in all repositories with a given name, meant to remove unneeded defaults

Example:

$ repo-create rm-label --org itfactory-tm -n 22 --prefix Keuzeproject1-MIN --name "bug"

Delete repositories

This command will delete repositories in a given org with a given prefix, these can also be set to private. NOTE: tjis functon will not warn you before deletion!

Example:

$ repo-create delete --org itfactory-tm -n 22 --prefix Keuzeproject1-MIN

Branch protection

This will enable branch protection to enforce code review

Example:

$ repo-create protect --org itfactory-tm -n 22 --prefix Keuzeproject1-MIN

Add projects

This will add a project to the repo prefilled with empty collumns

Example:

$ repo-create project --org itfactory-tm -n 22 --prefix Keuzeproject1-MIN --name Kanban --collumns todo,doing,done

Add issues

This will add a issue to the repo prefilled with a given content

Example:

$ repo-create issue --org itfactory-tm -n 22 --prefix Keuzeproject1-MIN --title "Good luck!" --content "yes you can!"