Passthrough to your current directory's VCS.
A command-line shortcut that runs your current directory's VCS command,
whether it's git, subversion (svn), or mercurial (hg). Requires Python
3.10 or newer.
$ pip install --user gOr install with uv:
$ uv tool install gWorking inside a uv-managed project:
$ uv add gFor one-off use without installing globally:
$ uvx g$ gYou can test the unpublished version of g before its release.
-
pip:
$ pip install --user --upgrade --pre g -
uv:
$ uv tool install --prerelease=allow g$ uv add g --prerelease allow$ uvx --from 'g' --prerelease allow g -
pipx:
$ pipx install --suffix=@next g --pip-args '\--pre' --forceThen use
g@next --help.
$ g statusInside a git checkout, that runs git status; inside svn, svn status;
inside mercurial, hg status. g intercepts only -V/--version —
everything else, including -h/--help, forwards straight to the detected
VCS. The VCS's own stdout and stderr print through unchanged, but g's exit
status does not mirror the wrapped command's: a completed run always exits
0. Outside a VCS directory, g prints No VCS found in current directory. to stderr and stops.
Full detection order and command reference: https://g.git-pull.com/cli/index.html.
2021-12-05: Thanks to John Shanahan (@_shanahanjrs) for giving g use g
Your donations fund development of new features, testing and support. Your money will go directly to maintenance and development of the project. If you are an individual, feel free to give whatever feels right for the value you get out of the project.
See donation options at https://tony.sh/support.html.
- Python support: >= 3.10
- VCS supported: git(1), svn(1), hg(1)
- Source: https://github.com/vcs-python/g
- Docs: https://g.git-pull.com
- Changelog: https://g.git-pull.com/history.html
- API: https://g.git-pull.com/api.html
- Issues: https://github.com/vcs-python/g/issues
- Test Coverage: https://codecov.io/gh/vcs-python/g
- pypi: https://pypi.python.org/pypi/g
- Open Hub: https://www.openhub.net/p/g
- License: MIT.