| FazBrowse GitHub Viewer | Trending | | Home |
| Tools: [Download Repo ZIP] [Original HTTPS Page] |
| Name | Name | Last commit date | ||
|---|---|---|---|---|
Note: This repository is currently in flux, getting rewritten in Rust. Leaving the historical README below and I will remove it once the rewrite is more mature This repository holds a number of scripts to assist in administering and migrating GitHub repositories and Organizations Most deal diredtly with the GitHub API.
You can find the binaries for your system in the releases section. Download the zip and extract to your file system. You can then use the binary.
Use the built in help commands to understand what options are available
$ ./github-tools --help main ✱
github-tools 0.1.0
Chris McIntosh <chocrates@github.com>
Suite of tools used for GitHub Organizaton/Repository management
USAGE:
github-tools --token <TOKEN> <SUBCOMMAND>
OPTIONS:
-h, --help Print help information
-t, --token <TOKEN> GitHub Personal Access Token with access to Organization or Repositories
-V, --version Print version information
SUBCOMMANDS:
consolidate-teams Consolidates all users in all with access to a repository to the
specified teams in a properties file
delete-repositories Delete Repositories contained in csv file
help Print this message or the help of the given subcommand(s)
transfer-repositories Transfer repositories contained in csv file to new org, including
teams and members NOTE: Team permissions are not maintained and
will be transfered as read See:
https://docs.github.com/en/rest/repos/repos#transfer-a-repository
Currently only the transfer-repositories subcommand is complete, usage is as follows:
$ ./github-tools transfer-repositories --help main ✱
github-tools-transfer-repositories
Transfer repositories contained in csv file to new org, including teams and members NOTE: Team
permissions are not maintained and will be transfered as read See:
https://docs.github.com/en/rest/repos/repos#transfer-a-repository
USAGE:
github-tools --token <TOKEN> transfer-repositories [OPTIONS]
OPTIONS:
-e, --example
Prints an example csv file to stdio and then exits This data can be saved and edited to
create your input file
-f, --file <FILE>
Path to CSV file with a single column containing repositories to delete in format
"owner/repository"
-h, --help
Print help information
-o, --organization <ORGANIZATION>
Organization in which to transfer the repositories
Note: --token is required in all cases other than help, even for --example
Example Usage:
$ ./github-tools --token $GITHUB_TOKEN transfer-repositories --example > example.csv main ✱ $ cat example.csv main ✱ repository organization/repository # Edit the file here to add your repos
$ ./github-tools --token $GITHUB_TOKEN transfer-repositories --file example.csv --organization <target organization>
Currently creating a new issues is the best way to address errors and questions.
| Back | FazBrowse Home | New Git URL |