Build config settings#

This page lists the build configuration settings, that is, the settings you can pass when building the project. Please refer to the Use build config settings and Passing arguments to Meson guides for information on how to use them.

Setting name

Description

builddir

Selects the Meson build directory to use. If the directory already exists, it will be re-used, if it does not exists, it will be created. This lets you avoid rebuilding the whole project from scratch when developing. It is also useful if you want to configure the build yourself.

Use at your own risk

Re-using a build directory that was not configured by meson-python can cause issues, so use at your own risk. We cannot fully support this use-case, but will try to fix issues where possible and reasonably viable.

Passing this option with a non-existent build directory, letting meson-python configure it, and then passing it again on subsequent builds, is perfectly fine. Just be sure to delete the build directory after changing the meson-python version, as that might cause issues.

dist-args

Extra arguments to be passed to the meson dist command. The arguments are placed after the pyproject.toml settings ones.

setup-args

Extra arguments to be passed to the meson setup command. The arguments are placed after the pyproject.toml settings ones.

compile-args

Extra arguments to be passed to the meson compile command. The arguments are placed after the pyproject.toml settings ones.

install-args

Extra arguments to be passed to the meson install command. The arguments are placed after the pyproject.toml settings ones.

editable-verbose

Enable verbose mode on editable an install.

Only valid on editable installs

This option is only valid when building the project for an editable install. Please check our Editable installs guide for more information.

Check our guides

Check our guides to learn more about how to use these settings: