wok diff python-pbr/description.txt @ rev 25507
plop: cleanup
author | Pascal Bellard <pascal.bellard@slitaz.org> |
---|---|
date | Sat Feb 11 10:36:59 2023 +0000 (21 months ago) |
parents | |
children |
line diff
1.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000 1.2 +++ b/python-pbr/description.txt Sat Feb 11 10:36:59 2023 +0000 1.3 @@ -0,0 +1,22 @@ 1.4 +PBR is a library that injects some useful and sensible default behaviors 1.5 +into your setuptools run. 1.6 +It started off life as the chunks of code that were copied between all 1.7 +of the OpenStack projects. Around the time that OpenStack hit 18 different 1.8 +projects each with at least 3 active branches, it seemed like a good time 1.9 +to make that code into a proper reusable library. 1.10 + 1.11 +PBR is only mildly configurable. 1.12 +The basic idea is that there's a decent way to run things and if you do, 1.13 +you should reap the rewards, because then it's simple and repeatable. 1.14 +If you want to do things differently, cool! But you've already got the 1.15 +power of Python at your fingertips, so you don't really need PBR. 1.16 + 1.17 +PBR builds on top of the work that d2to1 started to provide for 1.18 +declarative configuration. 1.19 +d2to1 is itself an implementation of the ideas behind distutils2. 1.20 +Although distutils2 is now abandoned in favor of work towards PEP 426 1.21 +and Metadata 2.0, declarative config is still a great idea and 1.22 +specifically important in trying to distribute setup code as a library 1.23 +when that library itself will alter how the setup is processed. 1.24 +As Metadata 2.0 and other modern Python packaging PEPs come out, PBR aims 1.25 +to support them as quickly as possible.