Add openstack-common support for setup and version

With help from clarkb in #openstack-infra and openstack-ci/gerritbot,
I've manage to update our versioning to be inline with other openstack
projects. This is another step towards creating our OS packaging.

Change-Id: If3f44b939ee0a3c9c4dfa1d9f83ae14a8285ba5f
Signed-off-by: Paul Belanger <paul.belanger@polybeacon.com>
Reviewed-on: https://review.openstack.org/15335
Reviewed-by: Jeremy Stanley <fungi@yuggoth.org>
Reviewed-by: James E. Blair <corvus@inaugust.com>
Approved: Monty Taylor <mordred@inaugust.com>
Reviewed-by: Monty Taylor <mordred@inaugust.com>
Tested-by: Jenkins

.gitignore

@@ -1,7 +1,11 @@
-*.pyc
 *.egg-info
-config
+*.pyc
-.tox
 .test
-doc/build
+.tox
-doc/source/sourcecode
+AUTHORS
+build/*
+ChangeLog
+config
+doc/build/*
+doc/source/*
+jenkins_jobs/versioninfo

MANIFEST.in

@@ -0,0 +1,10 @@
+include AUTHORS
+include HACKING
+include LICENSE
+include README.rst
+include ChangeLog
+include tox.ini
+include jenkins_jobs/versioninfo
+recursive-include doc *
+recursive-include tests *
+recursive-include tools *

doc/source/conf.py

@@ -49,10 +49,11 @@ copyright = u'2012, Jenkins Job Builder Maintainers'
 # |version| and |release|, also used in various other places throughout the
 # built documents.
 #
+# Version info
+from jenkins_jobs.version import version_info as jenkins_jobs_version
+release = jenkins_jobs_version.version_string_with_vcs()
 # The short X.Y version.
-version = '1.0'
+version = jenkins_jobs_version.canonical_version_string()
-# The full version, including alpha/beta/rc tags.
-release = '1.0'
 
 # The language for content autogenerated by Sphinx. Refer to documentation
 # for a list of supported languages.

jenkins_jobs/openstack/common/setup.py

@@ -0,0 +1,362 @@
+# vim: tabstop=4 shiftwidth=4 softtabstop=4
+
+# Copyright 2011 OpenStack LLC.
+# All Rights Reserved.
+#
+#    Licensed under the Apache License, Version 2.0 (the "License"); you may
+#    not use this file except in compliance with the License. You may obtain
+#    a copy of the License at
+#
+#         http://www.apache.org/licenses/LICENSE-2.0
+#
+#    Unless required by applicable law or agreed to in writing, software
+#    distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+#    WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+#    License for the specific language governing permissions and limitations
+#    under the License.
+
+"""
+Utilities with minimum-depends for use in setup.py
+"""
+
+import datetime
+import os
+import re
+import subprocess
+import sys
+
+from setuptools.command import sdist
+
+
+def parse_mailmap(mailmap='.mailmap'):
+    mapping = {}
+    if os.path.exists(mailmap):
+        with open(mailmap, 'r') as fp:
+            for l in fp:
+                l = l.strip()
+                if not l.startswith('#') and ' ' in l:
+                    canonical_email, alias = [x for x in l.split(' ')
+                                              if x.startswith('<')]
+                    mapping[alias] = canonical_email
+    return mapping
+
+
+def canonicalize_emails(changelog, mapping):
+    """Takes in a string and an email alias mapping and replaces all
+       instances of the aliases in the string with their real email.
+    """
+    for alias, email in mapping.iteritems():
+        changelog = changelog.replace(alias, email)
+    return changelog
+
+
+# Get requirements from the first file that exists
+def get_reqs_from_files(requirements_files):
+    for requirements_file in requirements_files:
+        if os.path.exists(requirements_file):
+            with open(requirements_file, 'r') as fil:
+                return fil.read().split('\n')
+    return []
+
+
+def parse_requirements(requirements_files=['requirements.txt',
+                                           'tools/pip-requires']):
+    requirements = []
+    for line in get_reqs_from_files(requirements_files):
+        # For the requirements list, we need to inject only the portion
+        # after egg= so that distutils knows the package it's looking for
+        # such as:
+        # -e git://github.com/openstack/nova/master#egg=nova
+        if re.match(r'\s*-e\s+', line):
+            requirements.append(re.sub(r'\s*-e\s+.*#egg=(.*)$', r'\1',
+                                line))
+        # such as:
+        # http://github.com/openstack/nova/zipball/master#egg=nova
+        elif re.match(r'\s*https?:', line):
+            requirements.append(re.sub(r'\s*https?:.*#egg=(.*)$', r'\1',
+                                line))
+        # -f lines are for index locations, and don't get used here
+        elif re.match(r'\s*-f\s+', line):
+            pass
+        # argparse is part of the standard library starting with 2.7
+        # adding it to the requirements list screws distro installs
+        elif line == 'argparse' and sys.version_info >= (2, 7):
+            pass
+        else:
+            requirements.append(line)
+
+    return requirements
+
+
+def parse_dependency_links(requirements_files=['requirements.txt',
+                                               'tools/pip-requires']):
+    dependency_links = []
+    # dependency_links inject alternate locations to find packages listed
+    # in requirements
+    for line in get_reqs_from_files(requirements_files):
+        # skip comments and blank lines
+        if re.match(r'(\s*#)|(\s*$)', line):
+            continue
+        # lines with -e or -f need the whole line, minus the flag
+        if re.match(r'\s*-[ef]\s+', line):
+            dependency_links.append(re.sub(r'\s*-[ef]\s+', '', line))
+        # lines that are only urls can go in unmolested
+        elif re.match(r'\s*https?:', line):
+            dependency_links.append(line)
+    return dependency_links
+
+
+def write_requirements():
+    venv = os.environ.get('VIRTUAL_ENV', None)
+    if venv is not None:
+        with open("requirements.txt", "w") as req_file:
+            output = subprocess.Popen(["pip", "-E", venv, "freeze", "-l"],
+                                      stdout=subprocess.PIPE)
+            requirements = output.communicate()[0].strip()
+            req_file.write(requirements)
+
+
+def _run_shell_command(cmd):
+    output = subprocess.Popen(["/bin/sh", "-c", cmd],
+                              stdout=subprocess.PIPE)
+    out = output.communicate()
+    if len(out) == 0:
+        return None
+    if len(out[0].strip()) == 0:
+        return None
+    return out[0].strip()
+
+
+def _get_git_next_version_suffix(branch_name):
+    datestamp = datetime.datetime.now().strftime('%Y%m%d')
+    if branch_name == 'milestone-proposed':
+        revno_prefix = "r"
+    else:
+        revno_prefix = ""
+    _run_shell_command("git fetch origin +refs/meta/*:refs/remotes/meta/*")
+    milestone_cmd = "git show meta/openstack/release:%s" % branch_name
+    milestonever = _run_shell_command(milestone_cmd)
+    if milestonever:
+        first_half = "%s~%s" % (milestonever, datestamp)
+    else:
+        first_half = datestamp
+
+    post_version = _get_git_post_version()
+    # post version should look like:
+    # 0.1.1.4.gcc9e28a
+    # where the bit after the last . is the short sha, and the bit between
+    # the last and second to last is the revno count
+    (revno, sha) = post_version.split(".")[-2:]
+    second_half = "%s%s.%s" % (revno_prefix, revno, sha)
+    return ".".join((first_half, second_half))
+
+
+def _get_git_current_tag():
+    return _run_shell_command("git tag --contains HEAD")
+
+
+def _get_git_tag_info():
+    return _run_shell_command("git describe --tags")
+
+
+def _get_git_post_version():
+    current_tag = _get_git_current_tag()
+    if current_tag is not None:
+        return current_tag
+    else:
+        tag_info = _get_git_tag_info()
+        if tag_info is None:
+            base_version = "0.0"
+            cmd = "git --no-pager log --oneline"
+            out = _run_shell_command(cmd)
+            revno = len(out.split("\n"))
+            sha = _run_shell_command("git describe --always")
+        else:
+            tag_infos = tag_info.split("-")
+            base_version = "-".join(tag_infos[:-2])
+            (revno, sha) = tag_infos[-2:]
+        return "%s.%s.%s" % (base_version, revno, sha)
+
+
+def write_git_changelog():
+    """Write a changelog based on the git changelog."""
+    new_changelog = 'ChangeLog'
+    if not os.getenv('SKIP_WRITE_GIT_CHANGELOG'):
+        if os.path.isdir('.git'):
+            git_log_cmd = 'git log --stat'
+            changelog = _run_shell_command(git_log_cmd)
+            mailmap = parse_mailmap()
+            with open(new_changelog, "w") as changelog_file:
+                changelog_file.write(canonicalize_emails(changelog, mailmap))
+    else:
+        open(new_changelog, 'w').close()
+
+
+def generate_authors():
+    """Create AUTHORS file using git commits."""
+    jenkins_email = 'jenkins@review.(openstack|stackforge).org'
+    old_authors = 'AUTHORS.in'
+    new_authors = 'AUTHORS'
+    if not os.getenv('SKIP_GENERATE_AUTHORS'):
+        if os.path.isdir('.git'):
+            # don't include jenkins email address in AUTHORS file
+            git_log_cmd = ("git log --format='%aN <%aE>' | sort -u | "
+                           "egrep -v '" + jenkins_email + "'")
+            changelog = _run_shell_command(git_log_cmd)
+            mailmap = parse_mailmap()
+            with open(new_authors, 'w') as new_authors_fh:
+                new_authors_fh.write(canonicalize_emails(changelog, mailmap))
+                if os.path.exists(old_authors):
+                    with open(old_authors, "r") as old_authors_fh:
+                        new_authors_fh.write('\n' + old_authors_fh.read())
+    else:
+        open(new_authors, 'w').close()
+
+
+_rst_template = """%(heading)s
+%(underline)s
+
+.. automodule:: %(module)s
+  :members:
+  :undoc-members:
+  :show-inheritance:
+"""
+
+
+def read_versioninfo(project):
+    """Read the versioninfo file. If it doesn't exist, we're in a github
+       zipball, and there's really no way to know what version we really
+       are, but that should be ok, because the utility of that should be
+       just about nil if this code path is in use in the first place."""
+    versioninfo_path = os.path.join(project, 'versioninfo')
+    if os.path.exists(versioninfo_path):
+        with open(versioninfo_path, 'r') as vinfo:
+            version = vinfo.read().strip()
+    else:
+        version = "0.0.0"
+    return version
+
+
+def write_versioninfo(project, version):
+    """Write a simple file containing the version of the package."""
+    with open(os.path.join(project, 'versioninfo'), 'w') as fil:
+        fil.write("%s\n" % version)
+
+
+def get_cmdclass():
+    """Return dict of commands to run from setup.py."""
+
+    cmdclass = dict()
+
+    def _find_modules(arg, dirname, files):
+        for filename in files:
+            if filename.endswith('.py') and filename != '__init__.py':
+                arg["%s.%s" % (dirname.replace('/', '.'),
+                               filename[:-3])] = True
+
+    class LocalSDist(sdist.sdist):
+        """Builds the ChangeLog and Authors files from VC first."""
+
+        def run(self):
+            write_git_changelog()
+            generate_authors()
+            # sdist.sdist is an old style class, can't use super()
+            sdist.sdist.run(self)
+
+    cmdclass['sdist'] = LocalSDist
+
+    # If Sphinx is installed on the box running setup.py,
+    # enable setup.py to build the documentation, otherwise,
+    # just ignore it
+    try:
+        from sphinx.setup_command import BuildDoc
+
+        class LocalBuildDoc(BuildDoc):
+            def generate_autoindex(self):
+                print "**Autodocumenting from %s" % os.path.abspath(os.curdir)
+                modules = {}
+                option_dict = self.distribution.get_option_dict('build_sphinx')
+                source_dir = os.path.join(option_dict['source_dir'][1], 'api')
+                if not os.path.exists(source_dir):
+                    os.makedirs(source_dir)
+                for pkg in self.distribution.packages:
+                    if '.' not in pkg:
+                        os.path.walk(pkg, _find_modules, modules)
+                module_list = modules.keys()
+                module_list.sort()
+                autoindex_filename = os.path.join(source_dir, 'autoindex.rst')
+                with open(autoindex_filename, 'w') as autoindex:
+                    autoindex.write(""".. toctree::
+   :maxdepth: 1
+
+""")
+                    for module in module_list:
+                        output_filename = os.path.join(source_dir,
+                                                       "%s.rst" % module)
+                        heading = "The :mod:`%s` Module" % module
+                        underline = "=" * len(heading)
+                        values = dict(module=module, heading=heading,
+                                      underline=underline)
+
+                        print "Generating %s" % output_filename
+                        with open(output_filename, 'w') as output_file:
+                            output_file.write(_rst_template % values)
+                        autoindex.write("   %s.rst\n" % module)
+
+            def run(self):
+                if not os.getenv('SPHINX_DEBUG'):
+                    self.generate_autoindex()
+
+                for builder in ['html', 'man']:
+                    self.builder = builder
+                    self.finalize_options()
+                    self.project = self.distribution.get_name()
+                    self.version = self.distribution.get_version()
+                    self.release = self.distribution.get_version()
+                    BuildDoc.run(self)
+        cmdclass['build_sphinx'] = LocalBuildDoc
+    except ImportError:
+        pass
+
+    return cmdclass
+
+
+def get_git_branchname():
+    for branch in _run_shell_command("git branch --color=never").split("\n"):
+        if branch.startswith('*'):
+            _branch_name = branch.split()[1].strip()
+    if _branch_name == "(no":
+        _branch_name = "no-branch"
+    return _branch_name
+
+
+def get_pre_version(projectname, base_version):
+    """Return a version which is leading up to a version that will
+       be released in the future."""
+    if os.path.isdir('.git'):
+        current_tag = _get_git_current_tag()
+        if current_tag is not None:
+            version = current_tag
+        else:
+            branch_name = os.getenv('BRANCHNAME',
+                                    os.getenv('GERRIT_REFNAME',
+                                              get_git_branchname()))
+            version_suffix = _get_git_next_version_suffix(branch_name)
+            version = "%s~%s" % (base_version, version_suffix)
+        write_versioninfo(projectname, version)
+        return version
+    else:
+        version = read_versioninfo(projectname)
+    return version
+
+
+def get_post_version(projectname):
+    """Return a version which is equal to the tag that's on the current
+    revision if there is one, or tag plus number of additional revisions
+    if the current revision has no tag."""
+
+    if os.path.isdir('.git'):
+        version = _get_git_post_version()
+        write_versioninfo(projectname, version)
+        return version
+    return read_versioninfo(projectname)

jenkins_jobs/openstack/common/version.py

@@ -0,0 +1,148 @@
+# vim: tabstop=4 shiftwidth=4 softtabstop=4
+
+#    Copyright 2012 OpenStack LLC
+#
+#    Licensed under the Apache License, Version 2.0 (the "License"); you may
+#    not use this file except in compliance with the License. You may obtain
+#    a copy of the License at
+#
+#         http://www.apache.org/licenses/LICENSE-2.0
+#
+#    Unless required by applicable law or agreed to in writing, software
+#    distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+#    WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+#    License for the specific language governing permissions and limitations
+#    under the License.
+
+"""
+Utilities for consuming the auto-generated versioninfo files.
+"""
+
+import datetime
+import pkg_resources
+
+import setup
+
+
+class _deferred_version_string(object):
+    """Internal helper class which provides delayed version calculation."""
+    def __init__(self, version_info, prefix):
+        self.version_info = version_info
+        self.prefix = prefix
+
+    def __str__(self):
+        return "%s%s" % (self.prefix, self.version_info.version_string())
+
+    def __repr__(self):
+        return "%s%s" % (self.prefix, self.version_info.version_string())
+
+
+class VersionInfo(object):
+
+    def __init__(self, package, python_package=None, pre_version=None):
+        """Object that understands versioning for a package
+        :param package: name of the top level python namespace. For glance,
+                        this would be "glance" for python-glanceclient, it
+                        would be "glanceclient"
+        :param python_package: optional name of the project name. For
+                               glance this can be left unset. For
+                               python-glanceclient, this would be
+                               "python-glanceclient"
+        :param pre_version: optional version that the project is working to
+        """
+        self.package = package
+        if python_package is None:
+            self.python_package = package
+        else:
+            self.python_package = python_package
+        self.pre_version = pre_version
+        self.version = None
+
+    def _generate_version(self):
+        """Defer to the openstack.common.setup routines for making a
+        version from git."""
+        if self.pre_version is None:
+            return setup.get_post_version(self.python_package)
+        else:
+            return setup.get_pre_version(self.python_package, self.pre_version)
+
+    def _newer_version(self, pending_version):
+        """Check to see if we're working with a stale version or not.
+        We expect a version string that either looks like:
+          2012.2~f3~20120708.10.4426392
+        which is an unreleased version of a pre-version, or:
+          0.1.1.4.gcc9e28a
+        which is an unreleased version of a post-version, or:
+          0.1.1
+        Which is a release and which should match tag.
+        For now, if we have a date-embedded version, check to see if it's
+        old, and if so re-generate. Otherwise, just deal with it.
+        """
+        try:
+            version_date = int(self.version.split("~")[-1].split('.')[0])
+            if version_date < int(datetime.date.today().strftime('%Y%m%d')):
+                return self._generate_version()
+            else:
+                return pending_version
+        except Exception:
+            return pending_version
+
+    def version_string_with_vcs(self, always=False):
+        """Return the full version of the package including suffixes indicating
+        VCS status.
+
+        For instance, if we are working towards the 2012.2 release,
+        canonical_version_string should return 2012.2 if this is a final
+        release, or else something like 2012.2~f1~20120705.20 if it's not.
+
+        :param always: if true, skip all version caching
+        """
+        if always:
+            self.version = self._generate_version()
+
+        if self.version is None:
+
+            requirement = pkg_resources.Requirement.parse(self.python_package)
+            versioninfo = "%s/versioninfo" % self.package
+            try:
+                raw_version = pkg_resources.resource_string(requirement,
+                                                            versioninfo)
+                self.version = self._newer_version(raw_version.strip())
+            except (IOError, pkg_resources.DistributionNotFound):
+                self.version = self._generate_version()
+
+        return self.version
+
+    def canonical_version_string(self, always=False):
+        """Return the simple version of the package excluding any suffixes.
+
+        For instance, if we are working towards the 2012.2 release,
+        canonical_version_string should return 2012.2 in all cases.
+
+        :param always: if true, skip all version caching
+        """
+        return self.version_string_with_vcs(always).split('~')[0]
+
+    def version_string(self, always=False):
+        """Return the base version of the package.
+
+        For instance, if we are working towards the 2012.2 release,
+        version_string should return 2012.2 if this is a final release, or
+        2012.2-dev if it is not.
+
+        :param always: if true, skip all version caching
+        """
+        version_parts = self.version_string_with_vcs(always).split('~')
+        if len(version_parts) == 1:
+            return version_parts[0]
+        else:
+            return '%s-dev' % (version_parts[0],)
+
+    def deferred_version_string(self, prefix=""):
+        """Generate an object which will expand in a string context to
+        the results of version_string(). We do this so that don't
+        call into pkg_resources every time we start up a program when
+        passing version information into the CONF constructor, but
+        rather only do the calculation when and if a version is requested
+        """
+        return _deferred_version_string(self, prefix)

jenkins_jobs/sphinx/yaml.py

@@ -95,7 +95,7 @@ class YAMLFunctionDocumenter(FunctionDocumenter):
         if not FunctionDocumenter.can_document_member(member, membername,
                                                       isattr, parent):
             return False
-        if yaml_sig_re.match(member.__doc__):
+        if member.__doc__ is not None and yaml_sig_re.match(member.__doc__):
             return True
         return False
 

jenkins_jobs/version.py

@@ -0,0 +1,20 @@
+# vim: tabstop=4 shiftwidth=4 softtabstop=4
+
+#    Copyright 2011 OpenStack LLC
+#    Copyright 2012 Hewlett-Packard Development Company, L.P.
+#
+#    Licensed under the Apache License, Version 2.0 (the "License"); you may
+#    not use this file except in compliance with the License. You may obtain
+#    a copy of the License at
+#
+#         http://www.apache.org/licenses/LICENSE-2.0
+#
+#    Unless required by applicable law or agreed to in writing, software
+#    distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+#    WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+#    License for the specific language governing permissions and limitations
+#    under the License.
+
+from jenkins_jobs.openstack.common import version as common_version
+
+version_info = common_version.VersionInfo('jenkins_jobs')

openstack-common.conf

@@ -0,0 +1,7 @@
+[DEFAULT]
+
+# The list of modules to copy from openstack-common
+modules=setup,version
+
+# The base module to hold the copy of openstack.common
+base=jenkins_jobs

setup.cfg

@@ -2,4 +2,3 @@
 all_files = 1
 build-dir = doc/build
 source-dir = doc/source
-

setup.py

@@ -12,109 +12,127 @@
 # License for the specific language governing permissions and limitations
 # under the License.
 
-from setuptools import find_packages
+import setuptools
-from setuptools import setup
 
-setup(name='jenkins_job_builder',
+from jenkins_jobs.openstack.common import setup
-      version='0.1',
+from jenkins_jobs.version import version_info as version
-      description="Manage Jenkins jobs with YAML",
-      license='Apache License (2.0)',
-      author='Hewlett-Packard Development Company, L.P.',
-      author_email='openstack@lists.launchpad.net',
-      scripts=['jenkins-jobs'],
-      include_package_data=True,
-      zip_safe=False,
-      packages=find_packages(),
 
-      entry_points={
+requires = setup.parse_requirements()
-        'jenkins_jobs.projects': [
+test_requires = setup.parse_requirements(['tools/test-requires'])
-            'freestyle=jenkins_jobs.modules.project_freestyle:Freestyle',
+depend_links = setup.parse_dependency_links()
-            'maven=jenkins_jobs.modules.project_maven:Maven',
-            ],
-        'jenkins_jobs.builders': [
-            'shell=jenkins_jobs.modules.builders:shell',
-            'ant=jenkins_jobs.modules.builders:ant',
-            'trigger-builds=jenkins_jobs.modules.builders:trigger_builds',
-            'builders-from=jenkins_jobs.modules.builders:builders_from',
-            'inject=jenkins_jobs.modules.builders:inject',
-            ],
-        'jenkins_jobs.reporters': [
-            'email=jenkins_jobs.modules.reporters:email',
-            ],
-        'jenkins_jobs.properties': [
-            'github=jenkins_jobs.modules.properties:github',
-            'throttle=jenkins_jobs.modules.properties:throttle',
-            'inject=jenkins_jobs.modules.properties:inject',
-            'authenticated-build=jenkins_jobs.modules.properties:'
-              'authenticated_build',
-            'authorization=jenkins_jobs.modules.properties:authorization',
-            ],
-        'jenkins_jobs.parameters': [
-            'string=jenkins_jobs.modules.parameters:string_param',
-            'bool=jenkins_jobs.modules.parameters:bool_param',
-            'file=jenkins_jobs.modules.parameters:file_param',
-            'text=jenkins_jobs.modules.parameters:text_param',
-            'label=jenkins_jobs.modules.parameters:label_param',
-            'choice=jenkins_jobs.modules.parameters:choice_param',
-            'validating-string=jenkins_jobs.modules.parameters:'
-              'validating_string_param',
-            'svn-tags=jenkins_jobs.modules.parameters:svn_tags_param',
-            ],
-        'jenkins_jobs.notifications': [
-            'http=jenkins_jobs.modules.notifications:http_endpoint',
-            ],
-        'jenkins_jobs.publishers': [
-            'archive=jenkins_jobs.modules.publishers:archive',
-            'trigger-parameterized-builds='
-                'jenkins_jobs.modules.publishers:trigger_parameterized_builds',
-            'trigger=jenkins_jobs.modules.publishers:trigger',
-            'coverage=jenkins_jobs.modules.publishers:coverage',
-            'ftp=jenkins_jobs.modules.publishers:ftp',
-            'junit=jenkins_jobs.modules.publishers:junit',
-            'xunit=jenkins_jobs.modules.publishers:xunit',
-            'violations=jenkins_jobs.modules.publishers:violations',
-            'scp=jenkins_jobs.modules.publishers:scp',
-            'pipeline=jenkins_jobs.modules.publishers:pipeline',
-            'email=jenkins_jobs.modules.publishers:email',
-            'claim-build=jenkins_jobs.modules.publishers:claimbuild',
-            'email-ext=jenkins_jobs.modules.publishers:email_ext',
-            'fingerprint=jenkins_jobs.modules.publishers:fingerprint',
-            'aggregate-tests=jenkins_jobs.modules.publishers:aggregate_tests',
-            ],
-        'jenkins_jobs.scm': [
-            'git=jenkins_jobs.modules.scm:git',
-            'svn=jenkins_jobs.modules.scm:svn',
-            ],
-        'jenkins_jobs.triggers': [
-            'gerrit=jenkins_jobs.modules.triggers:gerrit',
-            'pollscm=jenkins_jobs.modules.triggers:pollscm',
-            'timed=jenkins_jobs.modules.triggers:timed',
-            ],
-        'jenkins_jobs.wrappers': [
-            'timeout=jenkins_jobs.modules.wrappers:timeout',
-            'timestamps=jenkins_jobs.modules.wrappers:timestamps',
-            'ansicolor=jenkins_jobs.modules.wrappers:ansicolor',
-            'mask-passwords=jenkins_jobs.modules.wrappers:mask_passwords',
-            'build-name=jenkins_jobs.modules.wrappers:build_name',
-            'workspace-cleanup=jenkins_jobs.modules.wrappers:'
-              'workspace_cleanup',
-            'port-allocator=jenkins_jobs.modules.wrappers:port_allocator',
-            ],
-        'jenkins_jobs.modules': [
-            'assignednode=jenkins_jobs.modules.assignednode:AssignedNode',
-            'builders=jenkins_jobs.modules.builders:Builders',
-            'logrotate=jenkins_jobs.modules.logrotate:LogRotate',
-            'properties=jenkins_jobs.modules.properties:Properties',
-            'parameters=jenkins_jobs.modules.parameters:Parameters',
-            'notifications=jenkins_jobs.modules.notifications:Notifications',
-            'publishers=jenkins_jobs.modules.publishers:Publishers',
-            'reporters=jenkins_jobs.modules.reporters:Reporters',
-            'scm=jenkins_jobs.modules.scm:SCM',
-            'triggers=jenkins_jobs.modules.triggers:Triggers',
-            'wrappers=jenkins_jobs.modules.wrappers:Wrappers',
-            'zuul=jenkins_jobs.modules.zuul:Zuul',
-            'hipchat=jenkins_jobs.modules.hipchat_notif:HipChat',
-            ]
-        }
 
-      )
+
+setuptools.setup(
+    name='jenkins-job-builder',
+    version=version.canonical_version_string(always=True),
+    author='Hewlett-Packard Development Company, L.P.',
+    author_email='openstack@lists.launchpad.net',
+    description='Manage Jenkins jobs with YAML',
+    license='Apache License, Version 2.0',
+    url='https://github.com/openstack-ci/jenkins-job-builder',
+    packages=setuptools.find_packages(exclude=['tests', 'tests.*']),
+    include_package_data=True,
+    cmdclass=setup.get_cmdclass(),
+    install_requires=requires,
+    dependency_links=depend_links,
+    scripts=['jenkins-jobs'],
+    zip_safe=False,
+    classifiers=[
+        'Environment :: Console',
+        'Intended Audience :: Developers',
+        'Intended Audience :: Information Technology',
+        'License :: OSI Approved :: Apache Software License',
+        'Operating System :: OS Independent',
+        'Programming Language :: Python'
+    ],
+    entry_points={
+      'jenkins_jobs.projects': [
+          'freestyle=jenkins_jobs.modules.project_freestyle:Freestyle',
+          'maven=jenkins_jobs.modules.project_maven:Maven',
+          ],
+      'jenkins_jobs.builders': [
+          'shell=jenkins_jobs.modules.builders:shell',
+          'ant=jenkins_jobs.modules.builders:ant',
+          'trigger-builds=jenkins_jobs.modules.builders:trigger_builds',
+          'builders-from=jenkins_jobs.modules.builders:builders_from',
+          'inject=jenkins_jobs.modules.builders:inject',
+          ],
+      'jenkins_jobs.reporters': [
+          'email=jenkins_jobs.modules.reporters:email',
+          ],
+      'jenkins_jobs.properties': [
+          'github=jenkins_jobs.modules.properties:github',
+          'throttle=jenkins_jobs.modules.properties:throttle',
+          'inject=jenkins_jobs.modules.properties:inject',
+          'authenticated-build=jenkins_jobs.modules.properties:'
+            'authenticated_build',
+          'authorization=jenkins_jobs.modules.properties:authorization',
+          ],
+      'jenkins_jobs.parameters': [
+          'string=jenkins_jobs.modules.parameters:string_param',
+          'bool=jenkins_jobs.modules.parameters:bool_param',
+          'file=jenkins_jobs.modules.parameters:file_param',
+          'text=jenkins_jobs.modules.parameters:text_param',
+          'label=jenkins_jobs.modules.parameters:label_param',
+          'choice=jenkins_jobs.modules.parameters:choice_param',
+          'validating-string=jenkins_jobs.modules.parameters:'
+            'validating_string_param',
+          'svn-tags=jenkins_jobs.modules.parameters:svn_tags_param',
+          ],
+      'jenkins_jobs.notifications': [
+          'http=jenkins_jobs.modules.notifications:http_endpoint',
+          ],
+      'jenkins_jobs.publishers': [
+          'archive=jenkins_jobs.modules.publishers:archive',
+          'trigger-parameterized-builds='
+              'jenkins_jobs.modules.publishers:trigger_parameterized_builds',
+          'trigger=jenkins_jobs.modules.publishers:trigger',
+          'coverage=jenkins_jobs.modules.publishers:coverage',
+          'ftp=jenkins_jobs.modules.publishers:ftp',
+          'junit=jenkins_jobs.modules.publishers:junit',
+          'xunit=jenkins_jobs.modules.publishers:xunit',
+          'violations=jenkins_jobs.modules.publishers:violations',
+          'scp=jenkins_jobs.modules.publishers:scp',
+          'pipeline=jenkins_jobs.modules.publishers:pipeline',
+          'email=jenkins_jobs.modules.publishers:email',
+          'claim-build=jenkins_jobs.modules.publishers:claimbuild',
+          'email-ext=jenkins_jobs.modules.publishers:email_ext',
+          'fingerprint=jenkins_jobs.modules.publishers:fingerprint',
+          'aggregate-tests=jenkins_jobs.modules.publishers:aggregate_tests',
+          ],
+      'jenkins_jobs.scm': [
+          'git=jenkins_jobs.modules.scm:git',
+          'svn=jenkins_jobs.modules.scm:svn',
+          ],
+      'jenkins_jobs.triggers': [
+          'gerrit=jenkins_jobs.modules.triggers:gerrit',
+          'pollscm=jenkins_jobs.modules.triggers:pollscm',
+          'timed=jenkins_jobs.modules.triggers:timed',
+          ],
+      'jenkins_jobs.wrappers': [
+          'timeout=jenkins_jobs.modules.wrappers:timeout',
+          'timestamps=jenkins_jobs.modules.wrappers:timestamps',
+          'ansicolor=jenkins_jobs.modules.wrappers:ansicolor',
+          'mask-passwords=jenkins_jobs.modules.wrappers:mask_passwords',
+          'build-name=jenkins_jobs.modules.wrappers:build_name',
+          'workspace-cleanup=jenkins_jobs.modules.wrappers:'
+            'workspace_cleanup',
+          'port-allocator=jenkins_jobs.modules.wrappers:port_allocator',
+          ],
+      'jenkins_jobs.modules': [
+          'assignednode=jenkins_jobs.modules.assignednode:AssignedNode',
+          'builders=jenkins_jobs.modules.builders:Builders',
+          'logrotate=jenkins_jobs.modules.logrotate:LogRotate',
+          'properties=jenkins_jobs.modules.properties:Properties',
+          'parameters=jenkins_jobs.modules.parameters:Parameters',
+          'notifications=jenkins_jobs.modules.notifications:Notifications',
+          'publishers=jenkins_jobs.modules.publishers:Publishers',
+          'reporters=jenkins_jobs.modules.reporters:Reporters',
+          'scm=jenkins_jobs.modules.scm:SCM',
+          'triggers=jenkins_jobs.modules.triggers:Triggers',
+          'wrappers=jenkins_jobs.modules.wrappers:Wrappers',
+          'zuul=jenkins_jobs.modules.zuul:Zuul',
+          'hipchat=jenkins_jobs.modules.hipchat_notif:HipChat',
+          ]
+      }
+    )