Pygit2 is a set of Python bindings to the libgit2 shared library, libgit2 implements the core of Git. Pygit2 works with Python 2.6, 2.7, 3.1, 3.2 and 3.3

Pygit2 links:

http://github.com/libgit2/pygit2 -- Source code and issue tracker
http://www.pygit2.org/ -- Documentation
http://pypi.python.org/pypi/pygit2 -- Download

Quick install guide

Checkout the libgit2 stable branch:

$ git clone git://github.com/libgit2/libgit2.git -b master

Build and install libgit2 https://github.com/libgit2/libgit2/#building-libgit2---using-cmake
Install pygit2 with pip:
```
$ pip install pygit2
```

For detailed instructions check the documentation, http://www.pygit2.org/install.html

Contributing

Fork libgit2/pygit2 on GitHub, make it awesomer (preferably in a branch named for the topic), send a pull request.

Authors

57 developers have contributed at least 1 commit to pygit2:

J. David Ibáñez            Brodie Rao                 Adam Spiers
Nico von Geyso             David Versmisse            Alexander Bayandin
Carlos Martín Nieto        Rémi Duraffort             Andrew Chin
W. Trevor King             Sebastian Thiel            András Veres-Szentkirályi
Dave Borowitz              Fraser Tweedale            Benjamin Kircher
Daniel Rodríguez Troitiño  Han-Wen Nienhuys           Benjamin Pollack
Richo Healey               Petr Viktorin              Bryan O'Sullivan
Christian Boos             Alex Chamberlain           David Fischer
Julien Miotte              Amit Bakshi                David Sanders
Xu Tao                     Andrey Devyatkin           Eric Davis
Jose Plana                 Ben Davis                  Erik van Zijst
Martin Lenders             Eric Schrijver             Ferengee
Petr Hosek                 Hervé Cauwelier            Gustavo Di Pietro
Victor Garcia              Huang Huang                Hugh Cole-Baker
Xavier Delannoy            Jared Flatow               Josh Bleecher Snyder
Yonggang Luo               Jiunn Haur Lim             Jun Omae
Valentin Haenel            Sarath Lakshman            Óscar San José
Bernardo Heynemann         Vicent Marti               Ridge Kennedy
John Szakmeister           Zoran Zaric                Rui Abreu Ferreira

Changelog

0.20.3 (2014-04-XX)

A number of memory issues fixed #328 #348 #353 #355 #356
Compatibility fixes for PyPy (#338), Visual Studio 2008 (#343) and Python 3.3 (#351)
Make the sort mode parameter in Repository.walk(...) optional #337
New Object.peel(...) #342
New Index.add_all(...) #344
Introduce support for libgit2 options #350
More informative repr for Repository objects #352
Introduce support for credentials #354
Several documentation fixes #302 #336
Tests, remove temporary files #341

0.20.2 (2014-02-04)

Support pypy #209 #327 #333

Repository:

New Repository.default_signature #310

Oid:

New str(Oid) deprecates Oid.hex #322

Object:

New Object.id deprecates Object.oid #322
New TreeEntry.id deprecates TreeEntry.oid #322
New Blob.diff(...) and Blob.diff_to_buffer(...) #307
New Commit.tree_id and Commit.parent_ids #73 #311
New rich comparison between tree entries #305 #313
Now Tree.__contains__(key) supports paths #306 #316

Index:

Now possible to create IndexEntry(...) #325
Now IndexEntry.path, IndexEntry.oid and IndexEntry.mode are writable #325
Now Index.add(...) accepts an IndexEntry too #325
Now Index.write_tree(...) is able to write to a different repository #325
Fix memory leak in IndexEntry.path setter #335

Config:

New Config iterator replaces Config.foreach #183 #312

Remote:

New type Refspec #314
New Remote.push_url #315
New Remote.add_push and Remote.add_fetch #255 #318
New Remote.fetch_refspecs replaces Remote.get_fetch_refspecs() and Remote.set_fetch_refspecs(...) #319
New Remote.push_refspecs replaces Remote.get_push_refspecs() and Remote.set_push_refspecs(...) #319
New Remote.progress, Remote.transfer_progress and Remote.update_tips #274 #324
New type TransferProgress #274 #324
Fix refcount leak in Repository.remotes #321 #332

Other: #331

0.20.1 (2013-12-24)

New remote ref-specs API: #290
New Repository.reset(...): #292, #294
Export GIT_DIFF_MINIMAL: #293
New Repository.merge(...): #295
Fix Repository.blame argument handling: #297
Fix build error on Windows: #298
Fix typo in the README file, Blog → Blob: #301
Now Diff.patch returns None if no patch: #232, #303
New Walker.simplify_first_parent(): #304

0.20.0 (2013-11-24)

Upgrade to libgit2 v0.20.0: #288
New Repository.head_is_unborn replaces Repository.head_is_orphaned
Changed pygit2.clone_repository(...). Drop push_url, fetch_spec and push_spec parameters. Add ignore_cert_errors.
New Patch.additions and Patch.deletions: #275
New Patch.is_binary: #276
New Reference.log_append(...): #277
New Blob.is_binary: #278
New len(Diff) shows the number of patches: #281
Rewrite Repository.status(): #283
New Reference.shorthand: #284
New Repository.blame(...): #285
Now Repository.listall_references() and Repository.listall_branches() return a list, not a tuple: #289

License

GPLv2 with linking exception.

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License, version 2, as published by the Free Software Foundation.

In addition to the permissions in the GNU General Public License, the authors give you unlimited permission to link the compiled version of this file into combinations with other programs, and to distribute those combinations without any restriction coming from the use of this file. (The General Public License restrictions do apply in other respects; for example, they cover modification of the file, and distribution when not linked into a combined executable.)

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; see the file COPYING. If not, write to the Free Software Foundation, 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.