Command line tool to send GitHub pull requests
Project description
git-pull-request is a command line tool to send GitHub or Pagure pull-request from your terminal.
Installation
Use the standard Python installation method:
pip3 install git-pull-request
Although it might not be up to date with the latest code on GitHub Fedora 28+ users can also download straight via package manager DNF:
sudo dnf install git-pull-request
Usage
Once you’ve made your commits into a branch, just type:
git pull-request
This will:
Fork the upstream repository into your account (if needed)
Add your forked repository as a remote named “github” (if needed)
Force push your current branch to your remote
Create a pull-request for your current branch to the remote matching branch, or master by default.
If you add more commits to your branch later, or need to rebase your branch to edit commits, you’ll just need to run git pull-request to update your pull-request. git-pull-request automatically detects that a pull-request has been opened for your current working branch.
Workflow advice
Caching Credentials
GitHub has a good documentation about using git credential.
The full documentation is available on the git-scm.com website.
GitHub
If you set up 2-Factors Authentication for your GitHub account, you should create a personal token and request the repo permission, then use that as your password.
Pagure Token
Pagure uses API key, you need to create one by visiting your settings and requesting the Fork a project and Modify an existing project ACL.
Creating Branches
When sending pull-requests, it’s preferable to do so from your own branch. You can create your own branch from master by doing:
$ git checkout -b myownbranch --track origin/master
This will checkout a new branch called myownbranch that is a copy of master. Using the –track option makes sure that the upstream source branch is written in your .git/config file. This will allow git-pull-request to know to which branch send the pull-request.
Since this is long to type, you can use an alias in git to make it faster:
$ git config --global alias.nb '!git checkout --track $(git config branch.$(git rev-parse --abbrev-ref HEAD).remote)/$(git rev-parse --abbrev-ref HEAD) -b'
This will create a git nb alias that will create a new branch tracking the current branch and checking it out. You can then use it like that:
$ git nb foobar Branch foobar set up to track remote branch master from origin. Switched to a new branch 'foobar'
Configuration via git config
Most git-pull-request command line arguments can be store into your git configuration.
For a particular repository, if you get tired of using:
$ git pull-request --fork never
You can set the option with git and use the command without any arguments:
$ git config git-pull-request.fork never $ git pull-request
You can also set the option globally to have a custom default for all your repositories with:
$ git config --global git-pull-request.fork always $ git pull-request
Difference with hub
The wrapper hub provides hub fork and hub pull-request as command line tools to fork and create pull-requests.
Unfortunately, it’s hard to combine these tools in an automated implementation for a complete workflow.
For example: If you need to update your pull-request, there’s no way to identify existing pull requests, so calling hub pull-request would just open a new pull-request.
git-pull-request wraps all of these operations into one convenient tool.
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 git_pull_request-6.0.2-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 10ddf275f1904223a656fcfdf8a4afd013247b4953be122fee289a87c1e417f6 |
|
MD5 | f27bfaf3275acdbcbd8205fe2c91c44a |
|
BLAKE2b-256 | 67ba5058fd0ffd498ff729c90e47e5604c638fe5b421fd5c7cdc4fd992dae73e |