Skip to main content

bfg9000 - build file generator

bfg9000 is a cross-platform build configuration system with an emphasis on making it easy to define how to build your software. It converts a Python-based build script into the appropriate files for your underlying build system of choice (Ninja, Make, or MSBuild).

Why bfg9000?

Familiar syntax

build.bfg files are just Python scripts with some new functions added, so you may already know how to write them; and when your build gets complicated, you can rely on the existing Python ecosystem to get you out of trouble.

Fast builds

bfg9000 ensures your builds are fast by relying on existing, mature build systems like Make and Ninja to do the heavy lifting of building your software; often, incremental builds don't need to execute bfg9000 at all!

Stay sane

Building your code shouldn't be the hard part of developing your project. Above all else, bfg9000 strives to help you get your build right the first time with many helpful features.

A brief example

You can't get much simpler than the simplest build.bfg file:

executable('simple', files=['simple.cpp'])

To build this executable, we need to create the actual build files and then run them:

$ cd /path/to/src/
$ 9k build/
$ cd build/
$ ninja

From there, you can run your newly-created executable: ./simple. Hooray!

For further examples, please see the examples/ subdirectory.

Installation

bfg9000 uses setuptools, so installation is much the same as any other Python package:

$ pip install bfg9000

From there, you can start using bfg to build your software! (If you're using Ubuntu, you can also install bfg9000 from the following PPA: ppa:jimporter/stable). For more information about how to install bfg9000, see the documentation.

License

This project is licensed under the BSD 3-clause license.

Release files for bfg9000 0.7.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for bfg9000 0.7.1
File Size Uploaded
bfg9000-0.7.1.tar.gz 126.3 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for bfg9000 0.7.1
File Interpreter ABI Platform
bfg9000-0.7.1-py3-none-any.whl Python 3 none any Details

Total release size: 285.6 kB

Release files / bfg9000-0.7.1.tar.gz

Download URL bfg9000-0.7.1.tar.gz
Size 126.3 kB
Tags Source
SHA-256 checksum
How to use checksums
d10597806bdb3565a141afdd7a9ed34c749fde27aa9b52868c65655f06c69b26
BLAKE2b-256 checksum
How to use checksums
667216e6864e2f239cb322ce79ac10159936869a6b6874727e47640937e9a3e6
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/3.2.0 pkginfo/1.5.0.1 requests/2.28.1 setuptools/44.0.0 requests-toolbelt/0.9.1 tqdm/4.48.1 CPython/3.8.10

Release files / bfg9000-0.7.1-py3-none-any.whl

Download URL bfg9000-0.7.1-py3-none-any.whl
Size 159.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
3c6eedb56c0c800dc8e003e64f83fd1e65e367f800b50dc0b0d7a8a039231acc
BLAKE2b-256 checksum
How to use checksums
e9c538d772e07c831a54a53a1619acbf10ac444945f7323c907164c6fd7f4ac4
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/3.2.0 pkginfo/1.5.0.1 requests/2.28.1 setuptools/44.0.0 requests-toolbelt/0.9.1 tqdm/4.48.1 CPython/3.8.10

Release history Release notifications | RSS feed

This release

0.7.1 This release

2 release files

0.7.0

2 release files

0.6.0

2 release files

0.5.1

2 release files

0.5.0

2 release files

0.4.1

2 release files

0.4.0

2 release files

0.3.1

1 release file

0.3.0

2 release files

0.2.0

1 release file

0.1.1

1 release file

0.1.0

1 release file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page