BeforePush
A lightweight CLI that checks whether your Git branch is ready before pushing or opening a pull request.
Features
- Check if the current directory is a Git repository
- Show the current branch
- Detect uncommitted or untracked changes
- Check upstream branch configuration
- Check if the current branch is behind a target branch
- Support custom target branches
- Clean terminal output with Rich
Installation
Install BeforePush from PyPI:
pip install before-push
Usage
Run BeforePush inside a Git repository:
beforepush
By default, BeforePush checks your current branch against main.
You can specify a different target branch with --target:
beforepush --target develop
Demo
Contributing
Contributions are welcome! See CONTRIBUTING.md for development setup, testing, and contribution guidelines.
Scope
BeforePush focuses on local Git branch readiness.
It does not create or merge pull requests, authenticate with GitHub, perform code reviews, manage remote repositories, or modify Git history.
License
This project is licensed under the MIT License.
1 maintainer
Release files for before-push 0.1.4
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| before_push-0.1.4.tar.gz | 6.7 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| before_push-0.1.4-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 13.2 kB
Release files / before_push-0.1.4.tar.gz
| Download URL | before_push-0.1.4.tar.gz |
|---|---|
| Size | 6.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
e379992580abe86bdbe699076a56be628552ced5ef1479e524e86aa1e4787c4b
|
|
BLAKE2b-256 checksum How to use checksums |
4d236a1951234c857950e9936b5b6791519b2b6127f0081008384e314d21b48c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.11.32 {"installer":{"name":"uv","version":"0.11.32","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / before_push-0.1.4-py3-none-any.whl
| Download URL | before_push-0.1.4-py3-none-any.whl |
|---|---|
| Size | 6.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
b60061d220fe626eca12a0936eda53d2993026311510c483cd0200e1ced78630
|
|
BLAKE2b-256 checksum How to use checksums |
8aa876d2f36f57b00bf89160ca5ad76f8d9b33d11c7860e88d663b10d33eadaf
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.11.32 {"installer":{"name":"uv","version":"0.11.32","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
