Sin descripción

Jelmer Vernooij 75be96f1ed Add libgpgme-dev. hace 5 años
bin 72aec0c79f Add support for creating signed tags. hace 5 años
devscripts 1b8231acc6 Add script for updating preamble. hace 8 años
docs a2de9c199d Switch to sphinx theme 'agogo'. hace 6 años
dulwich 4a92a7b088 Merge branch 'http-client-fix-url-redirect-location' of git://github.com/anlambert/dulwich hace 5 años
examples f73261458e Add example for using memoryrepo. hace 6 años
.coveragerc 95d44cdfa1 Set source in coveragerc rather than passing on command-line. hace 6 años
.gitignore fdcff89992 Ignore generated API files. hace 6 años
.mailmap 4c5c2752fa Update mailmap. hace 6 años
.testr.conf e46d3b3a75 testr: Allow id list files (fixes parallel runs). hace 14 años
.travis.yml 75be96f1ed Add libgpgme-dev. hace 5 años
AUTHORS 5148c0c22d Fix url redirect location handling in HttpGitClient hace 5 años
CONTRIBUTING.rst 7da7187c2a Convert CONTRIBUTING and README to rst. hace 6 años
COPYING 7098611ac3 As agreed by all contributors, change the license from: hace 8 años
MANIFEST.in 1c53c47702 More md => rst. hace 6 años
Makefile 8706eed1fc Generate API docs in sphinx. hace 6 años
NEWS d8a1bed443 Add support for prune/prune_tags arguments to porcelain.fetch. hace 5 años
README.rst 23f90b34c1 Fix badges in README. hace 6 años
README.swift.rst 1c53c47702 More md => rst. hace 6 años
TODO 1282de4286 Update TODO. hace 6 años
appveyor.yml d6f79401bf Drop support for Python 3 < 3.4. This is because pkg_resources (which get used by setuptools and mock) no longer supports 3.3 and earlier. hace 6 años
build.cmd 91ef7633b0 Attempt to fix 64 bit builds on Windows. hace 7 años
dulwich.cfg 13fced2e1d Change homepage to www.dulwich.io. hace 9 años
requirements.txt 8bbabacd26 Require urllib>=1.23, because of CVE-2018-20060 hace 6 años
setup.cfg 9d1182c0fb Move flake8 configuration to setup.cfg. hace 6 años
setup.py cd03d80a7a Add 'extra' pgp, including dependency on gpg. hace 5 años
tox.ini f4c3a804d4 Run tests on Python3.3. hace 7 años

README.rst

.. image:: https://travis-ci.org/dulwich/dulwich.png?branch=master
:alt: Build Status
:target: https://travis-ci.org/dulwich/dulwich

.. image:: https://ci.appveyor.com/api/projects/status/mob7g4vnrfvvoweb?svg=true
:alt: Windows Build Status
:target: https://ci.appveyor.com/project/jelmer/dulwich/branch/master

This is the Dulwich project.

It aims to provide an interface to git repos (both local and remote) that
doesn't call out to git directly but instead uses pure Python.

**Main website**:

**License**: Apache License, version 2 or GNU General Public License, version 2 or later.

The project is named after the part of London that Mr. and Mrs. Git live in
in the particular Monty Python sketch.

Installation
------------

By default, Dulwich' setup.py will attempt to build and install the optional C
extensions. The reason for this is that they significantly improve the performance
since some low-level operations that are executed often are much slower in CPython.

If you don't want to install the C bindings, specify the --pure argument to setup.py::

$ python setup.py --pure install

or if you are installing from pip::

$ pip install dulwich --global-option="--pure"

Note that you can also specify --global-option in a
`requirements.txt `_
file, e.g. like this::

dulwich --global-option=--pure

Getting started
---------------

Dulwich comes with both a lower-level API and higher-level plumbing ("porcelain").

For example, to use the lower level API to access the commit message of the
last commit::

>>> from dulwich.repo import Repo
>>> r = Repo('.')
>>> r.head()
'57fbe010446356833a6ad1600059d80b1e731e15'
>>> c = r[r.head()]
>>> c

>>> c.message
'Add note about encoding.\n'

And to print it using porcelain::

>>> from dulwich import porcelain
>>> porcelain.log('.', max_entries=1)
--------------------------------------------------
commit: 57fbe010446356833a6ad1600059d80b1e731e15
Author: Jelmer Vernooij
Date: Sat Apr 29 2017 23:57:34 +0000

Add note about encoding.

Further documentation
---------------------

The dulwich documentation can be found in docs/ and
`on the web `_.

The API reference can be generated using pydoctor, by running "make pydoctor",
or `on the web `_.

Help
----

There is a *#dulwich* IRC channel on the `Freenode `_, and
`dulwich-announce `_
and `dulwich-discuss `_
mailing lists.

Contributing
------------

For a full list of contributors, see the git logs or `AUTHORS `_.

If you'd like to contribute to Dulwich, see the `CONTRIBUTING `_
file and `list of open issues `_.

Supported versions of Python
----------------------------

At the moment, Dulwich supports (and is tested on) CPython 2.7, 3.4, 3.5, 3.6 and Pypy.