CityApper/dulwich @ f80816cad6a3f154f230e507691dbbf41ffaf715

Sen descrición

Jelmer Vernooĳ f80816cad6 Add get_object_by_path.		%!s(int64=7) %!d(string=hai) anos
bin	9ff8c01f14 Simple describe implementation	%!s(int64=7) %!d(string=hai) anos
devscripts	8fd5e8df93 Add script for updating preamble.	%!s(int64=9) %!d(string=hai) anos
docs	d40d6a2a54 Fix the tutorial tests on python3. Fixes: #573	%!s(int64=7) %!d(string=hai) anos
dulwich	f80816cad6 Add get_object_by_path.	%!s(int64=7) %!d(string=hai) anos
examples	078c40d0cf Add example for using memoryrepo.	%!s(int64=7) %!d(string=hai) anos
.coveragerc	56cd6fb069 Set source in coveragerc rather than passing on command-line.	%!s(int64=7) %!d(string=hai) anos
.gitignore	2a03d84239 Ignore .pyo files.	%!s(int64=7) %!d(string=hai) anos
.mailmap	5723070923 Update mailmap.	%!s(int64=7) %!d(string=hai) anos
.testr.conf	97383d783a testr: Allow id list files (fixes parallel runs).	%!s(int64=15) %!d(string=hai) anos
.travis.yml	b4aed09039 Disable python 3.8-dev for now; flakes checker is broken on 3.8-dev.	%!s(int64=7) %!d(string=hai) anos
AUTHORS	2a49cdea0a Update AUTHORS.	%!s(int64=7) %!d(string=hai) anos
CONTRIBUTING.md	bb946b37d4 Reformat to 80 columns.	%!s(int64=8) %!d(string=hai) anos
COPYING	26375edf02 As agreed by all contributors, change the license from:	%!s(int64=9) %!d(string=hai) anos
MANIFEST.in	750e3ffef9 Update MANIFEST.in.	%!s(int64=9) %!d(string=hai) anos
Makefile	56cd6fb069 Set source in coveragerc rather than passing on command-line.	%!s(int64=7) %!d(string=hai) anos
NEWS	f80816cad6 Add get_object_by_path.	%!s(int64=7) %!d(string=hai) anos
README.md	6c583696db Fix appveyor build link.	%!s(int64=7) %!d(string=hai) anos
README.swift.md	abb28485e0 Fix typo	%!s(int64=8) %!d(string=hai) anos
TODO	b1a0112b74 Update TODO.	%!s(int64=8) %!d(string=hai) anos
appveyor.yml	88ef05310e Add test for automatic pythonw fallback of outstream/errstream	%!s(int64=7) %!d(string=hai) anos
build.cmd	0c5264e23f Attempt to fix 64 bit builds on Windows.	%!s(int64=8) %!d(string=hai) anos
dulwich.cfg	c496808e41 Change homepage to www.dulwich.io.	%!s(int64=10) %!d(string=hai) anos
requirements.txt	002da5c22c Enable SSL verification for `urllib3`	%!s(int64=8) %!d(string=hai) anos
setup.py	5d498faaf4 Fix arguments to setup.py - summary doesn't exist.	%!s(int64=7) %!d(string=hai) anos
tox.ini	d6f0e765d4 Run tests on Python3.3.	%!s(int64=8) %!d(string=hai) anos

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: www.dulwich.io

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
<Commit 015fc1267258458901a94d228e39f0a378370466>
>>> 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 Vernooĳ <jelmer@jelmer.uk>
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.3, 3.4, 3.5, 3.6 and Pypy.

README.md