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.