# Buildsheet autogenerated by ravenadm tool -- Do not edit.

NAMEBASE=		python-dulwich
VERSION=		0.24.10
KEYWORDS=		python
VARIANTS=		v13 v14
SDESC[v13]=		Python Git Library (3.13)
SDESC[v14]=		Python Git Library (3.14)
HOMEPAGE=		https://www.dulwich.io/
CONTACT=		Python_Automaton[python@ironwolf.systems]

DOWNLOAD_GROUPS=	main
SITES[main]=		PYPIWHL/74/4d/ca83b98ae966b156fd589a502f757789657a6f6f23926587abd3a3e3dc6f
DISTFILE[1]=		dulwich-0.24.10-py3-none-any.whl:main
DIST_SUBDIR=		python-src
DF_INDEX=		1
SPKGS[v13]=		single
SPKGS[v14]=		single

OPTIONS_AVAILABLE=	PY313 PY314
OPTIONS_STANDARD=	none
VOPTS[v13]=		PY313=ON PY314=OFF
VOPTS[v14]=		PY313=OFF PY314=ON

BUILD_DEPENDS=		python-setuptools-rust:single:python_used

DISTNAME=		dulwich-0.24.10.dist-info

GENERATED=		yes

[PY313].RUN_DEPENDS_ON=			python-urllib3:single:v13
[PY313].USES_ON=			python:v13,wheel

[PY314].RUN_DEPENDS_ON=			python-urllib3:single:v14
[PY314].USES_ON=			python:v14,wheel

[FILE:2827:descriptions/desc.single]
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**: <https://www.dulwich.io/>

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

Differences with other Python Git libraries
-------------------------------------------

Unlike other Python Git libraries, Dulwich is available as a standalone
package that doesn't depend on git (like GitPython) being installed or any
native code (like pygit2).

This comes at the cost of speed, but makes it easier to deploy in
environments
where git isn't available or where it's important to have a pure Python
implementation.

To improve performance, Dulwich includes optional Rust bindings that can be
used to speed up low-level operations.

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
<https://pip.pypa.io/en/stable/reference/requirement-specifiers/>`_
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
    <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 Vernooij <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 built by running make
doc. It can also be found [on the web].

Help
----

There is a *#dulwich* IRC channel on the [OFTC], and


[FILE:122:distinfo]
15b32f8c3116a1c0a042dde8da96f65a607e263e860ee42b3d4a98ce2c2f4a06       566684 python-src/dulwich-0.24.10-py3-none-any.whl