A Python script for bulk renaming the default branch of your GitHub repositories using the API
Project description
The default git/GitHub branch name is oppressive terminology (more info). It is easy to change the branch name for a single repository or for new repositories. This script makes it easy to rename your default branch on GitHub repositories in bulk.
Usage
Installation
To install, run
python -m pip install rename-github-default-branch
Then, create a GitHub.com personal access token with the repo
permission scope and set the environment variable:
export RENAME_GITHUB_TOKEN=YOUR_PERSONAL_ACCESS_TOKEN
Renaming branches on GitHub
Then to rename the default branch to main
for a specific repository (you must have write access):
rename-github-default-branch -r dfm/rename-github-default-branch -t main
Or for all the repos that you own (excluding forks):
rename-github-default-branch -t main
You can also provide regular expressions to match against the repository name. For example:
rename-github-default-branch -t main -p "dfm/*" -p "exoplanet-dev/*"
Updating local branches
To update your local repository, you can run the following:
git fetch origin main
git checkout -b main origin/main
git branch -D master
where main
is the name of the new default branch and origin
is the name of the git remote.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for rename_github_default_branch-0.0.3.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 61bdf9d5085e7c636eebc6d30d647f1015a64140dc3b8b6085a66bbaff01c049 |
|
MD5 | 72db1c0ffb554db1dcf9840a88241da3 |
|
BLAKE2b-256 | fc438c75eb5a13a0f68ee2ebd2f1818d700d7b8989d8bf32574695909e58025a |
Hashes for rename_github_default_branch-0.0.3-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | afce3eb0304bcd2172fd9df5085c620118634d6f1fbda0feae4f7cb2f788ad5c |
|
MD5 | 377b4faacfe11658459d752346aac54f |
|
BLAKE2b-256 | c1f7989b678c737e26e31347a79587ba39c15a07cb853890162de2398eae9ad2 |