# Copyright 2018 The Meson development team # Licensed under the Apache License, Version 2.0 (the "License"); # you may not use this file except in compliance with the License. # You may obtain a copy of the License at # http://www.apache.org/licenses/LICENSE-2.0 # Unless required by applicable law or agreed to in writing, software # distributed under the License is distributed on an "AS IS" BASIS, # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. # See the License for the specific language governing permissions and # limitations under the License. import re import os, os.path, pathlib import shutil import typing as T from . import ExtensionModule, ModuleReturnValue, ModuleObject from .. import build, mesonlib, mlog, dependencies from ..cmake import SingleTargetOptions, TargetOptions, cmake_defines_to_args from ..interpreter import ConfigurationDataObject, SubprojectHolder from ..interpreterbase import ( FeatureNew, FeatureNewKwargs, FeatureDeprecatedKwargs, stringArgs, permittedKwargs, noPosargs, noKwargs, InvalidArguments, InterpreterException, ) from ..programs import ExternalProgram COMPATIBILITIES = ['AnyNewerVersion', 'SameMajorVersion', 'SameMinorVersion', 'ExactVersion'] # Taken from https://github.com/Kitware/CMake/blob/master/Modules/CMakePackageConfigHelpers.cmake PACKAGE_INIT_BASE = ''' ####### Expanded from \\@PACKAGE_INIT\\@ by configure_package_config_file() ####### ####### Any changes to this file will be overwritten by the next CMake run #### ####### The input file was @inputFileName@ ######## get_filename_component(PACKAGE_PREFIX_DIR "${CMAKE_CURRENT_LIST_DIR}/@PACKAGE_RELATIVE_PATH@" ABSOLUTE) ''' PACKAGE_INIT_EXT = ''' # Use original install prefix when loaded through a "/usr move" # cross-prefix symbolic link such as /lib -> /usr/lib. get_filename_component(_realCurr "${CMAKE_CURRENT_LIST_DIR}" REALPATH) get_filename_component(_realOrig "@absInstallDir@" REALPATH) if(_realCurr STREQUAL _realOrig) set(PACKAGE_PREFIX_DIR "@installPrefix@") endif() unset(_realOrig) unset(_realCurr) ''' PACKAGE_INIT_SET_AND_CHECK = ''' macro(set_and_check _var _file) set(${_var} "${_file}") if(NOT EXISTS "${_file}") message(FATAL_ERROR "File or directory ${_file} referenced by variable ${_var} does not exist !") endif() endmacro() #################################################################################### ''' class CMakeSubproject(ModuleObject): def __init__(self, subp, pv): assert isinstance(subp, SubprojectHolder) assert hasattr(subp, 'cm_interpreter') super().__init__() self.subp = subp self.methods.update({'get_variable': self.get_variable, 'dependency': self.dependency, 'include_directories': self.include_directories, 'target': self.target, 'target_type': self.target_type, 'target_list': self.target_list, 'found': self.found_method, }) def _args_to_info(self, args): if len(args) != 1: raise InterpreterException('Exactly one argument is required.') tgt = args[0] res = self.subp.cm_interpreter.target_info(tgt) if res is None: raise InterpreterException(f'The CMake target {tgt} does not exist\n' + ' Use the following command in your meson.build to list all available targets:\n\n' + ' message(\'CMaket targets:\\n - \' + \'\\n - \'.join(.target_list()))') # Make sure that all keys are present (if not this is a bug) assert all([x in res for x in ['inc', 'src', 'dep', 'tgt', 'func']]) return res @noKwargs @stringArgs def get_variable(self, state, args, kwargs): return self.subp.get_variable_method(args, kwargs) @FeatureNewKwargs('dependency', '0.56.0', ['include_type']) @permittedKwargs({'include_type'}) @stringArgs def dependency(self, state, args, kwargs): info = self._args_to_info(args) if info['func'] == 'executable': raise InvalidArguments(f'{args[0]} is an executable and does not support the dependency() method. Use target() instead.') orig = self.get_variable(state, [info['dep']], {}) assert isinstance(orig, dependencies.Dependency) actual = orig.include_type if 'include_type' in kwargs and kwargs['include_type'] != actual: mlog.debug('Current include type is {}. Converting to requested {}'.format(actual, kwargs['include_type'])) return orig.generate_system_dependency(kwargs['include_type']) return orig @noKwargs @stringArgs def include_directories(self, state, args, kwargs): info = self._args_to_info(args) return self.get_variable(state, [info['inc']], kwargs) @noKwargs @stringArgs def target(self, state, args, kwargs): info = self._args_to_info(args) return self.get_variable(state, [info['tgt']], kwargs) @noKwargs @stringArgs def target_type(self, state, args, kwargs): info = self._args_to_info(args) return info['func'] @noPosargs @noKwargs def target_list(self, state, args, kwargs): return self.subp.cm_interpreter.target_list() @noPosargs @noKwargs @FeatureNew('CMakeSubproject.found()', '0.53.2') def found_method(self, state, args, kwargs): return self.subp is not None class CMakeSubprojectOptions(ModuleObject): def __init__(self) -> None: super().__init__() self.cmake_options = [] # type: T.List[str] self.target_options = TargetOptions() self.methods.update( { 'add_cmake_defines': self.add_cmake_defines, 'set_override_option': self.set_override_option, 'set_install': self.set_install, 'append_compile_args': self.append_compile_args, 'append_link_args': self.append_link_args, 'clear': self.clear, } ) def _get_opts(self, kwargs: dict) -> SingleTargetOptions: if 'target' in kwargs: return self.target_options[kwargs['target']] return self.target_options.global_options @noKwargs def add_cmake_defines(self, state, args, kwargs) -> None: self.cmake_options += cmake_defines_to_args(args) @stringArgs @permittedKwargs({'target'}) def set_override_option(self, state, args, kwargs) -> None: if len(args) != 2: raise InvalidArguments('set_override_option takes exactly 2 positional arguments') self._get_opts(kwargs).set_opt(args[0], args[1]) @permittedKwargs({'target'}) def set_install(self, state, args, kwargs) -> None: if len(args) != 1 or not isinstance(args[0], bool): raise InvalidArguments('set_install takes exactly 1 boolean argument') self._get_opts(kwargs).set_install(args[0]) @stringArgs @permittedKwargs({'target'}) def append_compile_args(self, state, args, kwargs) -> None: if len(args) < 2: raise InvalidArguments('append_compile_args takes at least 2 positional arguments') self._get_opts(kwargs).append_args(args[0], args[1:]) @stringArgs @permittedKwargs({'target'}) def append_link_args(self, state, args, kwargs) -> None: if not args: raise InvalidArguments('append_link_args takes at least 1 positional argument') self._get_opts(kwargs).append_link_args(args) @noPosargs @noKwargs def clear(self, state, args, kwargs) -> None: self.cmake_options.clear() self.target_options = TargetOptions() class CmakeModule(ExtensionModule): cmake_detected = False cmake_root = None def __init__(self, interpreter): super().__init__(interpreter) self.methods.update({ 'write_basic_package_version_file': self.write_basic_package_version_file, 'configure_package_config_file': self.configure_package_config_file, 'subproject': self.subproject, 'subproject_options': self.subproject_options, }) def detect_voidp_size(self, env): compilers = env.coredata.compilers.host compiler = compilers.get('c', None) if not compiler: compiler = compilers.get('cpp', None) if not compiler: raise mesonlib.MesonException('Requires a C or C++ compiler to compute sizeof(void *).') return compiler.sizeof('void *', '', env) def detect_cmake(self): if self.cmake_detected: return True cmakebin = ExternalProgram('cmake', silent=False) if not cmakebin.found(): return False p, stdout, stderr = mesonlib.Popen_safe(cmakebin.get_command() + ['--system-information', '-G', 'Ninja'])[0:3] if p.returncode != 0: mlog.log(f'error retrieving cmake information: returnCode={p.returncode} stdout={stdout} stderr={stderr}') return False match = re.search('\nCMAKE_ROOT \\"([^"]+)"\n', stdout.strip()) if not match: mlog.log('unable to determine cmake root') return False cmakePath = pathlib.PurePath(match.group(1)) self.cmake_root = os.path.join(*cmakePath.parts) self.cmake_detected = True return True @permittedKwargs({'version', 'name', 'compatibility', 'install_dir'}) def write_basic_package_version_file(self, state, _args, kwargs): version = kwargs.get('version', None) if not isinstance(version, str): raise mesonlib.MesonException('Version must be specified.') name = kwargs.get('name', None) if not isinstance(name, str): raise mesonlib.MesonException('Name not specified.') compatibility = kwargs.get('compatibility', 'AnyNewerVersion') if not isinstance(compatibility, str): raise mesonlib.MesonException('compatibility is not string.') if compatibility not in COMPATIBILITIES: raise mesonlib.MesonException('compatibility must be either AnyNewerVersion, SameMajorVersion or ExactVersion.') if not self.detect_cmake(): raise mesonlib.MesonException('Unable to find cmake') pkgroot = pkgroot_name = kwargs.get('install_dir', None) if pkgroot is None: pkgroot = os.path.join(state.environment.coredata.get_option(mesonlib.OptionKey('libdir')), 'cmake', name) pkgroot_name = os.path.join('{libdir}', 'cmake', name) if not isinstance(pkgroot, str): raise mesonlib.MesonException('Install_dir must be a string.') template_file = os.path.join(self.cmake_root, 'Modules', f'BasicConfigVersion-{compatibility}.cmake.in') if not os.path.exists(template_file): raise mesonlib.MesonException(f'your cmake installation doesn\'t support the {compatibility} compatibility') version_file = os.path.join(state.environment.scratch_dir, f'{name}ConfigVersion.cmake') conf = { 'CVF_VERSION': (version, ''), 'CMAKE_SIZEOF_VOID_P': (str(self.detect_voidp_size(state.environment)), '') } mesonlib.do_conf_file(template_file, version_file, conf, 'meson') res = build.Data([mesonlib.File(True, state.environment.get_scratch_dir(), version_file)], pkgroot, pkgroot_name, None, state.subproject) return ModuleReturnValue(res, [res]) def create_package_file(self, infile, outfile, PACKAGE_RELATIVE_PATH, extra, confdata): package_init = PACKAGE_INIT_BASE.replace('@PACKAGE_RELATIVE_PATH@', PACKAGE_RELATIVE_PATH) package_init = package_init.replace('@inputFileName@', infile) package_init += extra package_init += PACKAGE_INIT_SET_AND_CHECK try: with open(infile, encoding='utf-8') as fin: data = fin.readlines() except Exception as e: raise mesonlib.MesonException(f'Could not read input file {infile}: {e!s}') result = [] regex = mesonlib.get_variable_regex('cmake@') for line in data: line = line.replace('@PACKAGE_INIT@', package_init) line, _missing = mesonlib.do_replacement(regex, line, 'cmake@', confdata) result.append(line) outfile_tmp = outfile + "~" with open(outfile_tmp, "w", encoding='utf-8') as fout: fout.writelines(result) shutil.copymode(infile, outfile_tmp) mesonlib.replace_if_different(outfile, outfile_tmp) @permittedKwargs({'input', 'name', 'install_dir', 'configuration'}) def configure_package_config_file(self, state, args, kwargs): if args: raise mesonlib.MesonException('configure_package_config_file takes only keyword arguments.') if 'input' not in kwargs: raise mesonlib.MesonException('configure_package_config_file requires "input" keyword.') inputfile = kwargs['input'] if isinstance(inputfile, list): if len(inputfile) != 1: m = "Keyword argument 'input' requires exactly one file" raise mesonlib.MesonException(m) inputfile = inputfile[0] if not isinstance(inputfile, (str, mesonlib.File)): raise mesonlib.MesonException("input must be a string or a file") if isinstance(inputfile, str): inputfile = mesonlib.File.from_source_file(state.environment.source_dir, state.subdir, inputfile) ifile_abs = inputfile.absolute_path(state.environment.source_dir, state.environment.build_dir) if 'name' not in kwargs: raise mesonlib.MesonException('"name" not specified.') name = kwargs['name'] (ofile_path, ofile_fname) = os.path.split(os.path.join(state.subdir, f'{name}Config.cmake')) ofile_abs = os.path.join(state.environment.build_dir, ofile_path, ofile_fname) install_dir = kwargs.get('install_dir', os.path.join(state.environment.coredata.get_option(mesonlib.OptionKey('libdir')), 'cmake', name)) if not isinstance(install_dir, str): raise mesonlib.MesonException('"install_dir" must be a string.') if 'configuration' not in kwargs: raise mesonlib.MesonException('"configuration" not specified.') conf = kwargs['configuration'] if not isinstance(conf, ConfigurationDataObject): raise mesonlib.MesonException('Argument "configuration" is not of type configuration_data') prefix = state.environment.coredata.get_option(mesonlib.OptionKey('prefix')) abs_install_dir = install_dir if not os.path.isabs(abs_install_dir): abs_install_dir = os.path.join(prefix, install_dir) PACKAGE_RELATIVE_PATH = os.path.relpath(prefix, abs_install_dir) extra = '' if re.match('^(/usr)?/lib(64)?/.+', abs_install_dir): extra = PACKAGE_INIT_EXT.replace('@absInstallDir@', abs_install_dir) extra = extra.replace('@installPrefix@', prefix) self.create_package_file(ifile_abs, ofile_abs, PACKAGE_RELATIVE_PATH, extra, conf.conf_data) conf.mark_used() conffile = os.path.normpath(inputfile.relative_name()) if conffile not in self.interpreter.build_def_files: self.interpreter.build_def_files.append(conffile) res = build.Data([mesonlib.File(True, ofile_path, ofile_fname)], install_dir, install_dir, None, state.subproject) self.interpreter.build.data.append(res) return res @FeatureNew('subproject', '0.51.0') @FeatureNewKwargs('subproject', '0.55.0', ['options']) @FeatureDeprecatedKwargs('subproject', '0.55.0', ['cmake_options']) @permittedKwargs({'cmake_options', 'required', 'options'}) @stringArgs def subproject(self, state, args, kwargs): if len(args) != 1: raise InterpreterException('Subproject takes exactly one argument') if 'cmake_options' in kwargs and 'options' in kwargs: raise InterpreterException('"options" cannot be used together with "cmake_options"') dirname = args[0] subp = self.interpreter.do_subproject(dirname, 'cmake', kwargs) if not subp.found(): return subp return CMakeSubproject(subp, dirname) @FeatureNew('subproject_options', '0.55.0') @noKwargs @noPosargs def subproject_options(self, state, args, kwargs) -> CMakeSubprojectOptions: return CMakeSubprojectOptions() def initialize(*args, **kwargs): return CmakeModule(*args, **kwargs)