1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
|
=================================
pbr - Python Build Reasonableness
=================================
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 module
Contents
--------
.. toctree::
:maxdepth: 2
user/index
reference/index
contributor/index
|
