CityApper/dulwich @ etcd

Fără Descriere

Jelmer Vernooij b208126868 Add multi_server, initial doc.		9 ani în urmă
bin	4513d940aa Fix exit code for check-ignore.	7 ani în urmă
devscripts	1b8231acc6 Add script for updating preamble.	8 ani în urmă
docs	aa2a305841 Fix all flake8 style issues.	7 ani în urmă
dulwich	b208126868 Add multi_server, initial doc.	7 ani în urmă
examples	3ea005cc2c Fix examples on Python3.	8 ani în urmă
.coveragerc	2341eafa35 Add coverage config.	7 ani în urmă
.gitignore	0cdd4697e6 Git ignore *.pyd	7 ani în urmă
.mailmap	b381a9c23e Add mailmap.	7 ani în urmă
.testr.conf	e46d3b3a75 testr: Allow id list files (fixes parallel runs).	14 ani în urmă
.travis.yml	def22c8966 Run style tests in travis.	7 ani în urmă
AUTHORS	506c44802c Add test for reset behaviour fixes, simplify handling of ZERO_SHA a bit.	7 ani în urmă
CONTRIBUTING.md	3f77727252 Slight tweak to CONTRIBUTING.	7 ani în urmă
COPYING	7098611ac3 As agreed by all contributors, change the license from:	8 ani în urmă
MANIFEST.in	faa5474a44 Update MANIFEST.in.	7 ani în urmă
Makefile	aa2a305841 Fix all flake8 style issues.	7 ani în urmă
NEWS	5ff68872bd Handle race conditions with pack directory's mtime. Fixes #541	7 ani în urmă
README.md	d691d0dce5 Add Windows build status badge.	7 ani în urmă
README.swift.md	fb9c1c29bf Add md extension for nicer display on e.g. github.	8 ani în urmă
TODO	6bd957f231 Initial work towards git-upload-archive support.	9 ani în urmă
appveyor.yml	91ef7633b0 Attempt to fix 64 bit builds on Windows.	7 ani în urmă
build.cmd	91ef7633b0 Attempt to fix 64 bit builds on Windows.	7 ani în urmă
dulwich.cfg	13fced2e1d Change homepage to www.dulwich.io.	9 ani în urmă
setup.cfg	f114640dcf Add trivial setup.cfg file.	9 ani în urmă
setup.py	37165f9d26 Attempt to fix build on appveyor.	7 ani în urmă
tox.ini	f4c3a804d4 Run tests on Python3.3.	7 ani în urmă

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"

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 doc/ 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