Files
deb-python-pygit2/docs/repository.rst
Carlos Martín Nieto 1cc112c32f docs: adjust to recent changes
It seems I have been forgetting to update the documentation with the
last few  changes, so adjust to the oid -> id renaming and add missing
attributes to the listings.
2014-01-25 04:25:42 +01:00

1.9 KiB

The repository

Everything starts either by creating a new repository, or by opening an existing one.

Contents

Functions

pygit2.init_repository

Example:

>>> from pygit2 import init_repository
>>> repo = init_repository('test')            # Creates a non-bare repository
>>> repo = init_repository('test', bare=True) # Creates a bare repository

pygit2.clone_repository

Example:

>>> from pygit2 import clone_repository
>>> repo_url = 'git://github.com/libgit2/pygit2.git'
>>> repo_path = '/path/to/create/repository'
>>> repo = clone_repository(repo_url, repo_path) # Clones a non-bare repository
>>> repo = clone_repository(repo_url, repo_path, bare=True) # Clones a bare repository

pygit2.discover_repository

The Repository class

The Repository constructor only takes one argument, the path of the repository to open.

Example:

>>> from pygit2 import Repository
>>> repo = Repository('pygit2/.git')

The API of the Repository class is quite large. Since this documentation is orgaized by features, the related bits are explained in the related chapters, for instance the pygit2.Repository.checkout method are explained in the Checkout section.

Below there are some general attributes and methods:

pygit2.Repository.path

pygit2.Repository.workdir

pygit2.Repository.is_bare

pygit2.Repository.is_empty

pygit2.Repository.default_signature

pygit2.Repository.read

pygit2.Repository.write

pygit2.Repository.reset