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.

Wen Heping submitted a port of GitPython to be included with FreeBSD. It has been great to see all the people that have taken interest in GitPython and have worked to support the project.

I’m pleased to announce the release of GitPython 0.1.4. I appreciate all of the work from contributors on this release, especially from Florian Apolloner who has really taken the lead and managed everything.

DOWNLOAD

You can get it directly from cheeseshop at: http://pypi.python.org/pypi/GitPython/

Or checkout the tag with:

$ git fetch --tags 
$ git checkout -b 0.1.4 0.1.4 

CHANGES

• renamed git_python to git. Be sure to delete all pyc files before testing.

Commit

• Fixed problem with commit stats not working under all conditions.

Git

• Renamed module to cmd.
• Removed shell escaping completely.
• Added support for stderr, stdin, and with_status.
• git_dir is now optional in the constructor for git.Git. Git now falls back to os.getcwd() when git_dir is not specified.
• add a with_exceptions keyword argument to git commands. GitCommandError is raised when the exit status is non-zero.
• add support for a GIT_PYTHON_TRACE environment variable. GIT_PYTHON_TRACE allows us to debug GitPython’s usage of git through the use of an environment variable.

Tree

• Fixed up problem where name doesn’t exist on root of tree.

Repo

• Corrected problem with creating bare repo. Added Repo.create alias.

Please let us know if you find problems.

We’re at a point where we have to decide where to go with the library, so if you have ideas, we’d like to know that as well.