Pygit2 is a set of Python bindings to the libgit2 shared library, libgit2 implements the core of Git. Pygit2 works with Python 2.7, 3.2, 3.3, 3.4 and pypy.
It is likely to work with Python 2.6 and 3.1, but these versions are not officially supported.
Pygit2 links:
- http:https://github.com/libgit2/pygit2 -- Source code and issue tracker
- http:https://www.pygit2.org/ -- Documentation
- http:https://pypi.python.org/pypi/pygit2 -- Download
Checkout the libgit2 stable branch:
$ git clone git:https://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 cffi $ pip install pygit2
For detailed instructions check the documentation, http:https://www.pygit2.org/install.html
Fork libgit2/pygit2 on GitHub, make it awesomer (preferably in a branch named for the topic), send a pull request.
66 developers have contributed at least 1 commit to pygit2:
J. David Ibáñez Rémi Duraffort Adam Spiers Nico von Geyso Sebastian Thiel Alexander Bayandin Carlos Martín Nieto Fraser Tweedale Andrew Chin W. Trevor King Han-Wen Nienhuys András Veres-Szentkirályi Dave Borowitz Leonardo Rhodes Benjamin Kircher Daniel Rodríguez Troitiño Petr Viktorin Benjamin Pollack Richo Healey Thomas Kluyver Bryan O'Sullivan Christian Boos Alex Chamberlain Daniel Bruce Julien Miotte Amit Bakshi David Fischer Xu Tao Andrey Devyatkin David Sanders Jose Plana Ben Davis Devaev Maxim Martin Lenders Eric Schrijver Eric Davis Petr Hosek Hervé Cauwelier Erik Meusel Victor Garcia Huang Huang Erik van Zijst Xavier Delannoy Ian P. McCullough Ferengee Yonggang Luo Jack O'Connor Gustavo Di Pietro Valentin Haenel Jared Flatow Hugh Cole-Baker Michael Jones Jiunn Haur Lim Josh Bleecher Snyder Bernardo Heynemann Jun Omae Óscar San José John Szakmeister Sarath Lakshman Ridge Kennedy Brodie Rao Vicent Marti Rui Abreu Ferreira David Versmisse Zoran Zaric earl
Highlights:
- Drop official support for Python 2.6, and add support for Python 3.4 #376
- Upgrade to libgit2 v0.21.0 #374
- Start using cffi #360 #361
Backward incompatible changes:
- Replace
oid
byid
through the API to follow libgit2 conventions. - Merge API overhaul following changes in libgit2.
- New
Remote.rename(...)
replacesRemote.name = ...
- Now
Remote.fetch()
returns aTransferProgress
object. - Now
Config.get_multivar(...)
returns an iterator instead of a list.
New features:
- New
Config.snapshot()
andRepository.config_snapshot()
- New
Config
methods:get_bool(...)
,get_int(...)
,parse_bool(...)
andparse_int(...)
#357 - Blob: implement the memory buffer interface #362
- New
clone_into(...)
function #368 - Now
Index
can be used alone, without a repository #372 - Add more options to
init_repository
#347 - Support
Repository.workdir = ...
and support setting detached headsRepository.head = <Oid>
#377
Other:
- Fix again build with VS2008 #364
- Fix
Blob.diff(...)
andBlob.diff_to_buffer(...)
arguments passing #366 - Fail gracefully when compiling against the wrong version of libgit2 #365
- Several documentation improvements and updates #359 #375 #378
- 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
Repository:
- New
Repository.default_signature
#310
Oid:
- New
str(Oid)
deprecatesOid.hex
#322
Object:
- New
Object.id
deprecatesObject.oid
#322 - New
TreeEntry.id
deprecatesTreeEntry.oid
#322 - New
Blob.diff(...)
andBlob.diff_to_buffer(...)
#307 - New
Commit.tree_id
andCommit.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
andIndexEntry.mode
are writable #325 - Now
Index.add(...)
accepts anIndexEntry
too #325 - Now
Index.write_tree(...)
is able to write to a different repository #325 - Fix memory leak in
IndexEntry.path
setter #335
Config:
Remote:
- New type
Refspec
#314 - New
Remote.push_url
#315 - New
Remote.add_push
andRemote.add_fetch
#255 #318 - New
Remote.fetch_refspecs
replacesRemote.get_fetch_refspecs()
andRemote.set_fetch_refspecs(...)
#319 - New
Remote.push_refspecs
replacesRemote.get_push_refspecs()
andRemote.set_push_refspecs(...)
#319 - New
Remote.progress
,Remote.transfer_progress
andRemote.update_tips
#274 #324 - New type
TransferProgress
#274 #324 - Fix refcount leak in
Repository.remotes
#321 #332
Other: #331
- 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
returnsNone
if no patch: #232, #303 - New
Walker.simplify_first_parent()
: #304
- Upgrade to libgit2 v0.20.0: #288
- New
Repository.head_is_unborn
replacesRepository.head_is_orphaned
- Changed
pygit2.clone_repository(...)
. Droppush_url
,fetch_spec
andpush_spec
parameters. Addignore_cert_errors
. - New
Patch.additions
andPatch.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()
andRepository.listall_branches()
return a list, not a tuple: #289
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.