1cc112c32f
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.
66 lines
1.9 KiB
ReStructuredText
66 lines
1.9 KiB
ReStructuredText
**********************************************************************
|
|
The repository
|
|
**********************************************************************
|
|
|
|
Everything starts either by creating a new repository, or by opening an
|
|
existing one.
|
|
|
|
.. contents:: Contents
|
|
:local:
|
|
|
|
|
|
Functions
|
|
===================================
|
|
|
|
.. autofunction:: 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
|
|
|
|
.. autofunction:: 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
|
|
|
|
|
|
.. autofunction:: pygit2.discover_repository
|
|
|
|
|
|
|
|
The Repository class
|
|
===================================
|
|
|
|
.. py:class:: pygit2.Repository(path)
|
|
|
|
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 :py:meth:`pygit2.Repository.checkout` method are explained in
|
|
the Checkout section.
|
|
|
|
Below there are some general attributes and methods:
|
|
|
|
.. autoattribute:: pygit2.Repository.path
|
|
.. autoattribute:: pygit2.Repository.workdir
|
|
.. autoattribute:: pygit2.Repository.is_bare
|
|
.. autoattribute:: pygit2.Repository.is_empty
|
|
.. autoattribute:: pygit2.Repository.default_signature
|
|
.. automethod:: pygit2.Repository.read
|
|
.. automethod:: pygit2.Repository.write
|
|
.. automethod:: pygit2.Repository.reset
|