Contributing

Running the tests

python -m unittest tests.test_build tests.test_examples -v

No dependencies required. tests.test_build builds real C extensions, verifies wheel structure, and confirms correct results. tests.test_examples builds each example in examples/ end-to-end; CMake and Meson tests skip gracefully if those tools are not installed.

Platform support

CI runs on all three platforms on every push.

Bootstrapping (offline or pre-release)

just-buildit is a pure Python package with no dependencies. If you need it before it can be fetched from PyPI — air-gapped environment, initial release bootstrap, or simply testing a local change — add the source directly to your path:

git clone https://github.com/just-buildit/just-buildit.git
export PYTHONPATH=/path/to/just-buildit/src:$PYTHONPATH

Then use your build frontend with --no-isolation so it picks up the local copy:

pip install --no-build-isolation .
# or
python -m build --wheel --no-isolation
# or
uv build --no-build-isolation

No build step, no compiler, no install required. src/just_buildit/ is importable as-is.