CityApper
/
dulwich
mirror of https://github.com/jelmer/dulwich


			
				
					
						
						
							123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127
							Metadata-Version: 2.1
Name: dulwich
Version: 0.19.11
Summary: Python Git Library
Home-page: https://www.dulwich.io/
Author: Jelmer Vernooij
Author-email: jelmer@jelmer.uk
License: Apachev2 or later or GPLv2
Project-URL: Bug Tracker, https://github.com/dulwich/dulwich/issues
Project-URL: GitHub, https://github.com/dulwich/dulwich
Project-URL: Repository, https://www.dulwich.io/code/
Description: .. image:: https://travis-ci.org/dulwich/dulwich.png?branch=master
          :alt: Build Status
          :target: https://travis-ci.org/dulwich/dulwich
        
        .. image:: https://ci.appveyor.com/api/projects/status/mob7g4vnrfvvoweb?svg=true
          :alt: Windows Build Status
          :target: https://ci.appveyor.com/project/jelmer/dulwich/branch/master
        
        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 C bindings, specify the --pure argument to setup.py::
        
            $ python setup.py --pure install
        
        or if you are installing from pip::
        
            $ pip install dulwich --global-option="--pure"
        
        Note that you can also specify --global-option in a
        `requirements.txt <https://pip.pypa.io/en/stable/reference/pip_install/#requirement-specifiers>`_
        file, e.g. like this::
        
            dulwich --global-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 Vernooĳ <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
        `on the web <https://www.dulwich.io/docs/>`_.
        
        The API reference can be generated using pydoctor, by running "make pydoctor",
        or `on the web <https://www.dulwich.io/apidocs>`_.
        
        Help
        ----
        
        There is a *#dulwich* IRC channel on the `Freenode <https://www.freenode.net/>`_, and
        `dulwich-announce <https://groups.google.com/forum/#!forum/dulwich-announce>`_
        and `dulwich-discuss <https://groups.google.com/forum/#!forum/dulwich-discuss>`_
        mailing lists.
        
        Contributing
        ------------
        
        For a full list of contributors, see the git logs or `AUTHORS <AUTHORS>`_.
        
        If you'd like to contribute to Dulwich, see the `CONTRIBUTING <CONTRIBUTING.rst>`_
        file and `list of open issues <https://github.com/dulwich/dulwich/issues>`_.
        
        Supported versions of Python
        ----------------------------
        
        At the moment, Dulwich supports (and is tested on) CPython 2.7, 3.4, 3.5, 3.6 and Pypy.
        
Keywords: git vcs
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Programming Language :: Python :: Implementation :: PyPy
Classifier: Operating System :: POSIX
Classifier: Operating System :: Microsoft :: Windows
Classifier: Topic :: Software Development :: Version Control
Provides-Extra: fastimport
Provides-Extra: https
Provides-Extra: pgp