Package: devpi-builder
Brandon the Devpi BuilderBrandon, the devpi builder, takes arequirements.txtand incrementally fills adevpiindex with wheels of the listed python packages.Brandon by ExampleGiven arequirements.txt, we can upload all listed packages to the indexopensource/Debian_7on a local devpi using the following command:$ devpi-builder requirements.txt http://localhost:3141/opensource/Debian_7Example of such arequirements.txt:progressbar==0.2.2
progressbar==0.2.1
PyYAML==3.11Commandline Usageusage: devpi-builder [-h] [--batch] [--user USER] [--password PASSWORD]
                    [--blacklist BLACKLIST] [--pure-index PURE_INDEX]
                    [--junit-xml JUNIT_XML] [--run-id RUN_ID] [--dry-run]
                    [--client-cert CLIENT_CERT]
                    requirements index

Create wheels for all given project versions and upload them to the given
index.

positional arguments:
requirements          requirements.txt style file specifying which project
                        versions to package.
index                 The index to upload the packaged software to.

optional arguments:
-h, --help            show this help message and exit
--batch               Batch mode. Do not prompt for credentials
--user USER           The user to log in as.
--password PASSWORD   Password of the user.
--blacklist BLACKLIST
                        Packages matched by this requirements.txt style file
                        will never be build.
--pure-index PURE_INDEX
                        The index to use for pure packages. Any non-pure
                        package will be uploaded to the index given as
                        positional argument. Packages already found in the
                        pure index will not be built, either.
--junit-xml JUNIT_XML
                        Write information about the build success / failure to
                        a JUnit-compatible XML file.
--run-id RUN_ID       Add the given string to all entries in the XML output,
                        allowing to distinguish output from multiple runs in a
                        merged XML.
--dry-run             Build missing wheels, but do not modify the state of
                        the devpi server.
--client-cert CLIENT_CERT
                        Client key to use to authenticate with the devpi
                        server.The following environment variables can be used instead of command line arguments:DEVPI_USERThe value of this environment variable will be used if--useris not given.DEVPI_PASSWORDThe value of this environment variable will be used if--passwordis not given.FeaturesRead arequirements.txtstyle input file.Read user/pass from the environment (usingDEVPI_USERandDEVPI_PASSWORD).Support multiple versions of a package in the same file.Only build packages not yet in the target index.Support a black-list for packages to never be built and uploaded (certain packages like numpy are fragile regarding their interdependency with other packages).Can use separate indices for plain python packages and those with binary contents.Can log build results to a JUnit compatible XML file, thus that it can be parsed by Jenkins.LicenseNew BSDChangelogThis lists the most important changes for each release.Version 6.1.0 — 2023-09-22AddedSupport using VCS URLs in requirements files.FixedBuilding wheels for packages likezope-eventthat normalise the project name using dots instead of underscores is no longer broken.Version 6.0.0 — 2023-06-09AddedPython 3.10 and 3.11 are now supported.ChangedImproved performance of checking for already built packages.RemovedDropped support for running tests viasetup.py test.
The mechanism is considered deprecated by upstream and removing it allows us to drop a dependency.Python 3.6 is no longer supported. It likely still works but we will no longer run CI against it.Version 5.1.0 — 2021-11-05AddedProvide compatibility with pip 21.3 and above which drops the–build-directoryoption.
Pip has been using a temporary directory for builds since version 1.2 so manual handling of this directory should not be necessary anymore.Version 5.0.1 – 2020-09-09FixedAdhere to case-insensivity when comparing package names.
This will lead to blacklisting ‘cython’ vs. ‘Cython’ being the same thing.Version 5.0.0 – 2020-04-24FixedRemove dependency on the internalwheelAPI.
This blocked the use ofwheelversions >= 0.32.RemovedPython 2 is no longer supported.Python 3.5 is no longer supported.Version 4.0.0 – 2018-11-02FixedCorrectly specify the dependency to Wheel to avoid the latest, incompatible versions.RemovedPython 3.3 and Python 3.4 are no longer supported.Version 3.0.1 — 2017-11-21FixedProperly handle non-ASCII characters in the output of failed package builds. Previous versions used to crash in this
case if a JUnit XML output file was requested.Version 3.0.0 — 2017-06-16AddedThe command line parameter--batchcan be used to disable any prompts.ChangedThe way credentials are passed has been changed in an incompatible way.
The positional arguments for user and password no longer exist.
Instead, use one of the following:Pass the credentials via--userand--passwordcommand line arguments.Pass the credentials via the environment variablesDEVPI_USERandDEVPI_PASSWORD.Answer the interactive prompt for user and password. This is only possible if--batchis not used.Version 2.3.1 — 2017-05-19ChangedImproved performance if a blacklist is used.Version 2.3.0 — 2017-04-07AddedThe command line parameter--run-idallows to specify a run identifier that will be added to each entry in the
generated JUnit XML.ChangedChangelog is now in the format suggested byKeep-a-CHANGELOG.Version 2.2.0 — 2016-05-23AddedCapture build errors for better output in case of build failures. Thanks Travis Mehlinger.Version 2.1.0 — 2016-04-22AddedSupport for client certificates. Thanks Hans Lawrenz.Version 2.0.0 — 2016-01-20AddedCompatibility with pip >= 8.0 by relying on pip’s default download cache
mechanism instead of explicitly requiring a download cache. This effectively
disables caching for people still using pip < 6.0.
Thanks Christian Stefanescu.Support for dry-running the wheel build without changing the devpi server state.Python 3.5 is now officially supported.RemovedPython 3.2 is no longer supported.Version 1.0.0 — 2015-05-22ChangedUsedevpi-plumberinstead of a custom devpi wrapper.Check the blacklist first when deciding whether to build a package.Version 0.4.0 — 2015-09-13ChangedOnly consider a package to exist if it is a wheel and it is compatible with
the current system. Thanks Michael Still and David SzottenFixedThe source distribution now properly contains a README.md.
Thanks Mikhail Lukyanchenko.Version 0.3.0 — 2015-08-15AddedSupport for special-case handling of pure python wheelsOptional support for reporting skipped packages in a JUnit-compatible XMLPython 3 supportVersion 0.2.1 — 2014-08-07FixedFixed crash if a built wheel could cannot be found
(because pip<=1.5.2 skipped it).Version 0.2.0 — 2014-08-01AddedSupport for package blacklisting to never build certain wheels.Changedbuild as many packages as possible. Do not stop if one fails.Version 0.1.0 — 2014-08-01AddedBuild a list of packages and upload them to a Devpi index