git pp
A (tiny) Git utility for auto-committing and concurrent pushing.
Powered by asyncio, with no dependency besides python>=3.10 and git.
Features
- Auto-stages and commits with custom or generated commit messages
- Pushes to multiple or all remotes of a git repository concurrently with
asyncio - Operates on any number of git repositories at the same time
Demo
In this demo, git pp did the following in ~/config and ~/gui repos:
- (Concurrently) Auto staged all changes and commits with ISO-8601 timestamps as commit messages;
- (Concurrently) Pushed the changes in the checked out branch to all of their remotes, in this case, they’re origin and lab.
Use cases and example usage
- You have multiple remotes registered on a local git repository (or more) and want to push the changes to all or some of the remotes fast and efficiently.
# Use --push-only or -po
$ git pp --push-only # this pushes to all remotes of the current git repository, does not stages or commits
$ git pp --push-only --remote [one or more remotes] # only pushes to the specified remotes
$ git pp -po --timeout 10 # terminates pushing to one remotes if it takes more than 10 seconds
$ git pp -po -b dev ~/my-proj ~/my-proj2 # pushes the dev branch to all remotes in ~/my-proj and ~/my-proj2 repository
- You're tired of using
git add --all && git commitevery time you make a little change and want to automate this across one or more repositories.
$ git pp # stages all files in the current git repository and commits with a timestamp as the commit message
$ git pp -m 'Initial commit' # custom commit message
$ git pp --no-status # don't show git status and git add outputs
And you can do both of the above (auto-commit and push) with --push:
# Use --push or -p
$ git pp --push # stages, commits and pushes to all remotes.
$ git pp --push --remote [one or more remotes]
$ git pp -p --timeout 10
$ git pp -p -b dev ~/my-proj ~/my-proj2
Installation
First make sure the git executable is installed and in your $PATH.
Note that non-UNIX systems are not officially supported.
pipx
This is the recommended installation method.
$ pipx install git-pp
pip
$ pip install git-pp
AUR
For Archlinux.
$ yay -S python-git-pp
Usage
You can either invoke this tool with git-pp or git pp,
--help is unsupported when using the latter.
$ git pp -h
usage: git pp [-h] [-m COMMIT_MESSAGE] [-v] [-so] [-p] [-po] [-r REMOTE [REMOTE ...]] [-b BRANCH] [-f] [-t TIMEOUT] [DIRS ...]
Git utility for auto-committing and concurrent pushing
positional arguments:
DIRS Dirs to operate on (default: ['.'])
options:
-h, --help show this help message and exit
-m COMMIT_MESSAGE, --commit-message COMMIT_MESSAGE
commit message (default: None)
-v, --version show program's version number and exit
-so, --status-only Prints status only (default: False)
-p, --push Push to all remotes (default: False)
-po, --push-only Push to all remotes, without pre_pull (default: False)
-r REMOTE [REMOTE ...], --remote REMOTE [REMOTE ...]
Remote name (default: None)
-b BRANCH, --branch BRANCH
Branch name (default: None)
-f, --force Force push (default: False)
-t TIMEOUT, --timeout TIMEOUT
Timeout for a single push (default: None)
Develop
$ git clone https://github.com/tddschn/git-pp.git
$ cd git-pp
$ poetry install
Metadata
Release files for git-pp 2.0.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| git_pp-2.0.0.tar.gz | 8.9 kB | Without provenance | Details for git_pp-2.0.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| git_pp-2.0.0-py3-none-any.whl | Python 3 | none | any | Details for git_pp-2.0.0-py3-none-any.whl |
Total release size: 18.4 kB
Release files / git_pp-2.0.0.tar.gz
| Download URL | git_pp-2.0.0.tar.gz |
|---|---|
| Size | 8.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
b0f810bcff0c4a10476d79a66f04427f4c8cdadb30cd8b27568f769a2416efda
|
|
BLAKE2b-256 checksum How to use checksums |
109843f1356faa681a03d4f27013db2810367e686077bdec23c40aadda57fe83
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
poetry/1.8.4 CPython/3.12.10 Darwin/24.4.0
|
Release files / git_pp-2.0.0-py3-none-any.whl
| Download URL | git_pp-2.0.0-py3-none-any.whl |
|---|---|
| Size | 9.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
cceeb7e766ae783cccd533904b210df3e1701223da14eb28ed4b3db87ac2b6d9
|
|
BLAKE2b-256 checksum How to use checksums |
b7d1af0e865fdc6a8f5ad838212c275c689395a8faef3312295e2f35c2af9e65
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
poetry/1.8.4 CPython/3.12.10 Darwin/24.4.0
|
Security for git-pp 2.0.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.