CityApper/dulwich @ 027e6f9ae0ba8fd311ea9ce21395c27a433763be

Tidak Ada Deskripsi

160 Rilis

Jelmer Vernooĳ 027e6f9ae0 Raise exception when a caller tries to fetch SHA1s that are not in any refs.		7 tahun lalu
bin	9ff8c01f14 Simple describe implementation	7 tahun lalu
devscripts	8fd5e8df93 Add script for updating preamble.	9 tahun lalu
docs	d40d6a2a54 Fix the tutorial tests on python3. Fixes: #573	7 tahun lalu
dulwich	027e6f9ae0 Raise exception when a caller tries to fetch SHA1s that are not in any refs.	7 tahun lalu
examples	078c40d0cf Add example for using memoryrepo.	7 tahun lalu
.coveragerc	56cd6fb069 Set source in coveragerc rather than passing on command-line.	7 tahun lalu
.gitignore	2a03d84239 Ignore .pyo files.	7 tahun lalu
.mailmap	5723070923 Update mailmap.	7 tahun lalu
.testr.conf	97383d783a testr: Allow id list files (fixes parallel runs).	15 tahun lalu
.travis.yml	d3589626e8 Drop travis build on python 3.5-dev.	7 tahun lalu
AUTHORS	2a49cdea0a Update AUTHORS.	7 tahun lalu
CONTRIBUTING.md	bb946b37d4 Reformat to 80 columns.	8 tahun lalu
COPYING	26375edf02 As agreed by all contributors, change the license from:	9 tahun lalu
MANIFEST.in	750e3ffef9 Update MANIFEST.in.	9 tahun lalu
Makefile	56cd6fb069 Set source in coveragerc rather than passing on command-line.	7 tahun lalu
NEWS	027e6f9ae0 Raise exception when a caller tries to fetch SHA1s that are not in any refs.	7 tahun lalu
README.md	6c583696db Fix appveyor build link.	7 tahun lalu
README.swift.md	abb28485e0 Fix typo	8 tahun lalu
TODO	b1a0112b74 Update TODO.	8 tahun lalu
appveyor.yml	88ef05310e Add test for automatic pythonw fallback of outstream/errstream	7 tahun lalu
build.cmd	0c5264e23f Attempt to fix 64 bit builds on Windows.	8 tahun lalu
dulwich.cfg	c496808e41 Change homepage to www.dulwich.io.	10 tahun lalu
requirements.txt	002da5c22c Enable SSL verification for `urllib3`	8 tahun lalu
setup.cfg	dc195f1f37 Implement dulwich.porcelain.ls_files, avoid digraph in setup.cfg.	7 tahun lalu
setup.py	3438c4ed09 Start on 0.19.7.	7 tahun lalu
tox.ini	d6f0e765d4 Run tests on Python3.3.	8 tahun lalu

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