craft_parts.plugins.cmake_plugin module

The cmake plugin.

class craft_parts.plugins.cmake_plugin.CMakePlugin(*, properties, part_info)

Bases: Plugin

The cmake plugin is useful for building cmake based parts.

These are projects that have a CMakeLists.txt that drives the build. The plugin requires a CMakeLists.txt in the root of the source tree.

This plugin uses the common plugin keywords as well as those for “sources”. For more information check the ‘plugins’ topic for the former and the ‘sources’ topic for the latter.

This implementation follows the syntax and behavior used in the Snapcraft cmake plugin for core20. Unlike the cmake plugin used for core18, CMAKE_INSTALL_PREFIX is not automatically set. To retain compatibility with the Snapcraft core18 plugin, define the cmake parameter -DCMAKE_INSTALL_PREFIX= in your project. This also allows libraries built using the cmake plugin and staged by a different part to be automatically recognized without defining additional parameters such as CMAKE_INCLUDE_PATH or CMAKE_INSTALL_PATH.

This plugin uses the following plugin-specific keywords:

• cmake-parameters (list of strings) parameters to pass to the build using the common cmake semantics.

• cmake-generator (string; default: “Unix Makefiles”) Determine what native build system is to be used. Can be either Ninja or Unix Makefiles (default).

Parameters:

• properties (PluginProperties) –

• part_info (PartInfo) –

get_build_commands()

Return a list of commands to run during the build step.

Return type:

List[str]

get_build_environment()

Return a dictionary with the environment to use in the build step.

Return type:

Dict[str, str]

get_build_packages()

Return a set of required packages to install in the build environment.

Return type:

Set[str]

get_build_snaps()

Return a set of required snaps to install in the build environment.

Return type:

Set[str]

classmethod get_out_of_source_build()

Return whether the plugin performs out-of-source-tree builds.

Return type:

bool

properties_class

alias of CMakePluginProperties

class craft_parts.plugins.cmake_plugin.CMakePluginProperties(**data)

Bases: PluginProperties, PluginModel

The part properties used by the cmake plugin.

Parameters:

data (Any) –

cmake_generator: str

cmake_parameters: List[str]

source: str

classmethod unmarshal(data)

Populate class attributes from the part specification.

Parameters:

data (Dict[str, Any]) – A dictionary containing part properties.

Return type:

CMakePluginProperties

Returns:

The populated plugin properties data object.

Raises:

pydantic.ValidationError – If validation fails.