setup.py

import os
import re
import subprocess
import sys

from setuptools import setup, find_packages


MAJOR = 1
MINOR = 1
MICRO = 1

IS_RELEASED = False

VERSION = '%d.%d.%d' % (MAJOR, MINOR, MICRO)


# Return the git revision as a string
def git_version():
    def _minimal_ext_cmd(cmd):
        # construct minimal environment
        env = {}
        for k in ['SYSTEMROOT', 'PATH']:
            v = os.environ.get(k)
            if v is not None:
                env[k] = v
        # LANGUAGE is used on win32
        env['LANGUAGE'] = 'C'
        env['LANG'] = 'C'
        env['LC_ALL'] = 'C'
        out = subprocess.Popen(
            cmd, stdout=subprocess.PIPE, env=env,
        ).communicate()[0]
        return out

    try:
        out = _minimal_ext_cmd(['git', 'describe', '--tags'])
    except OSError:
        out = ''

    git_description = out.strip().decode('ascii')
    expr = r'.*?\-(?P<count>\d+)-g(?P<hash>[a-fA-F0-9]+)'
    match = re.match(expr, git_description)
    if match is None:
        git_revision, git_count = 'Unknown', '0'
    else:
        git_revision, git_count = match.group('hash'), match.group('count')

    return git_revision, git_count


def write_version_py(filename='trait_documenter/_version.py'):
    template = """\
# THIS FILE IS GENERATED FROM TRAIT-DOCUMENTER SETUP.PY
version = '{version}'
full_version = '{full_version}'
git_revision = '{git_revision}'
is_released = {is_released}

if not is_released:
    version = full_version
"""
    # Adding the git rev number needs to be done inside
    # write_version_py(), otherwise the import of traits_documenter._version messes
    # up the build under Python 3.
    fullversion = VERSION
    if os.path.exists('.git'):
        git_rev, dev_num = git_version()
    elif os.path.exists('trait_documenter/_version.py'):
        # must be a source distribution, use existing version file
        try:
            from trait_documenter._version import git_revision as git_rev
            from trait_documenter._version import full_version as full_v
        except ImportError:
            raise ImportError(
                "Unable to import git_revision. Try removing "
                "trait-documenter/_version.py and the build directory "
                "before building.")

        match = re.match(r'.*?\.dev(?P<dev_num>\d+)', full_v)
        if match is None:
            dev_num = '0'
        else:
            dev_num = match.group('dev_num')
    else:
        git_rev = 'Unknown'
        dev_num = '0'

    if not IS_RELEASED:
        fullversion += '.dev{0}'.format(dev_num)

    with open(filename, "wt") as fp:
        fp.write(template.format(version=VERSION,
                                 full_version=fullversion,
                                 git_revision=git_rev,
                                 is_released=IS_RELEASED))


if __name__ == "__main__":

    install_requires = ['sphinx', 'traits']
    py35_requires = ['astor>0.5']
    py_requires = ['astor']

    if sys.version_info < (3, 5):
        install_requires += py_requires
    else:
        install_requires = py35_requires

    write_version_py()
    from trait_documenter import __version__

    setup(
        name='trait_documenter',
        version=__version__,
        author='Enthought, Inc',
        author_email='info@enthought.com',
        maintainer='Ioannis Tziakos',
        maintainer_email='info@enthought.com',
        url='https://github.com/enthought/trait-documenter',
        description='Autodoc extention for documenting traits',
        long_description=open('README.rst').read(),
        license="BSD",
        install_requires=install_requires,
        classifiers=[
            "Programming Language :: Python :: 2.6",
            "Programming Language :: Python :: 2.7",
            "Programming Language :: Python :: 3.2",
            "Programming Language :: Python :: 3.3",
            "Programming Language :: Python :: 3.4",
            "Programming Language :: Python :: 3.5",
            "Development Status :: 5 - Production/Stable",
            "Intended Audience :: Developers",
            "License :: OSI Approved :: BSD License",
            "Operating System :: OS Independent",
            "Programming Language :: Python",
            "Framework :: Sphinx :: Extension",
            "Topic :: Documentation :: Sphinx"],
        test_suite='trait_documenter.tests',
        packages=find_packages(),
        use_2to3=True,
        extras_require={
            ':python_version=="3.5"': py35_requires})