Ravenports generated: 07 Apr 2023 22:25
[ravenports.git] / bucket_4D / python-dulwich
1 # Buildsheet autogenerated by ravenadm tool -- Do not edit.
2
3 NAMEBASE=               python-dulwich
4 VERSION=                0.21.3
5 KEYWORDS=               python
6 VARIANTS=               py310 v11
7 SDESC[py310]=           Python Git Library (3.10)
8 SDESC[v11]=             Python Git Library (3.11)
9 HOMEPAGE=               https://www.dulwich.io/
10 CONTACT=                Python_Automaton[python@ironwolf.systems]
11
12 DOWNLOAD_GROUPS=        main
13 SITES[main]=            PYPI/d/dulwich
14 DISTFILE[1]=            dulwich-0.21.3.tar.gz:main
15 DF_INDEX=               1
16 SPKGS[py310]=           single
17 SPKGS[v11]=             single
18
19 OPTIONS_AVAILABLE=      PY310 PY311
20 OPTIONS_STANDARD=       none
21 VOPTS[py310]=           PY310=ON PY311=OFF
22 VOPTS[v11]=             PY310=OFF PY311=ON
23
24 DISTNAME=               dulwich-0.21.3
25
26 GENERATED=              yes
27
28 [PY310].BUILDRUN_DEPENDS_ON=            python-urllib3:single:py310
29 [PY310].USES_ON=                        python:py310,sutools
30
31 [PY311].BUILDRUN_DEPENDS_ON=            python-urllib3:single:v11
32 [PY311].USES_ON=                        python:v11,sutools
33
34 [FILE:2600:descriptions/desc.single]
35 Dulwich
36 =======
37
38 This is the Dulwich project.
39
40 It aims to provide an interface to git repos (both local and remote) that
41 doesn't call out to git directly but instead uses pure Python.
42
43 **Main website**: <https://www.dulwich.io/>
44
45 **License**: Apache License, version 2 or GNU General Public License,
46 version 2 or later.
47
48 The project is named after the part of London that Mr. and Mrs. Git live in
49 in the particular Monty Python sketch.
50
51 Installation
52 ------------
53
54 By default, Dulwich' setup.py will attempt to build and install the
55 optional C
56 extensions. The reason for this is that they significantly improve the
57 performance
58 since some low-level operations that are executed often are much slower in
59 CPython.
60
61 If you don't want to install the C bindings, specify the --pure argument to
62 setup.py::
63
64     $ python setup.py --pure install
65
66 or if you are installing from pip::
67
68     $ pip install dulwich --global-option="--pure"
69
70 Note that you can also specify --global-option in a
71 `requirements.txt
72 <https://pip.pypa.io/en/stable/reference/pip_install/#requirement-specifiers>`_
73 file, e.g. like this::
74
75     dulwich --global-option=--pure
76
77 Getting started
78 ---------------
79
80 Dulwich comes with both a lower-level API and higher-level plumbing
81 ("porcelain").
82
83 For example, to use the lower level API to access the commit message of the
84 last commit::
85
86     >>> from dulwich.repo import Repo
87     >>> r = Repo('.')
88     >>> r.head()
89     '57fbe010446356833a6ad1600059d80b1e731e15'
90     >>> c = r[r.head()]
91     >>> c
92     <Commit 015fc1267258458901a94d228e39f0a378370466>
93     >>> c.message
94     'Add note about encoding.\n'
95
96 And to print it using porcelain::
97
98     >>> from dulwich import porcelain
99     >>> porcelain.log('.', max_entries=1)
100     --------------------------------------------------
101     commit: 57fbe010446356833a6ad1600059d80b1e731e15
102     Author: Jelmer Vernooij <jelmer@jelmer.uk>
103     Date:   Sat Apr 29 2017 23:57:34 +0000
104
105     Add note about encoding.
106
107 Further documentation
108 ---------------------
109
110 The dulwich documentation can be found in docs/ and built by running make
111 doc. It can also be found [on the web].
112
113 Help
114 ----
115
116 There is a *#dulwich* IRC channel on the [OFTC], and
117 a `dulwich-discuss
118 <https://groups.google.com/forum/#!forum/dulwich-discuss>`_
119 mailing list.
120
121 Contributing
122 ------------
123
124 For a full list of contributors, see the git logs or [AUTHORS].
125
126 If you'd like to contribute to Dulwich, see the [CONTRIBUTING]
127 file and [list of open issues].
128
129 Supported versions of Python
130 ----------------------------
131
132 At the moment, Dulwich supports (and is tested on) CPython 3.6 and later
133 and
134 Pypy.
135
136
137 [FILE:100:distinfo]
138 7ca3b453d767eb83b3ec58f0cfcdc934875a341cdfdb0dc55c1431c96608cf83       437815 dulwich-0.21.3.tar.gz
139