Empty Thoughts

I just released GitPython version 0.1.6. This version has some backwards incompatible changes to be sure to read through the changes below before upgrading.

GitPython is a python library that makes it easy to interact with Git repositories. The emphasis so far has been on introspection and less on manipulation, although some manipulation level functionality is present. For a good tutorial on getting started, check out the source distribution documentation files.

This version includes Sphinxification of the documentation. If you haven’t worked with Sphinx yet, I highly recommend it for documenting your projects. I just touched the surface with it and I was really amazed on the “out-of-the-box” functionality.

I hope you enjoy GitPython.

CHANGES

General

• Added in Sphinx documentation.
• Removed ambiguity between paths and treeishs. When calling commands that accept treeish and path arguments and there is a path with the same name as a treeish git cowardly refuses to pick one and asks for the command to use the unambiguous syntax where ’—’ seperates the treeish from the paths.
• Repo.commits, Repo.commits_between, Reop.commits_since, Repo.commit_count, Repo.commit, Commit.count and Commit.find_all all now optionally take a path argument which constrains the lookup by path. This changes the order of the positional arguments in Repo.commits and Repo.commits_since.

Commit

• Commit.message now contains the full commit message (rather than just the first line) and a new property Commit.summary contains the first line of the commit message.
• Fixed a failure when trying to lookup the stats of a parentless commit from a bare repo.

Diff

• The diff parser is now far faster and also addresses a bug where sometimes b_mode was not set.
• Added support for parsing rename info to the diff parser. Addition of new properties Diff.renamed, Diff.rename_from, and Diff.rename_to.

Head

• Corrected problem where branches was only returning the last path component instead of the entire path component following refs/heads/.

Repo

• Modified the gzip archive creation to use the python gzip module.
• Corrected commits_between always returning None instead of the reversed list.