PKG-INFO 4.9 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121
  1. Metadata-Version: 2.1
  2. Name: dulwich
  3. Version: 0.19.9
  4. Summary: Python Git Library
  5. Home-page: https://www.dulwich.io/
  6. Author: Jelmer Vernooij
  7. Author-email: jelmer@jelmer.uk
  8. License: Apachev2 or later or GPLv2
  9. Project-URL: Bug Tracker, https://github.com/dulwich/dulwich/issues
  10. Project-URL: GitHub, https://github.com/dulwich/dulwich
  11. Project-URL: Repository, https://www.dulwich.io/code/
  12. Description: [![Build Status](https://travis-ci.org/dulwich/dulwich.png?branch=master)](https://travis-ci.org/dulwich/dulwich)
  13. [![Windows Build status](https://ci.appveyor.com/api/projects/status/mob7g4vnrfvvoweb?svg=true)](https://ci.appveyor.com/project/jelmer/dulwich/branch/master)
  14. This is the Dulwich project.
  15. It aims to provide an interface to git repos (both local and remote) that
  16. doesn't call out to git directly but instead uses pure Python.
  17. **Main website**: [www.dulwich.io](https://www.dulwich.io/)
  18. **License**: Apache License, version 2 or GNU General Public License, version 2 or later.
  19. The project is named after the part of London that Mr. and Mrs. Git live in
  20. in the particular Monty Python sketch.
  21. Installation
  22. ------------
  23. By default, Dulwich' setup.py will attempt to build and install the optional C
  24. extensions. The reason for this is that they significantly improve the performance
  25. since some low-level operations that are executed often are much slower in CPython.
  26. If you don't want to install the C bindings, specify the --pure argument to setup.py::
  27. $ python setup.py --pure install
  28. or if you are installing from pip::
  29. $ pip install dulwich --global-option="--pure"
  30. Note that you can also specify --global-option in a
  31. [requirements.txt](https://pip.pypa.io/en/stable/reference/pip_install/#requirement-specifiers)
  32. file, e.g. like this::
  33. dulwich --global-option=--pure
  34. Getting started
  35. ---------------
  36. Dulwich comes with both a lower-level API and higher-level plumbing ("porcelain").
  37. For example, to use the lower level API to access the commit message of the
  38. last commit:
  39. >>> from dulwich.repo import Repo
  40. >>> r = Repo('.')
  41. >>> r.head()
  42. '57fbe010446356833a6ad1600059d80b1e731e15'
  43. >>> c = r[r.head()]
  44. >>> c
  45. <Commit 015fc1267258458901a94d228e39f0a378370466>
  46. >>> c.message
  47. 'Add note about encoding.\n'
  48. And to print it using porcelain:
  49. >>> from dulwich import porcelain
  50. >>> porcelain.log('.', max_entries=1)
  51. --------------------------------------------------
  52. commit: 57fbe010446356833a6ad1600059d80b1e731e15
  53. Author: Jelmer Vernooij <jelmer@jelmer.uk>
  54. Date: Sat Apr 29 2017 23:57:34 +0000
  55. Add note about encoding.
  56. Further documentation
  57. ---------------------
  58. The dulwich documentation can be found in docs/ and
  59. [on the web](https://www.dulwich.io/docs/).
  60. The API reference can be generated using pydoctor, by running "make pydoctor",
  61. or [on the web](https://www.dulwich.io/apidocs).
  62. Help
  63. ----
  64. There is a *#dulwich* IRC channel on the [Freenode](https://www.freenode.net/), and
  65. [dulwich-announce](https://groups.google.com/forum/#!forum/dulwich-announce)
  66. and [dulwich-discuss](https://groups.google.com/forum/#!forum/dulwich-discuss)
  67. mailing lists.
  68. Contributing
  69. ------------
  70. For a full list of contributors, see the git logs or [AUTHORS](AUTHORS).
  71. If you'd like to contribute to Dulwich, see the [CONTRIBUTING](CONTRIBUTING.md)
  72. file and [list of open issues](https://github.com/dulwich/dulwich/issues).
  73. Supported versions of Python
  74. ----------------------------
  75. At the moment, Dulwich supports (and is tested on) CPython 2.7, 3.4, 3.5, 3.6 and Pypy.
  76. Keywords: git vcs
  77. Platform: UNKNOWN
  78. Classifier: Development Status :: 4 - Beta
  79. Classifier: License :: OSI Approved :: Apache Software License
  80. Classifier: Programming Language :: Python :: 2.7
  81. Classifier: Programming Language :: Python :: 3.4
  82. Classifier: Programming Language :: Python :: 3.5
  83. Classifier: Programming Language :: Python :: 3.6
  84. Classifier: Programming Language :: Python :: Implementation :: CPython
  85. Classifier: Programming Language :: Python :: Implementation :: PyPy
  86. Classifier: Operating System :: POSIX
  87. Classifier: Operating System :: Microsoft :: Windows
  88. Classifier: Topic :: Software Development :: Version Control
  89. Provides-Extra: fastimport
  90. Provides-Extra: https