CityApper/dulwich @ d178ed1562dcd1e7910d2edd4ffd4125ce1d05f1

Bez popisu

3 Větve

Jelmer Vernooĳ d178ed1562 Release 0.18.5		před 8 roky
bin	c5f5aa5b2c Implement 'dulwich push'.	před 8 roky
devscripts	8fd5e8df93 Add script for updating preamble.	před 9 roky
docs	48182146e7 Return symrefs from fetch_pack.	před 8 roky
dulwich	56589b18be Prevent setting SSH arguments in SSH URLs when using subprocess SSH client.	před 8 roky
examples	9644000854 Fix examples on Python3.	před 9 roky
.coveragerc	02ab6de363 Add coverage config.	před 9 roky
.gitignore	4a690990d5 Git ignore *.pyd	před 8 roky
.mailmap	2021bb9622 Add mailmap.	před 8 roky
.testr.conf	97383d783a testr: Allow id list files (fixes parallel runs).	před 15 roky
.travis.yml	84dc580b0f Run style tests in travis.	před 8 roky
AUTHORS	8e73b7207c Update AUTHORS/NEWS.	před 8 roky
CONTRIBUTING.md	bac4d0cc53 Slight tweak to CONTRIBUTING.	před 9 roky
COPYING	26375edf02 As agreed by all contributors, change the license from:	před 9 roky
MANIFEST.in	750e3ffef9 Update MANIFEST.in.	před 9 roky
Makefile	668eae5698 Ignore style errors under .tox/	před 8 roky
NEWS	d178ed1562 Release 0.18.5	před 8 roky
README.md	39cf032bf9 Point to current doc folder (doc -> docs)	před 8 roky
README.swift.md	abb28485e0 Fix typo	před 8 roky
TODO	06099e6e54 Initial work towards git-upload-archive support.	před 10 roky
appveyor.yml	0c5264e23f Attempt to fix 64 bit builds on Windows.	před 8 roky
build.cmd	0c5264e23f Attempt to fix 64 bit builds on Windows.	před 8 roky
dulwich.cfg	c496808e41 Change homepage to www.dulwich.io.	před 10 roky
setup.cfg	6c7be27bc3 Add trivial setup.cfg file.	před 10 roky
setup.py	c6208e6a0d Start on 0.18.5.	před 8 roky
tox.ini	d6f0e765d4 Run tests on Python3.3.	před 8 roky

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