CityApper/dulwich @ merge

Sen descrición

Jelmer Vernooĳ a724f4ea3f Really basic beginnings of a merge module.		%!s(int64=6) %!d(string=hai) anos
bin	6572813375 Simple describe implementation	%!s(int64=6) %!d(string=hai) anos
devscripts	1b8231acc6 Add script for updating preamble.	%!s(int64=8) %!d(string=hai) anos
docs	2d1e979d77 Fix the tutorial tests on python3. Fixes: #573	%!s(int64=6) %!d(string=hai) anos
dulwich	a724f4ea3f Really basic beginnings of a merge module.	%!s(int64=6) %!d(string=hai) anos
examples	f73261458e Add example for using memoryrepo.	%!s(int64=6) %!d(string=hai) anos
.coveragerc	95d44cdfa1 Set source in coveragerc rather than passing on command-line.	%!s(int64=6) %!d(string=hai) anos
.gitignore	01eb67e3b3 Ignore .pyo files.	%!s(int64=6) %!d(string=hai) anos
.mailmap	4c5c2752fa Update mailmap.	%!s(int64=6) %!d(string=hai) anos
.testr.conf	e46d3b3a75 testr: Allow id list files (fixes parallel runs).	%!s(int64=14) %!d(string=hai) anos
.travis.yml	40a7495218 Don't run greenlet-based tests on 3.7/3.8-dev.	%!s(int64=6) %!d(string=hai) anos
AUTHORS	1d1d8a128d Update AUTHORS.	%!s(int64=6) %!d(string=hai) anos
CONTRIBUTING.md	19350d5dae Reformat to 80 columns.	%!s(int64=6) %!d(string=hai) anos
COPYING	7098611ac3 As agreed by all contributors, change the license from:	%!s(int64=8) %!d(string=hai) anos
MANIFEST.in	faa5474a44 Update MANIFEST.in.	%!s(int64=7) %!d(string=hai) anos
Makefile	95d44cdfa1 Set source in coveragerc rather than passing on command-line.	%!s(int64=6) %!d(string=hai) anos
NEWS	1d74b7ac14 Start on 0.19.7.	%!s(int64=6) %!d(string=hai) anos
README.md	c2da1ee3a6 Fix appveyor build link.	%!s(int64=6) %!d(string=hai) anos
README.swift.md	353c3342bd Fix typo	%!s(int64=7) %!d(string=hai) anos
TODO	1282de4286 Update TODO.	%!s(int64=6) %!d(string=hai) anos
appveyor.yml	91ef7633b0 Attempt to fix 64 bit builds on Windows.	%!s(int64=7) %!d(string=hai) anos
build.cmd	91ef7633b0 Attempt to fix 64 bit builds on Windows.	%!s(int64=7) %!d(string=hai) anos
dulwich.cfg	13fced2e1d Change homepage to www.dulwich.io.	%!s(int64=9) %!d(string=hai) anos
requirements.txt	48e2ef8c2f Enable SSL verification for `urllib3`	%!s(int64=6) %!d(string=hai) anos
setup.cfg	1b6509fa3d Implement dulwich.porcelain.ls_files, avoid digraph in setup.cfg.	%!s(int64=6) %!d(string=hai) anos
setup.py	1d74b7ac14 Start on 0.19.7.	%!s(int64=6) %!d(string=hai) anos
tox.ini	f4c3a804d4 Run tests on Python3.3.	%!s(int64=7) %!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