burn-build is available on PyPI. Simply install the package into your project environment with PIP:

pip install pyburn_build

Once installed, you can start using the library in your Python projects.

Create project_config.json:

{ "metadata": { "name": "Example", "version": "0.1.0", "description": "Hello World app", "language": "cpp", "use_cmake": false, "cache_file": "cache.json", "features": ["pyechonext"] }, "compiler": { "name": "g++", "base_compiler_flags": ["-Wall"] } }

Create toolchain_config.json:

{ "prelude_commands": [], "targets": { "target1": { "compiler_options": ["-O2", "-pedantic"], "sources": ["src/main.c"], "output": "out/target1.out", "includes": [], "objects": [], "compiler": "gcc" }, "target2": { "compiler_options": ["-O3", "-pedantic"], "sources": ["src/main2.cpp"], "output": "out/target2.out", "includes": [], "objects": [] } }, "post_commands": [] }

And create project:

python3 -m pyburn_build create --project-config example_configs/project_config.json --toolchain-config example_configs/toolchain_config.json

And build project:

python3 -m pyburn_build build --project-config example_configs/project_config.json --toolchain-config example_configs/toolchain_config.json

Basic project information

Meta information and other general characteristics of the project.

• name - project name
• version - project version
• description - short project description
• language - main project language
• use_cmake - use cmake flag (experimental)
• cache_file - path to cache json file
• features - list of enabled features (supported: pyechonext)

Information about the compiler, basic flags.

• name - main compiler name
• base_compiler_flags - list of compiler flags

Setting up tools, build chain, commands.

• prelude_commands - Commands to execute before build
• post_commands - Commands to execute after build
• targets - dict with targets

Targets list

• compiler_options - additional compiler flags
• sources - list with sources for target
• output - output filename
• includes - include-files (C/C++)
• objects - .o files
• compiler - compiler command