README
¶
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!"
Directories