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

NAMEBASE=		python-dulwich
VERSION=		0.22.1
KEYWORDS=		python
VARIANTS=		v11 v12
SDESC[v11]=		Python Git Library (3.11)
SDESC[v12]=		Python Git Library (3.12)
HOMEPAGE=		https://www.dulwich.io/
CONTACT=		Python_Automaton[python@ironwolf.systems]

DOWNLOAD_GROUPS=	main
SITES[main]=		PYPI/d/dulwich
DISTFILE[1]=		dulwich-0.22.1.tar.gz:main
DF_INDEX=		1
SPKGS[v11]=		single
SPKGS[v12]=		single

OPTIONS_AVAILABLE=	PY311 PY312
OPTIONS_STANDARD=	none
VOPTS[v11]=		PY311=ON PY312=OFF
VOPTS[v12]=		PY311=OFF PY312=ON

BUILD_DEPENDS=		python-setuptools-rust:single:python_used

DISTNAME=		dulwich-0.22.1

GENERATED=		yes

[PY311].BUILDRUN_DEPENDS_ON=		python-urllib3:single:v11
[PY311].USES_ON=			python:v11,sutools

[PY312].BUILDRUN_DEPENDS_ON=		python-urllib3:single:v12
[PY312].USES_ON=			python:v12,sutools

[FILE:2640: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.

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 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
a `dulwich-discuss
<https://groups.google.com/forum/#!forum/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.6 and later
and


[FILE:100:distinfo]
e36d85967cfbf25da1c7bc3d6921adc5baa976969d926aaf1582bd5fd7e94758       395260 dulwich-0.22.1.tar.gz