bucket_4D/python-dulwich

   1 # Buildsheet autogenerated by ravenadm tool -- Do not edit.
   2
   3 NAMEBASE=               python-dulwich
   4 VERSION=                0.21.7
   5 KEYWORDS=               python
   6 VARIANTS=               v11 v12
   7 SDESC[v11]=             Python Git Library (3.11)
   8 SDESC[v12]=             Python Git Library (3.12)
   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.7.tar.gz:main
  15 DF_INDEX=               1
  16 SPKGS[v11]=             single
  17 SPKGS[v12]=             single
  18
  19 OPTIONS_AVAILABLE=      PY311 PY312
  20 OPTIONS_STANDARD=       none
  21 VOPTS[v11]=             PY311=ON PY312=OFF
  22 VOPTS[v12]=             PY311=OFF PY312=ON
  23
  24 DISTNAME=               dulwich-0.21.7
  25
  26 GENERATED=              yes
  27
  28 [PY311].BUILDRUN_DEPENDS_ON=            python-urllib3:single:v11
  29 [PY311].USES_ON=                        python:v11,sutools
  30
  31 [PY312].BUILDRUN_DEPENDS_ON=            python-urllib3:single:v12
  32 [PY312].USES_ON=                        python:v12,sutools
  33
  34 [FILE:2637: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 --no-binary dulwich dulwich --config-settings
  69 "--build-option=--pure"
  70
  71 Note that you can also specify --build-option in a
  72 `requirements.txt
  73 <https://pip.pypa.io/en/stable/reference/requirement-specifiers/>`_
  74 file, e.g. like this::
  75
  76     dulwich --config-settings "--build-option=--pure"
  77
  78 Getting started
  79 ---------------
  80
  81 Dulwich comes with both a lower-level API and higher-level plumbing
  82 ("porcelain").
  83
  84 For example, to use the lower level API to access the commit message of the
  85 last commit::
  86
  87     >>> from dulwich.repo import Repo
  88     >>> r = Repo('.')
  89     >>> r.head()
  90     '57fbe010446356833a6ad1600059d80b1e731e15'
  91     >>> c = r[r.head()]
  92     >>> c
  93     <Commit 015fc1267258458901a94d228e39f0a378370466>
  94     >>> c.message
  95     'Add note about encoding.\n'
  96
  97 And to print it using porcelain::
  98
  99     >>> from dulwich import porcelain
 100     >>> porcelain.log('.', max_entries=1)
 101     --------------------------------------------------
 102     commit: 57fbe010446356833a6ad1600059d80b1e731e15
 103     Author: Jelmer Vernooĳ <jelmer@jelmer.uk>
 104     Date:   Sat Apr 29 2017 23:57:34 +0000
 105
 106     Add note about encoding.
 107
 108 Further documentation
 109 ---------------------
 110
 111 The dulwich documentation can be found in docs/ and built by running make
 112 doc. It can also be found [on the web].
 113
 114 Help
 115 ----
 116
 117 There is a *#dulwich* IRC channel on the [OFTC], and
 118 a `dulwich-discuss
 119 <https://groups.google.com/forum/#!forum/dulwich-discuss>`_
 120 mailing list.
 121
 122 Contributing
 123 ------------
 124
 125 For a full list of contributors, see the git logs or [AUTHORS].
 126
 127 If you'd like to contribute to Dulwich, see the [CONTRIBUTING]
 128 file and [list of open issues].
 129
 130 Supported versions of Python
 131 ----------------------------
 132
 133 At the moment, Dulwich supports (and is tested on) CPython 3.6 and later
 134 and
 135
 136
 137 [FILE:100:distinfo]
 138 a9e9c66833cea580c3ac12927e4b9711985d76afca98da971405d414de60e968       448028 dulwich-0.21.7.tar.gz
 139