Quick examples

A list of some common command-line operations and their pygit2 equivalents.

Creating a new repository with git init

>>> pygit2.init_repository('repo_name', False) <pygit2.repository.Repository object at 0x10f08b680>

Viewing a commit with git show d370f56

>>> repo = pygit2.Repository('/path/to/repository') >>> commit = repo['d370f56']

Viewing the last commit message

>>> repo[repo.head.oid].message 'commit message'

Traversing the commit history with git log

>>> last = repo[repo.head.oid] >>> for commit in repo.walk(last.oid, pygit2.GIT_SORT_TIME): >>> print(commit.message) # or some other operation

Listing all branches with git branch

>>> regex = re.compile('^refs/heads/') >>> filter(lambda r: regex.match(r), repo.listall_references())

Similarly, listing all tags with git tag

>>> regex = re.compile('^refs/tags') >>> filter(lambda r: regex.match(r), repo.listall_references())

Listing all files in the last commit

>>> for e in repo[repo.head.oid].tree: >>> print(e.name)