Skip to main content
Join the official 2019 Python Developers SurveyStart the survey!

Provides dynamic variables in buildouts

Project description


Provides dynamic variables in buildouts.

An example use are unique DB names and conflict free parallel continuous integration runs on one machine.

Example buildout section:

recipe = buildout.variables
index-file = ${env:HOME}/jenkins-buildout-index.json
index-start = 0
index-key = ${env:JOB_NAME}
portbase = indexed 12{index}00
port = int portbase 0:100
port-instance = new port
jobname = str "${env:JOB_NAME}" [^a-zA-Z0-9] _

recipe = gocept.recipe.env

There are several things going on here.

The first are the index- options. They provide you with the possiblity to get unique indices based on a key and stored in a shared file. That way each buildout gets the same index for each key used. In the example above the key is the JOB_NAME environment variable (set by Jenkins for example) and the index starts at 0. If a buildout with a different JOB_NAME is run, then it will get the next free index.

The portbase option evaluates “12{index}00”.format(index=index). Thus the first job will get 12000 and the second job 12100 and so on.

The port option declares a range of integers which can be used to get unique ports for whatever you need them for. The port-instance option uses that to declare a port which can be used with ${variables:port-instance} throughout the buildout and would be 12000 in this example. If you declare more, then up to 12099 will be possible before you get an error. Which variable gets which port is determined by lexical order of the variable name.

The jobname option takes ${env:JOB_NAME} and runs re.sub on it. In this example everything besides letters and numbers is replaced by an underscore.

Besides integer ranges you can’t use other dynamic variables from the same section.


Thanks to Legacy Parts Corporation and for which this package was initially created.


0.3 - 2013-03-15

  • First official release. [fschulze]

0.2 - Unreleased

  • Fix persisted index. [fschulze]

0.1 - Unreleased

  • Initial version. [fschulze (Florian Schulze)]

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for buildout.variables, version 0.3
Filename, size File type Python version Upload date Hashes
Filename, size (9.2 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page