Metadata-Version: 2.1
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
Platform: UNKNOWN
License-File: LICENSE

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.


