RETIRED, Utilities for projects using pbr
Go to file
Steve Kowalik 2cd72150d7 Correct small typo
tools/test-siblings.sh was misspelling constraints.

Change-Id: I1b5082cf3b0198b691adbb114ba74505f92da6e1
2018-09-12 16:47:42 -06:00
doc/source Add documentation about build-images 2018-07-20 13:33:25 -05:00
pbrx Revert "Don't store apk indexes in cache" 2018-09-12 15:35:09 -06:00
playbooks/container-images Add image debug print at the end of the job 2018-07-17 00:27:41 +00:00
releasenotes Implement basic image push 2018-08-16 17:19:29 -04:00
tools Correct small typo 2018-09-12 16:47:42 -06:00
.coveragerc Initial Cookiecutter Commit 2018-04-04 16:58:36 -05:00
.gitignore Initial Cookiecutter Commit 2018-04-04 16:58:36 -05:00
.gitreview Initial Cookiecutter Commit 2018-04-04 16:58:36 -05:00
.mailmap Initial Cookiecutter Commit 2018-04-04 16:58:36 -05:00
.stestr.conf Initial Cookiecutter Commit 2018-04-04 16:58:36 -05:00
.zuul.yaml Add readthedocs webhook id 2018-08-03 09:26:33 +10:00
CONTRIBUTING.rst Initial Cookiecutter Commit 2018-04-04 16:58:36 -05:00
HACKING.rst Initial Cookiecutter Commit 2018-04-04 16:58:36 -05:00
LICENSE Initial Cookiecutter Commit 2018-04-04 16:58:36 -05:00
README.rst Add documentation about build-images 2018-07-20 13:33:25 -05:00
babel.cfg Initial Cookiecutter Commit 2018-04-04 16:58:36 -05:00
requirements.txt Add support for building container images from pbr source 2018-04-27 16:17:33 -05:00
setup.cfg Remove python2 2018-07-10 16:27:11 -05:00
setup.py Initial Cookiecutter Commit 2018-04-04 16:58:36 -05:00
test-requirements.txt Initial Cookiecutter Commit 2018-04-04 16:58:36 -05:00
tox.ini Merge "fix tox python3 overrides" 2018-07-15 10:43:03 +00:00

README.rst

pbrx

Utilities for projects using pbr.

pbr is very opinionated about how things should be done. As a result, there are a set of actions that become easy to deal with generically for any pbr based project. pbrx is a collection of utilities that contain support for such actions.

Note

Each of the utilities has a primary focus of working for projects using pbr. However, some of them will also work just fine for non-pbr-based projects. When that is the case, the utility will be marked appropriately.

Features

Each utility is implemented as a subcommand on the pbrx command.

install-siblings

Updates an installation with local from-source versions of dependencies. For any dependency that the normal installation installed from pip/PyPI, install-siblings will look for an adjacent git repository that provides the same package. If one exists, the source version will be installed to replace the released version. This is done in such a way that any given constraints will be honored and not get messed up by transitive depends.

build-images

Builds container images from a project's source tree. The python:alpine base image is used, and dependencies are taken from bindep.txt for distro requirements and requirements.txt for python requirements. A base image is made for the project itself, and then an additional image based on the base image for every entry in entry_points.console_scripts in the setup.cfg file.