Configuration
Full reference
[tool.just-buildit]
command = "make" # optional — omit for zero-config src/{package}/ build
package = "my_package" # optional — package dir name when it differs from project name
editable_path = "src" # optional — src root for fast .pth-file editable installs
repair = "uvx ..." # optional — auto-detected by platform, or false to skip
exclude = [ # optional — glob patterns relative to $JUST_BUILDIT_OUTPUT_DIR
"mypkg/tests/**",
"mypkg/bench/**",
]
__pycache__/, *.pyc, and *.pyo are always excluded.
Wheel repair
just-buildit automatically runs the right repair tool for your platform:
| Platform | Tool |
|---|---|
| Linux | uvx auditwheel repair |
| macOS | uvx --from delocate delocate-wheel |
| Windows / MinGW | uvx delvewheel repair |
Override or disable repair in your config:
[tool.just-buildit]
command = "make"
repair = "uvx auditwheel repair --plat manylinux_2_28_x86_64" # custom
# repair = false # skip entirely
Editable installs
Set editable_path to the directory that should be added to sys.path:
[tool.just-buildit]
command = "make"
editable_path = "src"
pip install -e . then installs a single .pth file pointing at src/ —
no build command is run. Python finds your source directly. The C extension
must be compiled in place once (e.g. make) before importing.
Without editable_path, pip install -e . falls back to a full wheel build.