zc.buildout

library5.2.0pypypi✓ verified 83d ago

A powerful build system for managing development buildouts, automating setup of projects with multiple components. Version 5.2.0, with a stable release every few years.

devops

pip install zc.buildout

package ↗homepage ↗

INSTALL

IMPORT

SIG · ZC.BUILDOUT

zc.buildout

devopspythonv5.2.0

Install

2.1s avg

Import

1558ms

Disk

23MB

Pass rate

10/ 10

Env Coverage10 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v5.2.0 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.95 runs

installs and imports cleanly · install 0.0s · import 1.646s · 20.9MB

glibc

py 3.10–3.95 runs

installs and imports cleanly · install 2.1s · import 1.470s · 21MB

23MB installed

● package 23MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

buildout

✓ import zc.buildout

✗ import buildout

'buildout' is a separate package on PyPI; the top-level module is inside the 'zc' namespace.

Buildout

✓ from zc.buildout import Buildout

✗ from buildout import Buildout

Wrong top-level import due to namespace.

Programmatic invocation of buildout; typically invoked via the 'bin/buildout' script.

import zc.buildout import os # Basic usage: run from a directory with a buildout.cfg if os.path.exists('buildout.cfg'): buildout = zc.buildout.Buildout(os.getcwd()) buildout.install(None) else: print('No buildout.cfg found; create one first.') print('Buildout ran successfully.')

buildout --version

Debug

Known issues

breakingIn version 5.0.0, the 'download-cache' option was removed. Use 'download-directory' instead.

fix

Replace 'download-cache = ...' with 'download-directory = ...' in buildout.cfg.

affects: >=5.0.0

breakingPython 3.9+ required as of 5.0.0. Python 2.7 and older 3.x are no longer supported.

fix

Ensure you have Python >= 3.9 installed.

affects: >=5.0.0

gotchaThe 'zc.buildout' package installs the 'buildout' console script, but importing 'buildout' in Python gives a different package. Always import 'zc.buildout'.

fix

Use 'import zc.buildout' and ensure the namespace package 'zc' is installed.

affects: all

deprecatedThe 'develop' recipe (zc.recipe.devel) is deprecated in favor of 'pip install -e' within the buildout environment.

fix

Use the 'pip' recipe or manual 'pip install -e .' inside the buildout environment.

affects: >=5.0

Errors

Common errors & fixes

ImportError: No module named buildout

Incorrect import statement; using 'import buildout' instead of 'import zc.buildout'.

fix

Change to 'import zc.buildout'.

AttributeError: module 'zc.buildout' has no attribute 'Buildout'

Old version of zc.buildout (<5.0) had Buildout class in a different location, or incorrect import path.

fix

Use 'from zc.buildout import Buildout' and ensure you're using zc.buildout >=5.0. For older versions, see documentation.

ConfigParser.InterpolationSyntaxError: '%' must be followed by '%' or '(', found: '%('

Buildout config files use '%(...)s' substitution, but the parser interprets '%' specially.

fix

Escape '%' as '%%' in values where '%' is literal, e.g., 'url = http://example.com%%path'.

Upgrade

Version history

5.2.0latest on PyPI · released Apr 29, 2026

Audit

Dependencies

setuptoolsrequiredRuntime dependency for egg handling and entry points.

zc.recipe.eggoptionalCommon recipe, not required but often used.

Agent activity

40 hits · last 30 days

node

Resources

packagehttps://pypi.org/project/zc.buildout/ ↗

homepagehttp://buildout.org ↗