If you like the idea and want to learn more, please head over to[gitoxide](https://github.com/Byron/gitoxide), an

implementation of 'git' in[Rust](https://www.rust-lang.org).

*(Please note that`gitoxide` is not currently available for use in Python, and that Rust is required)*

*(Please note that`gitoxide` is not currently available for use in Python, and that Rust is required.)*

GitPython needs the`git` executable to be installed on the system and available in your`PATH` for most operations.

If it is not in your`PATH`, you can help GitPython find it by setting

the`GIT_PYTHON_GIT_EXECUTABLE=<path/to/git>` environment variable.

GitPython needs the`git` executable to be installed on the system and available in your

`PATH` for most operations.If it is not in your`PATH`, you can help GitPython find it

by settingthe`GIT_PYTHON_GIT_EXECUTABLE=<path/to/git>` environment variable.

- Git (1.7.x or newer)

- Python >= 3.7

To obtain and install a copy[from PyPI](https://pypi.org/project/GitPython/), run:

pip install GitPython

If you have downloaded the source code, run this from inside the unpacked`GitPython` directory:

pip install.

To clone the[the GitHub repository](https://github.com/gitpython-developers/GitPython) from source to work on the code, you can do it like so:

git clone https://github.com/gitpython-developers/GitPython

cd GitPython

./init-tests-after-clone.sh

If you are cloning[your own fork](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/working-with-forks/about-forks), then replace the above`git clone` command with one that gives the URL of your fork. Or use this[`gh`](https://cli.github.com/) command (assuming you have`gh` and your fork is called`GitPython`):

gh repo clone GitPython

Having cloned the repo, create and activate your[virtual environment](https://docs.python.org/3/tutorial/venv.html).

Then make an[editable install](https://pip.pypa.io/en/stable/topics/local-project-installs/#editable-installs):

pip install -e".[test]"

If you want to do that*and* you want the versions in GitPython's git submodules to be used, then pass`-e git/ext/gitdb` and/or`-e git/ext/gitdb/gitdb/ext/smmap` to`pip install`. This can be done in any order, and in separate`pip install` commands or the same one, so long as`-e` appears before*each* path. For example, you can install GitPython, gitdb, and smmap editably in the currently active virtual environment this way:

pip install -e".[test]" -e git/ext/gitdb -e git/ext/gitdb/gitdb/ext/smmap

Ensure testing libraries are installed. This is taken care of already if you installed with:

pip install -e".[test]"

Otherwise, you can run:

pip install -r test-requirements.txt

To test, run:

pytest

To lint, and apply automatic code formatting, run:

pre-commit run --all-files

To typecheck, run:

mypy -p git