07b6ac85e6
The git web URL is now: https://opendev.org/openstack/pbr
Also stop linking README.rst to no more existing history/changelog
documentation page (removed by 96b84a9014).
Change-Id: I56b0e2b86a7fc66c5ae25e06175033a885f500f6
42 lines
1.8 KiB
ReStructuredText
42 lines
1.8 KiB
ReStructuredText
Introduction
|
|
============
|
|
|
|
.. image:: https://img.shields.io/pypi/v/pbr.svg
|
|
:target: https://pypi.python.org/pypi/pbr/
|
|
:alt: Latest Version
|
|
|
|
.. image:: https://img.shields.io/pypi/dm/pbr.svg
|
|
:target: https://pypi.python.org/pypi/pbr/
|
|
:alt: Downloads
|
|
|
|
PBR is a library that injects some useful and sensible default behaviors
|
|
into your setuptools run. It started off life as the chunks of code that
|
|
were copied between all of the `OpenStack`_ projects. Around the time that
|
|
OpenStack hit 18 different projects each with at least 3 active branches,
|
|
it seemed like a good time to make that code into a proper reusable library.
|
|
|
|
PBR is only mildly configurable. The basic idea is that there's a decent
|
|
way to run things and if you do, you should reap the rewards, because then
|
|
it's simple and repeatable. If you want to do things differently, cool! But
|
|
you've already got the power of Python at your fingertips, so you don't
|
|
really need PBR.
|
|
|
|
PBR builds on top of the work that `d2to1`_ started to provide for declarative
|
|
configuration. `d2to1`_ is itself an implementation of the ideas behind
|
|
`distutils2`_. Although `distutils2`_ is now abandoned in favor of work towards
|
|
`PEP 426`_ and Metadata 2.0, declarative config is still a great idea and
|
|
specifically important in trying to distribute setup code as a library
|
|
when that library itself will alter how the setup is processed. As Metadata
|
|
2.0 and other modern Python packaging PEPs come out, PBR aims to support
|
|
them as quickly as possible.
|
|
|
|
* License: Apache License, Version 2.0
|
|
* Documentation: https://docs.openstack.org/pbr/latest/
|
|
* Source: https://opendev.org/openstack/pbr
|
|
* Bugs: https://bugs.launchpad.net/pbr
|
|
|
|
.. _d2to1: https://pypi.python.org/pypi/d2to1
|
|
.. _distutils2: https://pypi.python.org/pypi/Distutils2
|
|
.. _PEP 426: http://legacy.python.org/dev/peps/pep-0426/
|
|
.. _OpenStack: https://www.openstack.org/
|