Metadata-Version: 2.4
Name: setuptools_scm_git_archive
Version: 1.1
Summary: setuptools_scm plugin for git archives
Home-page: https://github.com/Changaco/setuptools_scm_git_archive/
Author: Changaco
Author-email: changaco@changaco.oy.lc
License: MIT
Keywords: scm vcs version tags git archive
License-File: LICENSE
Dynamic: author
Dynamic: author-email
Dynamic: description
Dynamic: home-page
Dynamic: keywords
Dynamic: license
Dynamic: license-file
Dynamic: summary

This is a `setuptools_scm <https://pypi.python.org/pypi/setuptools_scm>`_ plugin
that adds support for git archives (for example the ones GitHub automatically
generates).

Note that it only works for archives of tagged commits (because git currently
lacks a format option equivalent to ``git describe --tags``).

Usage
-----

Add ``'setuptools_scm_git_archive'`` to the ``setup_requires`` parameter in your
project's ``setup.py`` file:

.. code:: python

    setup(
        ...,
        use_scm_version=True,
        setup_requires=['setuptools_scm', 'setuptools_scm_git_archive'],
        ...,
    )

Create a ``.git_archival.txt`` file with the following content::

    ref-names: $Format:%D$

Then add this line to the ``.gitattributes`` file::

    .git_archival.txt  export-subst

Finally, don't forget to commit these two files.
