Skip to content

Latest commit

 

History

History
52 lines (36 loc) · 1.71 KB

File metadata and controls

52 lines (36 loc) · 1.71 KB

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 :ref:`how-to-guides-config-settings` and :ref:`how-to-guides-meson-args` guides for information on how to use them.

.. option:: build-dir

   By default ``meson-python`` uses a temporary build directory.
   This settings allows to select the Meson build directory and
   prevents it to be deleted when ``meson-python`` terminates.  If the
   directory does not exists, it will be created.  If the directory
   exists and contains a valid Meson build directory setup, the
   project will be reconfigured using ``meson setup --reconfigure``.

   For backward compatibility reasons, the alternative ``builddir``
   spelling is also accepted.

.. option:: dist-args

   Extra arguments to be passed to the ``meson dist`` command.

.. option:: setup-args

   Extra arguments to be passed to the ``meson setup`` command.

.. option:: compile-args

   Extra arguments to be passed to the ``ninja`` command.

.. option:: install-args

   Extra arguments to be passed to the ``meson install`` command.

.. option:: editable-verbose

   Enable :ref:`verbose mode <how-to-guides-editable-installs-verbose>` when
   building for an :ref:`editable install <how-to-guides-editable-installs>`.
   Accepts an optional argument interpreted as a boolean: the strings ``true``
   and ``1`` are mapped to true, and the strings ``false`` and ``0`` to
   false. This config setting takes precedence over the project setting with
   the same name.