pbr - Python Build Reasonableness
this page last updated: 2018-09-24 11:58:46
A library for managing setuptools packaging needs in a consistent manner.
pbr reads and then filters the setup.cfg data through a setup hook to fill in default values and provide more sensible behaviors, and then feeds the results in as the arguments to a call to setup.py - so the heavy lifting of handling Python packaging needs is still being done by setuptools .
Note that we don’t support the easy_install aspects of setuptools : while we depend on setup_requires , for any install_requires we recommend that they be installed prior to running setup.py install - either by hand, or by using an install tool such as pip .
pbr can and does do a bunch of things for you:
- Version : Manage version number based on git revisions and tags
- AUTHORS : Generate AUTHORS file from git log
- ChangeLog : Generate ChangeLog from git log
- Manifest : Generate a sensible manifest from git files and some standard files
- Release Notes : Generate a release notes file using reno
- Requirements : Store your dependencies in a pip requirements file
- long_description : Use your README file as a long_description
- Smart find_packages : Smartly find packages under your root package
- Sphinx Autodoc : Generate autodoc stub files for your whole
From < https://docs.openstack.org/pbr/latest/ >