2
0

Тайлбар байхгүй

Jelmer Vernooij e1861c9268 Bump ruff from 0.8.0 to 0.8.1 (#1461) 2 өдөр өмнө
.github c6c9c36b21 2 долоо хоног өмнө
bin c0a8e05380 Add SPDX license identifier to Python files and shell scripts 1 долоо хоног өмнө
crates 69c1b064e6 use modern APIs 2 долоо хоног өмнө
devscripts c0a8e05380 Add SPDX license identifier to Python files and shell scripts 1 долоо хоног өмнө
docs 3eaddc6db8 Drop outdated performance.txt file. Fixes #1411 1 сар өмнө
dulwich 3a051fc783 Fix typing 6 өдөр өмнө
examples c0a8e05380 Add SPDX license identifier to Python files and shell scripts 1 долоо хоног өмнө
fuzzing c0a8e05380 Add SPDX license identifier to Python files and shell scripts 1 долоо хоног өмнө
testdata c1738f5fe1 Move testdata out of code directory. 2 жил өмнө
tests 6b63699c40 Reformat 1 долоо хоног өмнө
.codespellrc 2368e6658c Fix codespell issues 6 сар өмнө
.coveragerc 95d44cdfa1 Set source in coveragerc rather than passing on command-line. 6 жил өмнө
.deepsource.toml d6fc2e465e chore: refactor code quality issues 3 жил өмнө
.gitignore 35792cdd46 Initial OSS-Fuzz Integration and First Fuzzing Test 7 сар өмнө
.mailmap 4c5c2752fa Update mailmap. 6 жил өмнө
.readthedocs.yaml 39e1ff4db4 rename .readthedocs.yml -> .readthedocs.yaml 1 жил өмнө
.stestr.conf 245331a60d Move tests to root. Fixes #1024 7 сар өмнө
.testr.conf 245331a60d Move tests to root. Fixes #1024 7 сар өмнө
AUTHORS 493658afb1 Update NEWS, AUTHORS. 3 жил өмнө
CODE_OF_CONDUCT.md 2368e6658c Fix codespell issues 6 сар өмнө
CONTRIBUTING.rst 92749cd5a9 Refer to Rust rather than C bindings 3 сар өмнө
COPYING 9861693656 Add SPDX license identifier to COPYING and README.rst 1 долоо хоног өмнө
Cargo.lock 41b25527bc Bump pyo3 from 0.23.1 to 0.23.2 2 өдөр өмнө
Cargo.toml f4fe6b07ca Bump pyo3 version 2 долоо хоног өмнө
MANIFEST.in 47faecd764 Ship testdata/ and tests/ in sdist. Fixes #1292 7 сар өмнө
Makefile 8bb9c9e84d Add more types, courtesy of ruff 2 долоо хоног өмнө
NEWS 4ab204e797 Update NEWS 1 долоо хоног өмнө
README.rst a6929ba093 Readme: Python 3.9 is tested and required, not 3.6 1 долоо хоног өмнө
SECURITY.md 940ab2ec78 Update security policy now that 0.21.X is out. 1 жил өмнө
TODO 1282de4286 Update TODO. 7 жил өмнө
disperse.toml 17a1f6f399 Migrate to disperse.toml 1 сар өмнө
dulwich.cfg 13fced2e1d Change homepage to www.dulwich.io. 9 жил өмнө
limmat.toml 50a24822a4 Add limmat config 1 долоо хоног өмнө
pyproject.toml ed8a835d6f Bump ruff from 0.8.0 to 0.8.1 2 өдөр өмнө
requirements.txt 5505a96d28 removed urllib3[secure] 2 жил өмнө
setup.py c0a8e05380 Add SPDX license identifier to Python files and shell scripts 1 долоо хоног өмнө
status.yaml 11bddcfc87 Prettify md/yaml files 2 жил өмнө
tox.ini 02705b344d Simplify tox setup (#1086) 2 жил өмнө

README.rst

Dulwich
=======

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

**License**: Apache License, version 2 or GNU General Public License, version 2 or later.

SPDX-License-Identifier: Apache-2.0 OR GPL-2.0-or-later

The project is named after the part of London that Mr. and Mrs. Git live in
the particular Monty Python sketch.

Installation
------------

By default, Dulwich' setup.py will attempt to build and install the optional Rust
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 Rust bindings, specify the --pure argument to setup.py::

$ python setup.py --pure install

or if you are installing from pip::

$ pip install --no-binary dulwich dulwich --config-settings "--build-option=--pure"

Note that you can also specify --build-option in a
`requirements.txt `_
file, e.g. like this::

dulwich --config-settings "--build-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

>>> 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 Vernooij
Date: Sat Apr 29 2017 23:57:34 +0000

Add note about encoding.

Further documentation
---------------------

The dulwich documentation can be found in docs/ and built by running ``make
doc``. It can also be found `on the web `_.

Help
----

There is a *#dulwich* IRC channel on the `OFTC `_, and
a `dulwich-discuss `_
mailing list.

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 3.9 and later and
Pypy.