Python commodity wrapper around GitPython
Project description
git_wrapper
Python wrapper around GitPython
Free software: MIT license
Documentation: https://git-wrapper.readthedocs.io.
Features
TODO
Notes
This library only supports python 3. Some features may still work with python 2.7 but not all of the syntax and features may be compatible.
Development
There are several dependencies needed to build and work on git_wrapper. Using your distribution’s package manager, install these system packages:
GitPython
git_wrapper uses the upcoming standard of Pipfiles via pipenv. This is integrated into our Makefile and once you have the above dependencies, you can simply run:
make dev
This will install our dev environment for the package via pipenv. It is installed with –user, so it does not affect your site-packages. Pipenv creates a unique virtualenv for us, which you can activate via:
pipenv shell
See the pipenv documentation for more detail.
Documentation
To build the documentation on your checkout, simply run:
make docs
We plan to get this published in the near future, and this README will be updated when that happens.
Contributions
All new code should include tests that excercise the code and prove that it works, or fixes the bug you are trying to fix. Any Pull Request without tests will not be accepted.
Pushing a new release
Prepare a patch to update the version number (example)
You may want to check the HISTORY.rst file renders correctly before committing, as the twine upload will fail later if it doesn’t. Install one of these:
# dnf install python3-readme-renderer $ pip install readme-renderer
Then run the following command:
$ python -m readme_renderer HISTORY.rst -o /tmp/HISTORY.html
Once that’s merged, tag that patch and push the new tag to the repo
Run the following commands:
$ rm dist/* $ python setup.py sdist bdist_wheel $ twine upload --verbose dist/*
(You need to have a PyPI account with the right permissions for that last step.)
Credits
This package was created with Cookiecutter and the audreyr/cookiecutter-pypackage project template.
History
0.0.1 (2018-06-25)
First release on PyPI.
0.1.0 (2018-07-05)
Second release on PyPI.
Base functionality
git cherry support
Removing pipenv support.
0.2.0 (2019-01-18)
Third release on PyPI.
Major refactor to better align the data model.
- Added several new features
Log diff generation
Improved clone support including bare repos and destroy/reclone
Revert support
Support for rebasing to a branch or commit.
0.2.1 (2019-04-15)
Fourth release on PyPI.
- Added several new features
Add function to compare commit references
Add tagging functions
0.2.2 (2020-07-20)
Fifth release on PyPI.
Added new function to check if a commit exists on a given remote branch
0.2.3 (2020-12-15)
Added checkout parameter to branch creation and hard reset functions
0.2.4 (2021-01-11)
Added new function to cherry-pick a given commit
New parameter added to apply_patch() to preserve square brackets in commit messages
Added new function to grep logs
Deprecated location of other log functions in GitBranch, they should now be called from GitLog
0.2.5 (2021-01-12)
Fix RST formatting issue to unbreak Pypi uploads
0.2.6 (2021-02-11)
Add new log function to get a single commit’s information
0.2.7 (2021-04-28)
Fix bug in apply_diff whereby new files didn’t get picked up
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_wrapper-0.2.7-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 33c71f67e0384a5aefac5eb99139dec0254154da08dc094ea7c98f5972504cea |
|
MD5 | cc5cd228378ac523c03e6cf1ae29066a |
|
BLAKE2b-256 | b6bda50cfd34ccb68ec7d12f99e62e69eea5588ab5e11f5ca00edf5e20555113 |