Meson

Warning

This is an experimental feature subject to breaking changes in future releases.

Available since: 1.33.0

The Meson() build helper that works with the MesonToolchain is also experimental, and subject to breaking change in the future. It will evolve to adapt and complement the toolchain functionality.

The helper is intended to be used in the build() method, to call Meson commands automatically when a package is being built directly by Conan (create, install)

from conan.tools.meson import Meson

def build(self):
    meson = Meson(self)
    meson.configure()
    meson.build()

It supports the following methods:

constructor

def __init__(self, conanfile):

  • conanfile: the current recipe object. Always use self.

configure()

def configure(self, reconfigure=False):

Calls meson, with the given generator and passing either --native-file conan_meson_native.ini (native builds) or --cross-file conan_meson_cross.ini (cross builds). Use tools.meson.mesontoolchain:extra_machine_files=[<FILENAME>] configuration to add your machine files at the end of the command using the correct parameter depending on native or cross builds. See this Meson reference for more information.

Parameters:

  • reconfigure (Optional, Defaulted to False): Adds the --reconfigure parameter to the meson setup command if True.

build()

def build(self, target=None):

Calls the build system. Equivalent to meson compile -C . in the build folder.

Parameters:

  • target (Optional, Defaulted to None): Specifies the target to execute. The default all target will be built if None is specified.

install()

def install(self):

Installs development files (headers, libraries, etc.). Equivalent to run meson install -C . in the build folder.

test()

def test(self):

Runs project’s tests. Equivalent to running meson test -v -C . in the build folder. Use tools.build:skip_test=False to avoid execute this command and skip the tests.

conf

  • tools.build:jobs=10 (integer) argument for the --jobs parameter when running Ninja.

  • tools.build:skip_test=<bool>``(boolean) if ``True running meson test.

  • tools.meson.mesontoolchain:extra_machine_files=["<FILENAME>"] (list of strings) adds your own extra machine files in meson setup command, e.g., meson setup --native-file "conan_meson_native.ini" --native-file "<FILENAME>".