print a one-line summary of the current git repository, the current branch, and the hash for the current branch head
Project description
gitsummary
Pure python utility to print a one-line summary of the current git repository, the current branch, and the hash for the current head.
Installation
pip install gitsummary
or
conda -c conda-forge install gitsummary
Usage
>>> import gitsummary
>>> gitsummary.print_cwd_git_version()
'some_git_repository:On branch main at rev cd813e5'
returns a string containing the current git repository, the current branch, and the hash of the branch head. This information is useful in scientific codes to quickly determine the origin of a plot or dataset. The string can, for example, be written in a jupyter notebook or placed in the metadata of a netcdf file.
some_git_repository
is reported as final portion of the URL of the remote 'origin'. If there is no remote named origin, it uses the full path on disk to the .git directory.
License
This project is licensed under the terms of the MIT license.
Credits
Adapted by Timothy W. Hilton from code originally written by Travis O'Brien.
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.