The nova.openstack.common.setup Module

Utilities with minimum-depends for use in setup.py

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.

generate_authors()

Create AUTHORS file using git commits.

get_cmdclass()

Return dict of commands to run from setup.py.

get_reqs_from_files(requirements_files)

get_version(package_name, pre_version=None)

Get the version of the project. First, try getting it from PKG-INFO, if it exists. If it does, that means we’re in a distribution tarball or that install has happened. Otherwise, if there is no PKG-INFO file, pull the version from git.

We do not support setup.py version sanity in git archive tarballs, nor do we support packagers directly sucking our git repo into theirs. We expect that a source tarball be made from our git repo - or that if someone wants to make a source tarball from a fork of our repo with additional tags in it that they understand and desire the results of doing that.

parse_dependency_links(requirements_files=['requirements.txt', 'tools/pip-requires'])

parse_mailmap(mailmap='.mailmap')

parse_requirements(requirements_files=['requirements.txt', 'tools/pip-requires'])

write_git_changelog()

Write a changelog based on the git changelog.