|author||B. Watson <email@example.com>||2016-11-06 17:12:43 -0500|
|committer||Willy Sudiarto Raharjo <firstname.lastname@example.org>||2016-11-12 06:58:01 +0700|
python/pbr: Update README, slack-desc.
Diffstat (limited to 'python/pbr/README')
1 files changed, 15 insertions, 5 deletions
diff --git a/python/pbr/README b/python/pbr/README
index 45ef2f90b8..0b25866fe4 100644
@@ -1,6 +1,16 @@
-PBR is a library that injects some useful and sensible default behaviors into your setuptools run.
+pbr (manage setuptools packaging)
-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.
+A library for managing setuptools packaging in a consistent manner.
+PBR is a library that injects some useful and sensible default behaviors
+into your setuptools run.
+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
+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.