pygit2 - libgit2 bindings in Python

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

Links:

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

How to install

• Check http://www.pygit2.org/install.html

Changelog

0.23.3 (2016-01-01)

• New Repository.create_blob_fromiobase(...) #490 #577
• New Repository.describe(...) #585
• Fix Signature default encoding, UTF-8 now #581
• Fixing pip install pygit2, should install cffi first
• Unit tests, fix binary diff test #586
• Document that Diff.patch can be None #587

0.23.2 (2015-10-11)

• Unify callbacks system for remotes and clone #568
• New TreeEntry._name #570
• Fix segfault in Tag._message #572
• Documentation improvements #569 #574

API changes to clone:

# Before
clone_repository(..., credentials, certificate)

# Now
callbacks = RemoteCallbacks(credentials, certificate)
clone_repository(..., callbacks)

API changes to remote:

# Before
def transfer_progress(stats):
    ...

remote.credentials = credentials
remote.transfer_progress = transfer_progress
remote.fetch()
remote.push(specs)

# Now
class MyCallbacks(RemoteCallbacks):
    def transfer_progress(self, stats):
        ...

callbacks = MyCallbacks(credentials)
remote.fetch(callbacks=callbacks)
remote.push(specs, callbacks=callbacks)

0.23.1 (2015-09-26)

• Improve support for cffi 1.0+ #529 #561
• Fix Remote.push #557
• New TreeEntry.type #560
• New pygit2.GIT_DIFF_SHOW_BINARY #566

0.23.0 (2015-08-14)

• Update to libgit2 v0.23 #540
• Now Repository.merge_base(...) returns None if no merge base is found #550
• Documentation updates #547

API changes:

• How to set identity (aka signature) in a reflog has changed:

  # Before
  signature = Signature('foo', 'bar')
  ...
  reference.set_target(target, signature=signature, message=message)
  repo.set_head(target, signature=signature)
  remote.fetch(signature=signature)
  remote.push(signature=signature)
  
  # Now
  repo.set_ident('foo', 'bar')
  ...
  reference.set_target(target, message=message)
  repo.set_head(target)
  remote.push()
  
  # The current identity can be get with
  repo.ident
  

• Some remote setters have been replaced by methods:

  # Before                       # Now
  Remote.url = url               Repository.remotes.set_url(name, url)
  Remote.push_url = url          Repository.remotes.set_push_url(name, url)
  
  Remote.add_fetch(refspec)      Repository.remotes.add_fetch(name, refspec)
  Remote.add_push(refspec)       Repository.remotes.add_push(name, refspec)
  
  Remote.fetch_refspecs = [...]  removed, use the config API instead
  Remote.push_refspecs = [...]   removed, use the config API instead
  

0.22.1 (2015-07-12)

Diff interface refactoring #346 (in progress):

• New iter(pygit2.Blame)

• New pygit2.DiffDelta, pygit2.DiffFile and pygit.DiffLine

• API changes, translation table:

  Hunk                => DiffHunk
  Patch.old_file_path => Patch.delta.old_file.path
  Patch.new_file_path => Patch.delta.new_file.path
  Patch.old_id        => Patch.delta.old_file.id
  Patch.new_id        => Patch.delta.new_file.id
  Patch.status        => Patch.delta.status
  Patch.similarity    => Patch.delta.similarity
  Patch.is_binary     => Patch.delta.is_binary
  Patch.additions     => Patch.line_stats[1]
  Patch.deletions     => Patch.line_stats[2]
  

• DiffHunk.lines is now a list of DiffLine objects, not tuples

New features:

• New Repository.expand_id(...) and Repository.ahead_behind(...) #448
• New prefix parameter in Repository.write_archive #481
• New Repository.merge_trees(...) #489
• New Repository.cherrypick(...) #436 #492
• New support for submodules #499 #514
• New Repository.merge_file_from_index(...) #503
• Now Repository.diff supports diffing two blobs #508
• New optional fetch parameter in Remote.create #526
• New pygit2.DiffStats #406 #525
• New Repository.get_attr(...) #528
• New level optional parameter in Index.remove #533
• New repr(TreeEntry) #543

Build and install improvements:

• Make pygit work in a frozen environment #453
• Make pygit2 work with pyinstaller #510

Bugs fixed:

• Fix memory issues #477 #487 #520
• Fix TreeEntry equality testing #458 #488
• Repository.write_archive fix handling of symlinks #480
• Fix type check in Diff[...] #495
• Fix error when merging files with unicode content #505

Other:

• Documentation improvements and fixes #448 #491 #497 #507 #517 #518 #519 #521 #523 #527 #536
• Expose the pygit2.GIT_REPOSITORY_INIT_* constants #483

0.22.0 (2015-01-16)

New:

• Update to libgit2 v0.22 #459
• Add support for libgit2 feature detection (new pygit2.features and pygit2.GIT_FEATURE_*) #475
• New Repository.remotes (RemoteCollection) #447

API Changes:

• Prototype of clone_repository changed, check documentation
• Removed clone_into, use clone_repository with callbacks instead
• Use Repository.remotes.rename(name, new_name) instead of Remote.rename(new_name)
• Use Repository.remotes.delete(name) instead of Remote.delete()
• Now Remote.push(...) takes a list of refspecs instead of just one
• Change Patch.old_id, Patch.new_id, Note.annotated_id, RefLogEntry.oid_old and RefLogEntry.oid_new to be Oid objects instead of strings #449

Other:

• Fix init_repository when passing optional parameters workdir_path, description, template_path, initial_head or origin_url #466 #471
• Fix use-after-free when patch outlives diff #457 #461 #474
• Documentation improvements #456 #462 #465 #472 #473
• Make the GPL exception explicit in setup.py #450

0.21.4 (2014-11-04)

• Fix credentials callback not set when pushing #431 #435 #437 #438
• Fix Repository.diff(...) when treeish is "empty" #432
• New Reference.peel(...) renders Reference.get_object() obsolete #434
• New, authenticate using ssh agent #424
• New Repository.merge_commits(...) #445
• Make it easier to run when libgit2 not in a standard location #441
• Documentation: review install chapter
• Documentation: many corrections #427 #429 #439 #440 #442 #443 #444

0.21.3 (2014-09-15)

Breaking changes:

• Now Repository.blame(...) returns Oid instead of string #413
• New Reference.set_target(...) replaces the Reference.target setter and Reference.log_append(...) #414
• New Repository.set_head(...) replaces the Repository.head setter #414
• Repository.merge(...) now uses the SAFE_CREATE strategy by default #417

Other changes:

• New Remote.delete() #418 #420
• New Repository.write_archive(...) #421
• Now Repository.checkout(...) accepts branch objects #408
• Fix refcount leak in remotes #403 #404 #419
• Various fixes to clone_repository(...) #399 #411 #425 #426
• Fix build error in Python 3 #401
• Now pip install pygit2 installs cffi first #380 #407
• Add support for PyPy3 #422
• Documentation improvements #398 #409

0.21.2 (2014-08-09)

• Fix regression with Python 2, IndexEntry.path returns str (bytes in Python 2 and unicode in Python 3)
• Get back IndexEntry.oid for backwards compatibility
• Config, iterate over the keys (instead of the key/value pairs) #395
• Diff.find_similar supports new threshold arguments #396
• Optimization, do not load the object when expanding an oid prefix #397

0.21.1 (2014-07-22)

• Install fix #382
• Documentation improved, including #383 #385 #388
• Documentation, use the read-the-docs theme #387
• Coding style improvements #392
• New Repository.state_cleanup() #386
• New Index.conflicts #345 #389
• New checkout option to define the target directory #390

Backward incompatible changes:

• Now the checkout strategy must be a keyword argument.

  Change Repository.checkout(refname, strategy) to Repository.checkout(refname, strategy=strategy)

  Idem for checkout_head, checkout_index and checkout_tree

0.21.0 (2014-06-27)

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 by id through the API to follow libgit2 conventions.
• Merge API overhaul following changes in libgit2.
• New Remote.rename(...) replaces Remote.name = ...
• Now Remote.fetch() returns a TransferProgress object.
• Now Config.get_multivar(...) returns an iterator instead of a list.

New features:

• New Config.snapshot() and Repository.config_snapshot()
• New Config methods: get_bool(...), get_int(...), parse_bool(...) and parse_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 heads Repository.head = <Oid> #377

Other:

• Fix again build with VS2008 #364
• Fix Blob.diff(...) and Blob.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

0.20.3 (2014-04-02)

• 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

Authors

102 developers have contributed at least 1 commit to pygit2:

J. David Ibáñez           Carlos Martín Nieto       Nico von Geyso
W. Trevor King            Dave Borowitz             Daniel Rodríguez Troitiño
Richo Healey              Christian Boos            Julien Miotte
Richard Möhn              Xu Tao                    Jose Plana
Matthew Duggan            Matthew Gamble            Martin Lenders
Petr Hosek                Victor Garcia             Xavier Delannoy
Yonggang Luo              Patrick Steinhardt        Valentin Haenel
Michael Jones             Bernardo Heynemann        John Szakmeister
Vlad Temian               Brodie Rao                Nicolas Dandrimont
David Versmisse           Rémi Duraffort            Santiago Perez De Rosso
Sebastian Thiel           Alok Singhal              Fraser Tweedale
Han-Wen Nienhuys          Leonardo Rhodes           Petr Viktorin
Ron Cohen                 Thomas Kluyver            Alex Chamberlain
Alexander Bayandin        Amit Bakshi               Andrey Devyatkin
Arno van Lumig            Ben Davis                 Eric Schrijver
Greg Fitzgerald           Hervé Cauwelier           Huang Huang
Ian P. McCullough         Jack O'Connor             Jared Flatow
Jiunn Haur Lim            Jun Omae                  Kaarel Kitsemets
Kevin KIN-FOO             Masud Rahman              Michael Sondergaard
Sarath Lakshman           Vicent Marti              Zoran Zaric
Adam Spiers               Andrew Chin               András Veres-Szentkirályi
Ash Berlin                Benjamin Kircher          Benjamin Pollack
Bryan O'Sullivan          Chason Chaffin            Chris Rebert
Colin Watson              Daniel Bruce              David Fischer
David Sanders             David Six                 Devaev Maxim
Eric Davis                Erik Meusel               Erik van Zijst
Ferengee                  Guille -bisho-            Gustavo Di Pietro
Holger Frey               Hugh Cole-Baker           Jasper Lievisse Adriaanse
Josh Bleecher Snyder      Justin Clift              Kyriakos Oikonomakos
Lukas Fleischer           Mathieu Bridon            Nicolás Sanguinetti
Noah Fontes               Óscar San José            Peter Dave Hello
Philippe Ombredanne       Ridge Kennedy             Ross Nicoll
Rui Abreu Ferreira        Sheeo                     Soasme
Vladimir Rutsky           chengyuhang               earl

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.