The Meson Build System
http://mesonbuild.com/
You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
1826 lines
75 KiB
1826 lines
75 KiB
# Copyright 2012-2017 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 copy, os, re |
|
from collections import OrderedDict |
|
|
|
from . import environment |
|
from . import dependencies |
|
from . import mlog |
|
from .mesonlib import File, MesonException |
|
from .mesonlib import flatten, typeslistify, stringlistify, classify_unity_sources |
|
from .mesonlib import get_filenames_templates_dict, substitute_values |
|
from .environment import for_windows, for_darwin, for_cygwin |
|
from .compilers import is_object, clike_langs, sort_clike, lang_suffixes |
|
|
|
known_basic_kwargs = {'install': True, |
|
'c_pch': True, |
|
'cpp_pch': True, |
|
'c_args': True, |
|
'objc_args': True, |
|
'objcpp_args': True, |
|
'cpp_args': True, |
|
'cs_args': True, |
|
'vala_args': True, |
|
'fortran_args': True, |
|
'd_args': True, |
|
'java_args': True, |
|
'rust_args': True, |
|
'link_args': True, |
|
'link_depends': True, |
|
'link_with': True, |
|
'link_whole': True, |
|
'include_directories': True, |
|
'dependencies': True, |
|
'install_dir': True, |
|
'main_class': True, |
|
'name_suffix': True, |
|
'gui_app': True, |
|
'extra_files': True, |
|
'install_rpath': True, |
|
'build_rpath': True, |
|
'resources': True, |
|
'sources': True, |
|
'objects': True, |
|
'native': True, |
|
'build_by_default': True, |
|
'override_options': True, |
|
} |
|
|
|
# These contain kwargs supported by both static and shared libraries. These are |
|
# combined here because a library() call might be shared_library() or |
|
# static_library() at runtime based on the configuration. |
|
# FIXME: Find a way to pass that info down here so we can have proper target |
|
# kwargs checking when specifically using shared_library() or static_library(). |
|
known_lib_kwargs = known_basic_kwargs.copy() |
|
known_lib_kwargs.update({'version': True, # Only for shared libs |
|
'soversion': True, # Only for shared libs |
|
'name_prefix': True, |
|
'vs_module_defs': True, # Only for shared libs |
|
'vala_header': True, |
|
'vala_vapi': True, |
|
'vala_gir': True, |
|
'pic': True, # Only for static libs |
|
'rust_crate_type': True, # Only for Rust libs |
|
}) |
|
|
|
known_exe_kwargs = known_basic_kwargs.copy() |
|
known_exe_kwargs.update({'implib': True, |
|
}) |
|
|
|
class InvalidArguments(MesonException): |
|
pass |
|
|
|
class Build: |
|
"""A class that holds the status of one build including |
|
all dependencies and so on. |
|
""" |
|
|
|
def __init__(self, environment): |
|
self.project_name = 'name of master project' |
|
self.project_version = None |
|
self.environment = environment |
|
self.projects = {} |
|
self.targets = OrderedDict() |
|
self.compilers = OrderedDict() |
|
self.cross_compilers = OrderedDict() |
|
self.global_args = {} |
|
self.projects_args = {} |
|
self.global_link_args = {} |
|
self.projects_link_args = {} |
|
self.tests = [] |
|
self.benchmarks = [] |
|
self.headers = [] |
|
self.man = [] |
|
self.data = [] |
|
self.static_linker = None |
|
self.static_cross_linker = None |
|
self.subprojects = {} |
|
self.install_scripts = [] |
|
self.postconf_scripts = [] |
|
self.install_dirs = [] |
|
self.dep_manifest_name = None |
|
self.dep_manifest = {} |
|
self.cross_stdlibs = {} |
|
self.test_setups = {} |
|
|
|
def add_compiler(self, compiler): |
|
if self.static_linker is None and compiler.needs_static_linker(): |
|
self.static_linker = self.environment.detect_static_linker(compiler) |
|
lang = compiler.get_language() |
|
if lang not in self.compilers: |
|
self.compilers[lang] = compiler |
|
|
|
def add_cross_compiler(self, compiler): |
|
if not self.cross_compilers: |
|
self.static_cross_linker = self.environment.detect_static_linker(compiler) |
|
lang = compiler.get_language() |
|
if lang not in self.cross_compilers: |
|
self.cross_compilers[lang] = compiler |
|
|
|
def get_project(self): |
|
return self.projects[''] |
|
|
|
def get_targets(self): |
|
return self.targets |
|
|
|
def get_tests(self): |
|
return self.tests |
|
|
|
def get_benchmarks(self): |
|
return self.benchmarks |
|
|
|
def get_headers(self): |
|
return self.headers |
|
|
|
def get_man(self): |
|
return self.man |
|
|
|
def get_data(self): |
|
return self.data |
|
|
|
def get_install_subdirs(self): |
|
return self.install_dirs |
|
|
|
def get_global_args(self, compiler): |
|
return self.global_args.get(compiler.get_language(), []) |
|
|
|
def get_project_args(self, compiler, project): |
|
args = self.projects_args.get(project) |
|
if not args: |
|
return [] |
|
return args.get(compiler.get_language(), []) |
|
|
|
def get_global_link_args(self, compiler): |
|
return self.global_link_args.get(compiler.get_language(), []) |
|
|
|
def get_project_link_args(self, compiler, project): |
|
link_args = self.projects_link_args.get(project) |
|
if not link_args: |
|
return [] |
|
|
|
return link_args.get(compiler.get_language(), []) |
|
|
|
class IncludeDirs: |
|
def __init__(self, curdir, dirs, is_system, extra_build_dirs=None): |
|
self.curdir = curdir |
|
self.incdirs = dirs |
|
self.is_system = is_system |
|
# Interpreter has validated that all given directories |
|
# actually exist. |
|
if extra_build_dirs is None: |
|
self.extra_build_dirs = [] |
|
else: |
|
self.extra_build_dirs = extra_build_dirs |
|
|
|
def __repr__(self): |
|
r = '<{} {}/{}>' |
|
return r.format(self.__class__.__name__, self.curdir, self.incdirs) |
|
|
|
def get_curdir(self): |
|
return self.curdir |
|
|
|
def get_incdirs(self): |
|
return self.incdirs |
|
|
|
def get_extra_build_dirs(self): |
|
return self.extra_build_dirs |
|
|
|
class ExtractedObjects: |
|
''' |
|
Holds a list of sources for which the objects must be extracted |
|
''' |
|
def __init__(self, target, srclist, is_unity): |
|
self.target = target |
|
self.srclist = srclist |
|
if is_unity: |
|
self.check_unity_compatible() |
|
|
|
def __repr__(self): |
|
r = '<{0} {1!r}: {2}>' |
|
return r.format(self.__class__.__name__, self.target.name, self.srclist) |
|
|
|
def check_unity_compatible(self): |
|
# Figure out if the extracted object list is compatible with a Unity |
|
# build. When we're doing a Unified build, we go through the sources, |
|
# and create a single source file from each subset of the sources that |
|
# can be compiled with a specific compiler. Then we create one object |
|
# from each unified source file. |
|
# If the list of sources for which we want objects is the same as the |
|
# list of sources that go into each unified build, we're good. |
|
srclist_set = set(self.srclist) |
|
# Objects for all the sources are required, so we're compatible |
|
if srclist_set == set(self.target.sources): |
|
return |
|
# Check if the srclist is a subset (of the target's sources) that is |
|
# going to form a unified source file and a single object |
|
compsrcs = classify_unity_sources(self.target.compilers.values(), |
|
self.target.sources) |
|
for srcs in compsrcs.values(): |
|
if srclist_set == set(srcs): |
|
return |
|
msg = 'Single object files can not be extracted in Unity builds. ' \ |
|
'You can only extract all the object files at once.' |
|
raise MesonException(msg) |
|
|
|
|
|
class EnvironmentVariables: |
|
def __init__(self): |
|
self.envvars = [] |
|
|
|
def __repr__(self): |
|
repr_str = "<{0}: {1}>" |
|
return repr_str.format(self.__class__.__name__, self.envvars) |
|
|
|
def get_value(self, values, kwargs): |
|
separator = kwargs.get('separator', os.pathsep) |
|
|
|
value = '' |
|
for var in values: |
|
value += separator + var |
|
return separator, value.strip(separator) |
|
|
|
def set(self, env, name, values, kwargs): |
|
return self.get_value(values, kwargs)[1] |
|
|
|
def append(self, env, name, values, kwargs): |
|
sep, value = self.get_value(values, kwargs) |
|
if name in env: |
|
return env[name] + sep + value |
|
return value |
|
|
|
def prepend(self, env, name, values, kwargs): |
|
sep, value = self.get_value(values, kwargs) |
|
if name in env: |
|
return value + sep + env[name] |
|
|
|
return value |
|
|
|
def get_env(self, full_env): |
|
env = {} |
|
for method, name, values, kwargs in self.envvars: |
|
env[name] = method(full_env, name, values, kwargs) |
|
return env |
|
|
|
class Target: |
|
def __init__(self, name, subdir, build_by_default): |
|
if '/' in name or '\\' in name: |
|
# Fix failing test 53 when this becomes an error. |
|
mlog.warning('''Target "%s" has a path separator in its name. |
|
This is not supported, it can cause unexpected failures and will become |
|
a hard error in the future.''' % name) |
|
self.name = name |
|
self.subdir = subdir |
|
self.build_by_default = build_by_default |
|
self.install = False |
|
self.build_always = False |
|
self.option_overrides = {} |
|
|
|
def get_basename(self): |
|
return self.name |
|
|
|
def get_subdir(self): |
|
return self.subdir |
|
|
|
def process_kwargs(self, kwargs): |
|
if 'build_by_default' in kwargs: |
|
self.build_by_default = kwargs['build_by_default'] |
|
if not isinstance(self.build_by_default, bool): |
|
raise InvalidArguments('build_by_default must be a boolean value.') |
|
self.option_overrides = self.parse_overrides(kwargs) |
|
|
|
def parse_overrides(self, kwargs): |
|
result = {} |
|
overrides = stringlistify(kwargs.get('override_options', [])) |
|
for o in overrides: |
|
if '=' not in o: |
|
raise InvalidArguments('Overrides must be of form "key=value"') |
|
k, v = o.split('=', 1) |
|
k = k.strip() |
|
v = v.strip() |
|
result[k] = v |
|
return result |
|
|
|
|
|
class BuildTarget(Target): |
|
def __init__(self, name, subdir, subproject, is_cross, sources, objects, environment, kwargs): |
|
super().__init__(name, subdir, True) |
|
self.subproject = subproject # Can not be calculated from subdir as subproject dirname can be changed per project. |
|
self.is_cross = is_cross |
|
unity_opt = environment.coredata.get_builtin_option('unity') |
|
self.is_unity = unity_opt == 'on' or (unity_opt == 'subprojects' and subproject != '') |
|
self.environment = environment |
|
self.sources = [] |
|
self.compilers = OrderedDict() |
|
self.objects = [] |
|
self.external_deps = [] |
|
self.include_dirs = [] |
|
self.link_targets = [] |
|
self.link_whole_targets = [] |
|
self.link_depends = [] |
|
self.name_prefix_set = False |
|
self.name_suffix_set = False |
|
self.filename = 'no_name' |
|
# The list of all files outputted by this target. Useful in cases such |
|
# as Vala which generates .vapi and .h besides the compiled output. |
|
self.outputs = [self.filename] |
|
self.need_install = False |
|
self.pch = {} |
|
self.extra_args = {} |
|
self.generated = [] |
|
self.extra_files = [] |
|
# Sources can be: |
|
# 1. Pre-existing source files in the source tree |
|
# 2. Pre-existing sources generated by configure_file in the build tree |
|
# 3. Sources files generated by another target or a Generator |
|
self.process_sourcelist(sources) |
|
# Objects can be: |
|
# 1. Pre-existing objects provided by the user with the `objects:` kwarg |
|
# 2. Compiled objects created by and extracted from another target |
|
self.process_objectlist(objects) |
|
self.process_kwargs(kwargs, environment) |
|
self.check_unknown_kwargs(kwargs) |
|
if not self.sources and not self.generated and not self.objects: |
|
raise InvalidArguments('Build target %s has no sources.' % name) |
|
self.process_compilers() |
|
self.validate_sources() |
|
self.validate_cross_install(environment) |
|
|
|
def __lt__(self, other): |
|
return self.get_id() < other.get_id() |
|
|
|
def __repr__(self): |
|
repr_str = "<{0} {1}: {2}>" |
|
return repr_str.format(self.__class__.__name__, self.get_id(), self.filename) |
|
|
|
def validate_cross_install(self, environment): |
|
if environment.is_cross_build() and not self.is_cross and self.install: |
|
raise InvalidArguments('Tried to install a natively built target in a cross build.') |
|
|
|
def get_id(self): |
|
# This ID must also be a valid file name on all OSs. |
|
# It should also avoid shell metacharacters for obvious |
|
# reasons. |
|
base = self.name + self.type_suffix() |
|
if self.subproject == '': |
|
return base |
|
return self.subproject + '@@' + base |
|
|
|
def check_unknown_kwargs(self, kwargs): |
|
# Override this method in derived classes that have more |
|
# keywords. |
|
self.check_unknown_kwargs_int(kwargs, known_basic_kwargs) |
|
|
|
def check_unknown_kwargs_int(self, kwargs, known_kwargs): |
|
unknowns = [] |
|
for k in kwargs: |
|
if k not in known_kwargs: |
|
unknowns.append(k) |
|
if len(unknowns) > 0: |
|
mlog.warning('Unknown keyword argument(s) in target %s: %s.' % |
|
(self.name, ', '.join(unknowns))) |
|
|
|
def process_objectlist(self, objects): |
|
assert(isinstance(objects, list)) |
|
for s in objects: |
|
if hasattr(s, 'held_object'): |
|
s = s.held_object |
|
if isinstance(s, (str, File, ExtractedObjects)): |
|
self.objects.append(s) |
|
elif isinstance(s, (GeneratedList, CustomTarget)): |
|
msg = 'Generated files are not allowed in the \'objects\' kwarg ' + \ |
|
'for target {!r}.\nIt is meant only for '.format(self.name) + \ |
|
'pre-built object files that are shipped with the\nsource ' + \ |
|
'tree. Try adding it in the list of sources.' |
|
raise InvalidArguments(msg) |
|
else: |
|
msg = 'Bad object of type {!r} in target {!r}.'.format(type(s).__name__, self.name) |
|
raise InvalidArguments(msg) |
|
|
|
def process_sourcelist(self, sources): |
|
if not isinstance(sources, list): |
|
sources = [sources] |
|
added_sources = {} # If the same source is defined multiple times, use it only once. |
|
for s in sources: |
|
# Holder unpacking. Ugly. |
|
if hasattr(s, 'held_object'): |
|
s = s.held_object |
|
if isinstance(s, File): |
|
if s not in added_sources: |
|
self.sources.append(s) |
|
added_sources[s] = True |
|
elif isinstance(s, (GeneratedList, CustomTarget)): |
|
self.generated.append(s) |
|
else: |
|
msg = 'Bad source of type {!r} in target {!r}.'.format(type(s).__name__, self.name) |
|
raise InvalidArguments(msg) |
|
|
|
@staticmethod |
|
def can_compile_remove_sources(compiler, sources): |
|
removed = False |
|
for s in sources[:]: |
|
if compiler.can_compile(s): |
|
sources.remove(s) |
|
removed = True |
|
return removed |
|
|
|
def process_compilers(self): |
|
''' |
|
Populate self.compilers, which is the list of compilers that this |
|
target will use for compiling all its sources. |
|
We also add compilers that were used by extracted objects to simplify |
|
dynamic linker determination. |
|
''' |
|
if not self.sources and not self.generated and not self.objects: |
|
return |
|
# Populate list of compilers |
|
if self.is_cross: |
|
compilers = self.environment.coredata.cross_compilers |
|
else: |
|
compilers = self.environment.coredata.compilers |
|
# Pre-existing sources |
|
sources = list(self.sources) |
|
# All generated sources |
|
for gensrc in self.generated: |
|
for s in gensrc.get_outputs(): |
|
# Generated objects can't be compiled, so don't use them for |
|
# compiler detection. If our target only has generated objects, |
|
# we will fall back to using the first c-like compiler we find, |
|
# which is what we need. |
|
if not is_object(s): |
|
sources.append(s) |
|
# Sources that were used to create our extracted objects |
|
for o in self.objects: |
|
if not isinstance(o, ExtractedObjects): |
|
continue |
|
for s in o.srclist: |
|
# Don't add Vala sources since that will pull in the Vala |
|
# compiler even though we will never use it since we are |
|
# dealing with compiled C code. |
|
if not s.endswith(lang_suffixes['vala']): |
|
sources.append(s) |
|
if sources: |
|
# For each source, try to add one compiler that can compile it. |
|
# It's ok if no compilers can do so, because users are expected to |
|
# be able to add arbitrary non-source files to the sources list. |
|
for s in sources: |
|
for lang, compiler in compilers.items(): |
|
if compiler.can_compile(s): |
|
if lang not in self.compilers: |
|
self.compilers[lang] = compiler |
|
break |
|
# Re-sort according to clike_langs |
|
self.compilers = OrderedDict(sorted(self.compilers.items(), |
|
key=lambda t: sort_clike(t[0]))) |
|
else: |
|
# No source files, target consists of only object files of unknown |
|
# origin. Just add the first clike compiler that we have and hope |
|
# that it can link these objects |
|
for lang in clike_langs: |
|
if lang in compilers: |
|
self.compilers[lang] = compilers[lang] |
|
break |
|
# If all our sources are Vala, our target also needs the C compiler but |
|
# it won't get added above. |
|
if 'vala' in self.compilers and 'c' not in self.compilers: |
|
self.compilers['c'] = compilers['c'] |
|
|
|
def validate_sources(self): |
|
if not self.sources: |
|
return |
|
for lang in ('cs', 'java'): |
|
if lang in self.compilers: |
|
check_sources = list(self.sources) |
|
compiler = self.compilers[lang] |
|
if not self.can_compile_remove_sources(compiler, check_sources): |
|
m = 'No {} sources found in target {!r}'.format(lang, self.name) |
|
raise InvalidArguments(m) |
|
if check_sources: |
|
m = '{0} targets can only contain {0} files:\n'.format(lang.capitalize()) |
|
m += '\n'.join([repr(c) for c in check_sources]) |
|
raise InvalidArguments(m) |
|
# CSharp and Java targets can't contain any other file types |
|
assert(len(self.compilers) == 1) |
|
return |
|
|
|
def process_link_depends(self, sources, environment): |
|
"""Process the link_depends keyword argument. |
|
|
|
This is designed to handle strings, Files, and the output of Custom |
|
Targets. Notably it doesn't handle generator() returned objects, since |
|
adding them as a link depends would inherently cause them to be |
|
generated twice, since the output needs to be passed to the ld_args and |
|
link_depends. |
|
""" |
|
if not isinstance(sources, list): |
|
sources = [sources] |
|
for s in sources: |
|
if hasattr(s, 'held_object'): |
|
s = s.held_object |
|
|
|
if isinstance(s, File): |
|
self.link_depends.append(s) |
|
elif isinstance(s, str): |
|
self.link_depends.append( |
|
File.from_source_file(environment.source_dir, self.subdir, s)) |
|
elif hasattr(s, 'get_outputs'): |
|
self.link_depends.extend( |
|
[File.from_built_file(s.subdir, p) for p in s.get_outputs()]) |
|
else: |
|
raise InvalidArguments( |
|
'Link_depends arguments must be strings, Files, ' |
|
'or a Custom Target, or lists thereof.') |
|
|
|
def get_original_kwargs(self): |
|
return self.kwargs |
|
|
|
def unpack_holder(self, d): |
|
if not isinstance(d, list): |
|
d = [d] |
|
newd = [] |
|
for i in d: |
|
if isinstance(i, list): |
|
i = self.unpack_holder(i) |
|
elif hasattr(i, 'held_object'): |
|
i = i.held_object |
|
for t in ['dependencies', 'link_with', 'include_directories', 'sources']: |
|
if hasattr(i, t): |
|
setattr(i, t, self.unpack_holder(getattr(i, t))) |
|
newd.append(i) |
|
return newd |
|
|
|
def copy_kwargs(self, kwargs): |
|
self.kwargs = copy.copy(kwargs) |
|
# This sucks quite badly. Arguments |
|
# are holders but they can't be pickled |
|
# so unpack those known. |
|
for k, v in self.kwargs.items(): |
|
if isinstance(v, list): |
|
self.kwargs[k] = self.unpack_holder(v) |
|
if hasattr(v, 'held_object'): |
|
self.kwargs[k] = v.held_object |
|
for t in ['dependencies', 'link_with', 'include_directories', 'sources']: |
|
if t in self.kwargs: |
|
self.kwargs[t] = self.unpack_holder(self.kwargs[t]) |
|
|
|
def extract_objects(self, srclist): |
|
obj_src = [] |
|
for src in srclist: |
|
if not isinstance(src, str): |
|
raise MesonException('Object extraction arguments must be strings.') |
|
src = File(False, self.subdir, src) |
|
if src not in self.sources: |
|
raise MesonException('Tried to extract unknown source %s.' % src) |
|
obj_src.append(src) |
|
return ExtractedObjects(self, obj_src, self.is_unity) |
|
|
|
def extract_all_objects(self): |
|
return ExtractedObjects(self, self.sources, self.is_unity) |
|
|
|
def get_all_link_deps(self): |
|
return self.get_transitive_link_deps() |
|
|
|
def get_transitive_link_deps(self): |
|
result = [] |
|
for i in self.link_targets: |
|
result += i.get_all_link_deps() |
|
return result |
|
|
|
def get_custom_install_dir(self): |
|
return self.install_dir |
|
|
|
def process_kwargs(self, kwargs, environment): |
|
super().process_kwargs(kwargs) |
|
self.copy_kwargs(kwargs) |
|
kwargs.get('modules', []) |
|
self.need_install = kwargs.get('install', self.need_install) |
|
llist = kwargs.get('link_with', []) |
|
if not isinstance(llist, list): |
|
llist = [llist] |
|
for linktarget in llist: |
|
# Sorry for this hack. Keyword targets are kept in holders |
|
# in kwargs. Unpack here without looking at the exact type. |
|
if hasattr(linktarget, "held_object"): |
|
linktarget = linktarget.held_object |
|
self.link(linktarget) |
|
lwhole = kwargs.get('link_whole', []) |
|
if not isinstance(lwhole, list): |
|
lwhole = [lwhole] |
|
for linktarget in lwhole: |
|
# Sorry for this hack. Keyword targets are kept in holders |
|
# in kwargs. Unpack here without looking at the exact type. |
|
if hasattr(linktarget, "held_object"): |
|
linktarget = linktarget.held_object |
|
self.link_whole(linktarget) |
|
c_pchlist = kwargs.get('c_pch', []) |
|
if not isinstance(c_pchlist, list): |
|
c_pchlist = [c_pchlist] |
|
self.add_pch('c', c_pchlist) |
|
cpp_pchlist = kwargs.get('cpp_pch', []) |
|
if not isinstance(cpp_pchlist, list): |
|
cpp_pchlist = [cpp_pchlist] |
|
self.add_pch('cpp', cpp_pchlist) |
|
clist = kwargs.get('c_args', []) |
|
if not isinstance(clist, list): |
|
clist = [clist] |
|
self.add_compiler_args('c', clist) |
|
cpplist = kwargs.get('cpp_args', []) |
|
if not isinstance(cpplist, list): |
|
cpplist = [cpplist] |
|
self.add_compiler_args('cpp', cpplist) |
|
cslist = kwargs.get('cs_args', []) |
|
if not isinstance(cslist, list): |
|
cslist = [cslist] |
|
self.add_compiler_args('cs', cslist) |
|
valalist = kwargs.get('vala_args', []) |
|
if not isinstance(valalist, list): |
|
valalist = [valalist] |
|
self.add_compiler_args('vala', valalist) |
|
objclist = kwargs.get('objc_args', []) |
|
if not isinstance(objclist, list): |
|
objclist = [objclist] |
|
self.add_compiler_args('objc', objclist) |
|
objcpplist = kwargs.get('objcpp_args', []) |
|
if not isinstance(objcpplist, list): |
|
objcpplist = [objcpplist] |
|
self.add_compiler_args('objcpp', objcpplist) |
|
fortranlist = kwargs.get('fortran_args', []) |
|
if not isinstance(fortranlist, list): |
|
fortranlist = [fortranlist] |
|
self.add_compiler_args('fortran', fortranlist) |
|
rustlist = kwargs.get('rust_args', []) |
|
if not isinstance(rustlist, list): |
|
rustlist = [rustlist] |
|
self.add_compiler_args('rust', rustlist) |
|
if not isinstance(self, Executable): |
|
self.vala_header = kwargs.get('vala_header', self.name + '.h') |
|
self.vala_vapi = kwargs.get('vala_vapi', self.name + '.vapi') |
|
self.vala_gir = kwargs.get('vala_gir', None) |
|
dlist = stringlistify(kwargs.get('d_args', [])) |
|
self.add_compiler_args('d', dlist) |
|
self.link_args = flatten(kwargs.get('link_args', [])) |
|
for i in self.link_args: |
|
if not isinstance(i, str): |
|
raise InvalidArguments('Link_args arguments must be strings.') |
|
for l in self.link_args: |
|
if '-Wl,-rpath' in l or l.startswith('-rpath'): |
|
mlog.warning('''Please do not define rpath with a linker argument, use install_rpath or build_rpath properties instead. |
|
This will become a hard error in a future Meson release.''') |
|
self.process_link_depends(kwargs.get('link_depends', []), environment) |
|
# Target-specific include dirs must be added BEFORE include dirs from |
|
# internal deps (added inside self.add_deps()) to override them. |
|
inclist = kwargs.get('include_directories', []) |
|
if not isinstance(inclist, list): |
|
inclist = [inclist] |
|
self.add_include_dirs(inclist) |
|
# Add dependencies (which also have include_directories) |
|
deplist = kwargs.get('dependencies', []) |
|
if not isinstance(deplist, list): |
|
deplist = [deplist] |
|
self.add_deps(deplist) |
|
# If an item in this list is False, the output corresponding to |
|
# the list index of that item will not be installed |
|
self.install_dir = typeslistify(kwargs.get('install_dir', [None]), |
|
(str, bool)) |
|
main_class = kwargs.get('main_class', '') |
|
if not isinstance(main_class, str): |
|
raise InvalidArguments('Main class must be a string') |
|
self.main_class = main_class |
|
if isinstance(self, Executable): |
|
self.gui_app = kwargs.get('gui_app', False) |
|
if not isinstance(self.gui_app, bool): |
|
raise InvalidArguments('Argument gui_app must be boolean.') |
|
elif 'gui_app' in kwargs: |
|
raise InvalidArguments('Argument gui_app can only be used on executables.') |
|
extra_files = kwargs.get('extra_files', []) |
|
if not isinstance(extra_files, list): |
|
extra_files = [extra_files] |
|
for i in extra_files: |
|
assert(isinstance(i, File)) |
|
trial = os.path.join(environment.get_source_dir(), i.subdir, i.fname) |
|
if not(os.path.isfile(trial)): |
|
raise InvalidArguments('Tried to add non-existing extra file %s.' % i) |
|
self.extra_files = extra_files |
|
self.install_rpath = kwargs.get('install_rpath', '') |
|
if not isinstance(self.install_rpath, str): |
|
raise InvalidArguments('Install_rpath is not a string.') |
|
self.build_rpath = kwargs.get('build_rpath', '') |
|
if not isinstance(self.build_rpath, str): |
|
raise InvalidArguments('Build_rpath is not a string.') |
|
resources = kwargs.get('resources', []) |
|
if not isinstance(resources, list): |
|
resources = [resources] |
|
for r in resources: |
|
if not isinstance(r, str): |
|
raise InvalidArguments('Resource argument is not a string.') |
|
trial = os.path.join(environment.get_source_dir(), self.subdir, r) |
|
if not os.path.isfile(trial): |
|
raise InvalidArguments('Tried to add non-existing resource %s.' % r) |
|
self.resources = resources |
|
if 'name_prefix' in kwargs: |
|
name_prefix = kwargs['name_prefix'] |
|
if isinstance(name_prefix, list): |
|
if name_prefix: |
|
raise InvalidArguments('name_prefix array must be empty to signify null.') |
|
elif not isinstance(name_prefix, str): |
|
raise InvalidArguments('name_prefix must be a string.') |
|
self.prefix = name_prefix |
|
self.name_prefix_set = True |
|
if 'name_suffix' in kwargs: |
|
name_suffix = kwargs['name_suffix'] |
|
if isinstance(name_suffix, list): |
|
if name_suffix: |
|
raise InvalidArguments('name_suffix array must be empty to signify null.') |
|
else: |
|
if not isinstance(name_suffix, str): |
|
raise InvalidArguments('name_suffix must be a string.') |
|
self.suffix = name_suffix |
|
self.name_suffix_set = True |
|
if isinstance(self, StaticLibrary): |
|
# You can't disable PIC on OS X. The compiler ignores -fno-PIC. |
|
# PIC is always on for Windows (all code is position-independent |
|
# since library loading is done differently) |
|
if for_darwin(self.is_cross, self.environment) or for_windows(self.is_cross, self.environment): |
|
self.pic = True |
|
elif '-fPIC' in clist + cpplist: |
|
mlog.warning("Use the 'pic' kwarg instead of passing -fPIC manually to static library {!r}".format(self.name)) |
|
self.pic = True |
|
else: |
|
self.pic = kwargs.get('pic', False) |
|
if not isinstance(self.pic, bool): |
|
raise InvalidArguments('Argument pic to static library {!r} must be boolean'.format(self.name)) |
|
|
|
def get_filename(self): |
|
return self.filename |
|
|
|
def get_outputs(self): |
|
return self.outputs |
|
|
|
def get_extra_args(self, language): |
|
return self.extra_args.get(language, []) |
|
|
|
def get_dependencies(self): |
|
transitive_deps = [] |
|
for t in self.link_targets + self.link_whole_targets: |
|
transitive_deps.append(t) |
|
if isinstance(t, StaticLibrary): |
|
transitive_deps += t.get_dependencies() |
|
return transitive_deps |
|
|
|
def get_source_subdir(self): |
|
return self.subdir |
|
|
|
def get_sources(self): |
|
return self.sources |
|
|
|
def get_objects(self): |
|
return self.objects |
|
|
|
def get_generated_sources(self): |
|
return self.generated |
|
|
|
def should_install(self): |
|
return self.need_install |
|
|
|
def has_pch(self): |
|
return len(self.pch) > 0 |
|
|
|
def get_pch(self, language): |
|
try: |
|
return self.pch[language] |
|
except KeyError: |
|
return[] |
|
|
|
def get_include_dirs(self): |
|
return self.include_dirs |
|
|
|
def add_deps(self, deps): |
|
if not isinstance(deps, list): |
|
deps = [deps] |
|
for dep in deps: |
|
if hasattr(dep, 'held_object'): |
|
dep = dep.held_object |
|
if isinstance(dep, dependencies.InternalDependency): |
|
# Those parts that are internal. |
|
self.process_sourcelist(dep.sources) |
|
self.add_include_dirs(dep.include_directories) |
|
for l in dep.libraries: |
|
self.link(l) |
|
# Those parts that are external. |
|
extpart = dependencies.InternalDependency('undefined', |
|
[], |
|
dep.compile_args, |
|
dep.link_args, |
|
[], [], []) |
|
self.external_deps.append(extpart) |
|
# Deps of deps. |
|
self.add_deps(dep.ext_deps) |
|
elif isinstance(dep, dependencies.ExternalDependency): |
|
self.external_deps.append(dep) |
|
self.process_sourcelist(dep.get_sources()) |
|
elif isinstance(dep, BuildTarget): |
|
raise InvalidArguments('''Tried to use a build target as a dependency. |
|
You probably should put it in link_with instead.''') |
|
else: |
|
# This is a bit of a hack. We do not want Build to know anything |
|
# about the interpreter so we can't import it and use isinstance. |
|
# This should be reliable enough. |
|
if hasattr(dep, 'project_args_frozen') or hasattr(dep, 'global_args_frozen'): |
|
raise InvalidArguments('Tried to use subproject object as a dependency.\n' |
|
'You probably wanted to use a dependency declared in it instead.\n' |
|
'Access it by calling get_variable() on the subproject object.') |
|
raise InvalidArguments('Argument is of an unacceptable type {!r}.\nMust be ' |
|
'either an external dependency (returned by find_library() or ' |
|
'dependency()) or an internal dependency (returned by ' |
|
'declare_dependency()).'.format(type(dep).__name__)) |
|
|
|
def get_external_deps(self): |
|
return self.external_deps |
|
|
|
def link(self, target): |
|
for t in flatten(target): |
|
if hasattr(t, 'held_object'): |
|
t = t.held_object |
|
if not t.is_linkable_target(): |
|
raise InvalidArguments('Link target {!r} is not linkable.'.format(t)) |
|
if isinstance(self, SharedLibrary) and isinstance(t, StaticLibrary) and not t.pic: |
|
msg = "Can't link non-PIC static library {!r} into shared library {!r}. ".format(t.name, self.name) |
|
msg += "Use the 'pic' option to static_library to build with PIC." |
|
raise InvalidArguments(msg) |
|
if self.is_cross != t.is_cross: |
|
raise InvalidArguments('Tried to mix cross built and native libraries in target {!r}'.format(self.name)) |
|
self.link_targets.append(t) |
|
|
|
def link_whole(self, target): |
|
for t in flatten(target): |
|
if hasattr(t, 'held_object'): |
|
t = t.held_object |
|
if not isinstance(t, StaticLibrary): |
|
raise InvalidArguments('{!r} is not a static library.'.format(t)) |
|
if isinstance(self, SharedLibrary) and not t.pic: |
|
msg = "Can't link non-PIC static library {!r} into shared library {!r}. ".format(t.name, self.name) |
|
msg += "Use the 'pic' option to static_library to build with PIC." |
|
raise InvalidArguments(msg) |
|
if self.is_cross != t.is_cross: |
|
raise InvalidArguments('Tried to mix cross built and native libraries in target {!r}'.format(self.name)) |
|
self.link_whole_targets.append(t) |
|
|
|
def add_pch(self, language, pchlist): |
|
if not pchlist: |
|
return |
|
elif len(pchlist) == 1: |
|
if not environment.is_header(pchlist[0]): |
|
raise InvalidArguments('PCH argument %s is not a header.' % pchlist[0]) |
|
elif len(pchlist) == 2: |
|
if environment.is_header(pchlist[0]): |
|
if not environment.is_source(pchlist[1]): |
|
raise InvalidArguments('PCH definition must contain one header and at most one source.') |
|
elif environment.is_source(pchlist[0]): |
|
if not environment.is_header(pchlist[1]): |
|
raise InvalidArguments('PCH definition must contain one header and at most one source.') |
|
pchlist = [pchlist[1], pchlist[0]] |
|
else: |
|
raise InvalidArguments('PCH argument %s is of unknown type.' % pchlist[0]) |
|
elif len(pchlist) > 2: |
|
raise InvalidArguments('PCH definition may have a maximum of 2 files.') |
|
self.pch[language] = pchlist |
|
|
|
def add_include_dirs(self, args): |
|
ids = [] |
|
for a in args: |
|
# FIXME same hack, forcibly unpack from holder. |
|
if hasattr(a, 'held_object'): |
|
a = a.held_object |
|
if not isinstance(a, IncludeDirs): |
|
raise InvalidArguments('Include directory to be added is not an include directory object.') |
|
ids.append(a) |
|
self.include_dirs += ids |
|
|
|
def add_compiler_args(self, language, args): |
|
args = flatten(args) |
|
for a in args: |
|
if not isinstance(a, (str, File)): |
|
raise InvalidArguments('A non-string passed to compiler args.') |
|
if language in self.extra_args: |
|
self.extra_args[language] += args |
|
else: |
|
self.extra_args[language] = args |
|
|
|
def get_aliases(self): |
|
return {} |
|
|
|
def get_langs_used_by_deps(self): |
|
''' |
|
Sometimes you want to link to a C++ library that exports C API, which |
|
means the linker must link in the C++ stdlib, and we must use a C++ |
|
compiler for linking. The same is also applicable for objc/objc++, etc, |
|
so we can keep using clike_langs for the priority order. |
|
|
|
See: https://github.com/mesonbuild/meson/issues/1653 |
|
''' |
|
langs = [] |
|
# Check if any of the external libraries were written in this language |
|
for dep in self.external_deps: |
|
if dep.language not in langs: |
|
langs.append(dep.language) |
|
# Check if any of the internal libraries this target links to were |
|
# written in this language |
|
for link_target in self.link_targets: |
|
for language in link_target.compilers: |
|
if language not in langs: |
|
langs.append(language) |
|
return langs |
|
|
|
def get_clike_dynamic_linker(self): |
|
''' |
|
We use the order of languages in `clike_langs` to determine which |
|
linker to use in case the target has sources compiled with multiple |
|
compilers. All languages other than those in this list have their own |
|
linker. |
|
Note that Vala outputs C code, so Vala sources can use any linker |
|
that can link compiled C. We don't actually need to add an exception |
|
for Vala here because of that. |
|
''' |
|
# Populate list of all compilers, not just those being used to compile |
|
# sources in this target |
|
if self.is_cross: |
|
all_compilers = self.environment.coredata.cross_compilers |
|
else: |
|
all_compilers = self.environment.coredata.compilers |
|
# Languages used by dependencies |
|
dep_langs = self.get_langs_used_by_deps() |
|
# Pick a compiler based on the language priority-order |
|
for l in clike_langs: |
|
if l in self.compilers or l in dep_langs: |
|
try: |
|
return all_compilers[l] |
|
except KeyError: |
|
raise MesonException( |
|
'Could not get a dynamic linker for build target {!r}. ' |
|
'Requires a linker for language "{}", but that is not ' |
|
'a project language.'.format(self.name, l)) |
|
|
|
m = 'Could not get a dynamic linker for build target {!r}' |
|
raise AssertionError(m.format(self.name)) |
|
|
|
def get_using_msvc(self): |
|
''' |
|
Check if the dynamic linker is MSVC. Used by Executable, StaticLibrary, |
|
and SharedLibrary for deciding when to use MSVC-specific file naming |
|
and debug filenames. |
|
|
|
If at least some code is built with MSVC and the final library is |
|
linked with MSVC, we can be sure that some debug info will be |
|
generated. We only check the dynamic linker here because the static |
|
linker is guaranteed to be of the same type. |
|
|
|
Interesting cases: |
|
1. The Vala compiler outputs C code to be compiled by whatever |
|
C compiler we're using, so all objects will still be created by the |
|
MSVC compiler. |
|
2. If the target contains only objects, process_compilers guesses and |
|
picks the first compiler that smells right. |
|
''' |
|
linker = self.get_clike_dynamic_linker() |
|
if linker and linker.get_id() == 'msvc': |
|
return True |
|
return False |
|
|
|
def is_linkable_target(self): |
|
return False |
|
|
|
|
|
class Generator: |
|
def __init__(self, args, kwargs): |
|
if len(args) != 1: |
|
raise InvalidArguments('Generator requires exactly one positional argument: the executable') |
|
exe = args[0] |
|
if hasattr(exe, 'held_object'): |
|
exe = exe.held_object |
|
if not isinstance(exe, (Executable, dependencies.ExternalProgram)): |
|
raise InvalidArguments('First generator argument must be an executable.') |
|
self.exe = exe |
|
self.depfile = None |
|
self.process_kwargs(kwargs) |
|
|
|
def __repr__(self): |
|
repr_str = "<{0}: {1}>" |
|
return repr_str.format(self.__class__.__name__, self.exe) |
|
|
|
def get_exe(self): |
|
return self.exe |
|
|
|
def process_kwargs(self, kwargs): |
|
if 'arguments' not in kwargs: |
|
raise InvalidArguments('Generator must have "arguments" keyword argument.') |
|
args = kwargs['arguments'] |
|
if isinstance(args, str): |
|
args = [args] |
|
if not isinstance(args, list): |
|
raise InvalidArguments('"Arguments" keyword argument must be a string or a list of strings.') |
|
for a in args: |
|
if not isinstance(a, str): |
|
raise InvalidArguments('A non-string object in "arguments" keyword argument.') |
|
self.arglist = args |
|
if 'output' not in kwargs: |
|
raise InvalidArguments('Generator must have "output" keyword argument.') |
|
outputs = kwargs['output'] |
|
if not isinstance(outputs, list): |
|
outputs = [outputs] |
|
for rule in outputs: |
|
if not isinstance(rule, str): |
|
raise InvalidArguments('"output" may only contain strings.') |
|
if '@BASENAME@' not in rule and '@PLAINNAME@' not in rule: |
|
raise InvalidArguments('Every element of "output" must contain @BASENAME@ or @PLAINNAME@.') |
|
if '/' in rule or '\\' in rule: |
|
raise InvalidArguments('"outputs" must not contain a directory separator.') |
|
if len(outputs) > 1: |
|
for o in outputs: |
|
if '@OUTPUT@' in o: |
|
raise InvalidArguments('Tried to use @OUTPUT@ in a rule with more than one output.') |
|
self.outputs = outputs |
|
if 'depfile' in kwargs: |
|
depfile = kwargs['depfile'] |
|
if not isinstance(depfile, str): |
|
raise InvalidArguments('Depfile must be a string.') |
|
if os.path.split(depfile)[1] != depfile: |
|
raise InvalidArguments('Depfile must be a plain filename without a subdirectory.') |
|
self.depfile = depfile |
|
|
|
def get_base_outnames(self, inname): |
|
plainname = os.path.split(inname)[1] |
|
basename = os.path.splitext(plainname)[0] |
|
return [x.replace('@BASENAME@', basename).replace('@PLAINNAME@', plainname) for x in self.outputs] |
|
|
|
def get_dep_outname(self, inname): |
|
if self.depfile is None: |
|
raise InvalidArguments('Tried to get dep name for rule that does not have dependency file defined.') |
|
plainname = os.path.split(inname)[1] |
|
basename = os.path.splitext(plainname)[0] |
|
return self.depfile.replace('@BASENAME@', basename).replace('@PLAINNAME@', plainname) |
|
|
|
def get_arglist(self): |
|
return self.arglist |
|
|
|
def process_files(self, name, files, state, extra_args=[]): |
|
output = GeneratedList(self, extra_args=extra_args) |
|
for f in files: |
|
if isinstance(f, str): |
|
f = File.from_source_file(state.environment.source_dir, state.subdir, f) |
|
elif not isinstance(f, File): |
|
raise InvalidArguments('{} arguments must be strings or files not {!r}.'.format(name, f)) |
|
output.add_file(f) |
|
return output |
|
|
|
|
|
class GeneratedList: |
|
def __init__(self, generator, extra_args=[]): |
|
if hasattr(generator, 'held_object'): |
|
generator = generator.held_object |
|
self.generator = generator |
|
self.name = self.generator.exe |
|
self.infilelist = [] |
|
self.outfilelist = [] |
|
self.outmap = {} |
|
self.extra_depends = [] |
|
self.extra_args = extra_args |
|
|
|
def add_file(self, newfile): |
|
self.infilelist.append(newfile) |
|
outfiles = self.generator.get_base_outnames(newfile.fname) |
|
self.outfilelist += outfiles |
|
self.outmap[newfile] = outfiles |
|
|
|
def get_inputs(self): |
|
return self.infilelist |
|
|
|
def get_outputs(self): |
|
return self.outfilelist |
|
|
|
def get_outputs_for(self, filename): |
|
return self.outmap[filename] |
|
|
|
def get_generator(self): |
|
return self.generator |
|
|
|
def get_extra_args(self): |
|
return self.extra_args |
|
|
|
class Executable(BuildTarget): |
|
def __init__(self, name, subdir, subproject, is_cross, sources, objects, environment, kwargs): |
|
super().__init__(name, subdir, subproject, is_cross, sources, objects, environment, kwargs) |
|
# Unless overriden, executables have no suffix or prefix. Except on |
|
# Windows and with C#/Mono executables where the suffix is 'exe' |
|
if not hasattr(self, 'prefix'): |
|
self.prefix = '' |
|
if not hasattr(self, 'suffix'): |
|
# Executable for Windows or C#/Mono |
|
if (for_windows(is_cross, environment) or |
|
for_cygwin(is_cross, environment) or 'cs' in self.compilers): |
|
self.suffix = 'exe' |
|
else: |
|
self.suffix = '' |
|
self.filename = self.name |
|
if self.suffix: |
|
self.filename += '.' + self.suffix |
|
self.outputs = [self.filename] |
|
|
|
# The import library this target will generate |
|
self.import_filename = None |
|
# The import library that Visual Studio would generate (and accept) |
|
self.vs_import_filename = None |
|
# The import library that GCC would generate (and prefer) |
|
self.gcc_import_filename = None |
|
|
|
# if implib appears, this target is linkwith:-able, but that only means |
|
# something on Windows platforms. |
|
self.is_linkwithable = False |
|
if 'implib' in kwargs and kwargs['implib']: |
|
implib_basename = self.name + '.exe' |
|
if not isinstance(kwargs['implib'], bool): |
|
implib_basename = kwargs['implib'] |
|
self.is_linkwithable = True |
|
if for_windows(is_cross, environment) or for_cygwin(is_cross, environment): |
|
self.vs_import_filename = '{0}.lib'.format(implib_basename) |
|
self.gcc_import_filename = 'lib{0}.a'.format(implib_basename) |
|
|
|
if self.get_using_msvc(): |
|
self.import_filename = self.vs_import_filename |
|
else: |
|
self.import_filename = self.gcc_import_filename |
|
|
|
def type_suffix(self): |
|
return "@exe" |
|
|
|
def check_unknown_kwargs(self, kwargs): |
|
self.check_unknown_kwargs_int(kwargs, known_exe_kwargs) |
|
|
|
def get_import_filename(self): |
|
""" |
|
The name of the import library that will be outputted by the compiler |
|
|
|
Returns None if there is no import library required for this platform |
|
""" |
|
return self.import_filename |
|
|
|
def get_import_filenameslist(self): |
|
if self.import_filename: |
|
return [self.vs_import_filename, self.gcc_import_filename] |
|
return [] |
|
|
|
def is_linkable_target(self): |
|
return self.is_linkwithable |
|
|
|
class StaticLibrary(BuildTarget): |
|
def __init__(self, name, subdir, subproject, is_cross, sources, objects, environment, kwargs): |
|
if 'pic' not in kwargs and 'b_staticpic' in environment.coredata.base_options: |
|
kwargs['pic'] = environment.coredata.base_options['b_staticpic'].value |
|
super().__init__(name, subdir, subproject, is_cross, sources, objects, environment, kwargs) |
|
if 'cs' in self.compilers: |
|
raise InvalidArguments('Static libraries not supported for C#.') |
|
if 'rust' in self.compilers: |
|
# If no crate type is specified, or it's the generic lib type, use rlib |
|
if not hasattr(self, 'rust_crate_type') or self.rust_crate_type == 'lib': |
|
mlog.debug('Defaulting Rust static library target crate type to rlib') |
|
self.rust_crate_type = 'rlib' |
|
# Don't let configuration proceed with a non-static crate type |
|
elif self.rust_crate_type not in ['rlib', 'staticlib']: |
|
raise InvalidArguments('Crate type "{0}" invalid for static libraries; must be "rlib" or "staticlib"'.format(self.rust_crate_type)) |
|
# By default a static library is named libfoo.a even on Windows because |
|
# MSVC does not have a consistent convention for what static libraries |
|
# are called. The MSVC CRT uses libfoo.lib syntax but nothing else uses |
|
# it and GCC only looks for static libraries called foo.lib and |
|
# libfoo.a. However, we cannot use foo.lib because that's the same as |
|
# the import library. Using libfoo.a is ok because people using MSVC |
|
# always pass the library filename while linking anyway. |
|
if not hasattr(self, 'prefix'): |
|
self.prefix = 'lib' |
|
if not hasattr(self, 'suffix'): |
|
if 'rust' in self.compilers: |
|
if not hasattr(self, 'rust_crate_type') or self.rust_crate_type == 'rlib': |
|
# default Rust static library suffix |
|
self.suffix = 'rlib' |
|
elif self.rust_crate_type == 'staticlib': |
|
self.suffix = 'a' |
|
else: |
|
self.suffix = 'a' |
|
self.filename = self.prefix + self.name + '.' + self.suffix |
|
self.outputs = [self.filename] |
|
|
|
def type_suffix(self): |
|
return "@sta" |
|
|
|
def check_unknown_kwargs(self, kwargs): |
|
self.check_unknown_kwargs_int(kwargs, known_lib_kwargs) |
|
|
|
def process_kwargs(self, kwargs, environment): |
|
super().process_kwargs(kwargs, environment) |
|
if 'rust_crate_type' in kwargs: |
|
rust_crate_type = kwargs['rust_crate_type'] |
|
if isinstance(rust_crate_type, str): |
|
self.rust_crate_type = rust_crate_type |
|
else: |
|
raise InvalidArguments('Invalid rust_crate_type "{0}": must be a string.'.format(rust_crate_type)) |
|
|
|
def is_linkable_target(self): |
|
return True |
|
|
|
class SharedLibrary(BuildTarget): |
|
def __init__(self, name, subdir, subproject, is_cross, sources, objects, environment, kwargs): |
|
self.soversion = None |
|
self.ltversion = None |
|
self.vs_module_defs = None |
|
# The import library this target will generate |
|
self.import_filename = None |
|
# The import library that Visual Studio would generate (and accept) |
|
self.vs_import_filename = None |
|
# The import library that GCC would generate (and prefer) |
|
self.gcc_import_filename = None |
|
super().__init__(name, subdir, subproject, is_cross, sources, objects, environment, kwargs) |
|
if 'rust' in self.compilers: |
|
# If no crate type is specified, or it's the generic lib type, use dylib |
|
if not hasattr(self, 'rust_crate_type') or self.rust_crate_type == 'lib': |
|
mlog.debug('Defaulting Rust dynamic library target crate type to "dylib"') |
|
self.rust_crate_type = 'dylib' |
|
# Don't let configuration proceed with a non-dynamic crate type |
|
elif self.rust_crate_type not in ['dylib', 'cdylib']: |
|
raise InvalidArguments('Crate type "{0}" invalid for dynamic libraries; must be "dylib" or "cdylib"'.format(self.rust_crate_type)) |
|
if not hasattr(self, 'prefix'): |
|
self.prefix = None |
|
if not hasattr(self, 'suffix'): |
|
self.suffix = None |
|
self.basic_filename_tpl = '{0.prefix}{0.name}.{0.suffix}' |
|
self.determine_filenames(is_cross, environment) |
|
|
|
def determine_filenames(self, is_cross, env): |
|
""" |
|
See https://github.com/mesonbuild/meson/pull/417 for details. |
|
|
|
First we determine the filename template (self.filename_tpl), then we |
|
set the output filename (self.filename). |
|
|
|
The template is needed while creating aliases (self.get_aliases), |
|
which are needed while generating .so shared libraries for Linux. |
|
|
|
Besides this, there's also the import library name, which is only used |
|
on Windows since on that platform the linker uses a separate library |
|
called the "import library" during linking instead of the shared |
|
library (DLL). The toolchain will output an import library in one of |
|
two formats: GCC or Visual Studio. |
|
|
|
When we're building with Visual Studio, the import library that will be |
|
generated by the toolchain is self.vs_import_filename, and with |
|
MinGW/GCC, it's self.gcc_import_filename. self.import_filename will |
|
always contain the import library name this target will generate. |
|
""" |
|
prefix = '' |
|
suffix = '' |
|
self.filename_tpl = self.basic_filename_tpl |
|
# If the user already provided the prefix and suffix to us, we don't |
|
# need to do any filename suffix/prefix detection. |
|
# NOTE: manual prefix/suffix override is currently only tested for C/C++ |
|
if self.prefix is not None and self.suffix is not None: |
|
pass |
|
# C# and Mono |
|
elif 'cs' in self.compilers: |
|
prefix = '' |
|
suffix = 'dll' |
|
self.filename_tpl = '{0.prefix}{0.name}.{0.suffix}' |
|
# C, C++, Swift, Vala |
|
# Only Windows uses a separate import library for linking |
|
# For all other targets/platforms import_filename stays None |
|
elif for_windows(is_cross, env): |
|
suffix = 'dll' |
|
self.vs_import_filename = '{0}.lib'.format(self.name) |
|
self.gcc_import_filename = 'lib{0}.dll.a'.format(self.name) |
|
if self.get_using_msvc(): |
|
# Shared library is of the form foo.dll |
|
prefix = '' |
|
# Import library is called foo.lib |
|
self.import_filename = self.vs_import_filename |
|
# Assume GCC-compatible naming |
|
else: |
|
# Shared library is of the form libfoo.dll |
|
prefix = 'lib' |
|
# Import library is called libfoo.dll.a |
|
self.import_filename = self.gcc_import_filename |
|
# Shared library has the soversion if it is defined |
|
if self.soversion: |
|
self.filename_tpl = '{0.prefix}{0.name}-{0.soversion}.{0.suffix}' |
|
else: |
|
self.filename_tpl = '{0.prefix}{0.name}.{0.suffix}' |
|
elif for_cygwin(is_cross, env): |
|
suffix = 'dll' |
|
self.gcc_import_filename = 'lib{0}.dll.a'.format(self.name) |
|
# Shared library is of the form cygfoo.dll |
|
# (ld --dll-search-prefix=cyg is the default) |
|
prefix = 'cyg' |
|
# Import library is called libfoo.dll.a |
|
self.import_filename = self.gcc_import_filename |
|
if self.soversion: |
|
self.filename_tpl = '{0.prefix}{0.name}-{0.soversion}.{0.suffix}' |
|
else: |
|
self.filename_tpl = '{0.prefix}{0.name}.{0.suffix}' |
|
elif for_darwin(is_cross, env): |
|
prefix = 'lib' |
|
suffix = 'dylib' |
|
# On macOS, the filename can only contain the major version |
|
if self.soversion: |
|
# libfoo.X.dylib |
|
self.filename_tpl = '{0.prefix}{0.name}.{0.soversion}.{0.suffix}' |
|
else: |
|
# libfoo.dylib |
|
self.filename_tpl = '{0.prefix}{0.name}.{0.suffix}' |
|
else: |
|
prefix = 'lib' |
|
suffix = 'so' |
|
if self.ltversion: |
|
# libfoo.so.X[.Y[.Z]] (.Y and .Z are optional) |
|
self.filename_tpl = '{0.prefix}{0.name}.{0.suffix}.{0.ltversion}' |
|
elif self.soversion: |
|
# libfoo.so.X |
|
self.filename_tpl = '{0.prefix}{0.name}.{0.suffix}.{0.soversion}' |
|
else: |
|
# No versioning, libfoo.so |
|
self.filename_tpl = '{0.prefix}{0.name}.{0.suffix}' |
|
if self.prefix is None: |
|
self.prefix = prefix |
|
if self.suffix is None: |
|
self.suffix = suffix |
|
self.filename = self.filename_tpl.format(self) |
|
self.outputs = [self.filename] |
|
|
|
def process_kwargs(self, kwargs, environment): |
|
super().process_kwargs(kwargs, environment) |
|
# Shared library version |
|
if 'version' in kwargs: |
|
self.ltversion = kwargs['version'] |
|
if not isinstance(self.ltversion, str): |
|
raise InvalidArguments('Shared library version needs to be a string, not ' + type(self.ltversion).__name__) |
|
if not re.fullmatch(r'[0-9]+(\.[0-9]+){0,2}', self.ltversion): |
|
raise InvalidArguments('Invalid Shared library version "{0}". Must be of the form X.Y.Z where all three are numbers. Y and Z are optional.'.format(self.ltversion)) |
|
# Try to extract/deduce the soversion |
|
if 'soversion' in kwargs: |
|
self.soversion = kwargs['soversion'] |
|
if isinstance(self.soversion, int): |
|
self.soversion = str(self.soversion) |
|
if not isinstance(self.soversion, str): |
|
raise InvalidArguments('Shared library soversion is not a string or integer.') |
|
elif self.ltversion: |
|
# library version is defined, get the soversion from that |
|
# We replicate what Autotools does here and take the first |
|
# number of the version by default. |
|
self.soversion = self.ltversion.split('.')[0] |
|
# Visual Studio module-definitions file |
|
if 'vs_module_defs' in kwargs: |
|
path = kwargs['vs_module_defs'] |
|
if hasattr(path, 'held_object'): |
|
path = path.held_object |
|
if isinstance(path, str): |
|
if os.path.isabs(path): |
|
self.vs_module_defs = File.from_absolute_file(path) |
|
else: |
|
self.vs_module_defs = File.from_source_file(environment.source_dir, self.subdir, path) |
|
self.link_depends.append(self.vs_module_defs) |
|
elif isinstance(path, File): |
|
# When passing a generated file. |
|
self.vs_module_defs = path |
|
self.link_depends.append(path) |
|
elif hasattr(path, 'get_filename'): |
|
# When passing output of a Custom Target |
|
path = File.from_built_file(path.subdir, path.get_filename()) |
|
self.vs_module_defs = path |
|
self.link_depends.append(path) |
|
else: |
|
raise InvalidArguments( |
|
'Shared library vs_module_defs must be either a string, ' |
|
'a file object or a Custom Target') |
|
if 'rust_crate_type' in kwargs: |
|
rust_crate_type = kwargs['rust_crate_type'] |
|
if isinstance(rust_crate_type, str): |
|
self.rust_crate_type = rust_crate_type |
|
else: |
|
raise InvalidArguments('Invalid rust_crate_type "{0}": must be a string.'.format(rust_crate_type)) |
|
|
|
def check_unknown_kwargs(self, kwargs): |
|
self.check_unknown_kwargs_int(kwargs, known_lib_kwargs) |
|
|
|
def get_import_filename(self): |
|
""" |
|
The name of the import library that will be outputted by the compiler |
|
|
|
Returns None if there is no import library required for this platform |
|
""" |
|
return self.import_filename |
|
|
|
def get_import_filenameslist(self): |
|
if self.import_filename: |
|
return [self.vs_import_filename, self.gcc_import_filename] |
|
return [] |
|
|
|
def get_all_link_deps(self): |
|
return [self] + self.get_transitive_link_deps() |
|
|
|
def get_aliases(self): |
|
""" |
|
If the versioned library name is libfoo.so.0.100.0, aliases are: |
|
* libfoo.so.0 (soversion) -> libfoo.so.0.100.0 |
|
* libfoo.so (unversioned; for linking) -> libfoo.so.0 |
|
Same for dylib: |
|
* libfoo.dylib (unversioned; for linking) -> libfoo.0.dylib |
|
""" |
|
aliases = {} |
|
# Aliases are only useful with .so and .dylib libraries. Also if |
|
# there's no self.soversion (no versioning), we don't need aliases. |
|
if self.suffix not in ('so', 'dylib') or not self.soversion: |
|
return {} |
|
# With .so libraries, the minor and micro versions are also in the |
|
# filename. If ltversion != soversion we create an soversion alias: |
|
# libfoo.so.0 -> libfoo.so.0.100.0 |
|
# Where libfoo.so.0.100.0 is the actual library |
|
if self.suffix == 'so' and self.ltversion and self.ltversion != self.soversion: |
|
alias_tpl = self.filename_tpl.replace('ltversion', 'soversion') |
|
ltversion_filename = alias_tpl.format(self) |
|
aliases[ltversion_filename] = self.filename |
|
# libfoo.so.0/libfoo.0.dylib is the actual library |
|
else: |
|
ltversion_filename = self.filename |
|
# Unversioned alias: |
|
# libfoo.so -> libfoo.so.0 |
|
# libfoo.dylib -> libfoo.0.dylib |
|
aliases[self.basic_filename_tpl.format(self)] = ltversion_filename |
|
return aliases |
|
|
|
def type_suffix(self): |
|
return "@sha" |
|
|
|
def is_linkable_target(self): |
|
return True |
|
|
|
# A shared library that is meant to be used with dlopen rather than linking |
|
# into something else. |
|
class SharedModule(SharedLibrary): |
|
def __init__(self, name, subdir, subproject, is_cross, sources, objects, environment, kwargs): |
|
if 'version' in kwargs: |
|
raise MesonException('Shared modules must not specify the version kwarg.') |
|
if 'soversion' in kwargs: |
|
raise MesonException('Shared modules must not specify the soversion kwarg.') |
|
super().__init__(name, subdir, subproject, is_cross, sources, objects, environment, kwargs) |
|
self.import_filename = None |
|
|
|
class CustomTarget(Target): |
|
known_kwargs = {'input': True, |
|
'output': True, |
|
'command': True, |
|
'capture': False, |
|
'install': True, |
|
'install_dir': True, |
|
'build_always': True, |
|
'depends': True, |
|
'depend_files': True, |
|
'depfile': True, |
|
'build_by_default': True, |
|
'override_options': True, |
|
} |
|
|
|
def __init__(self, name, subdir, kwargs, absolute_paths=False): |
|
super().__init__(name, subdir, False) |
|
self.dependencies = [] |
|
self.extra_depends = [] |
|
self.depend_files = [] # Files that this target depends on but are not on the command line. |
|
self.depfile = None |
|
self.process_kwargs(kwargs) |
|
self.extra_files = [] |
|
# Whether to use absolute paths for all files on the commandline |
|
self.absolute_paths = absolute_paths |
|
unknowns = [] |
|
for k in kwargs: |
|
if k not in CustomTarget.known_kwargs: |
|
unknowns.append(k) |
|
if len(unknowns) > 0: |
|
mlog.warning('Unknown keyword arguments in target %s: %s' % |
|
(self.name, ', '.join(unknowns))) |
|
|
|
def __lt__(self, other): |
|
return self.get_id() < other.get_id() |
|
|
|
def __repr__(self): |
|
repr_str = "<{0} {1}: {2}>" |
|
return repr_str.format(self.__class__.__name__, self.get_id(), self.command) |
|
|
|
def get_id(self): |
|
return self.name + self.type_suffix() |
|
|
|
def get_target_dependencies(self): |
|
deps = self.dependencies[:] |
|
deps += self.extra_depends |
|
for c in self.sources: |
|
if hasattr(c, 'held_object'): |
|
c = c.held_object |
|
if isinstance(c, (BuildTarget, CustomTarget)): |
|
deps.append(c) |
|
return deps |
|
|
|
def flatten_command(self, cmd): |
|
if not isinstance(cmd, list): |
|
cmd = [cmd] |
|
final_cmd = [] |
|
for c in cmd: |
|
if hasattr(c, 'held_object'): |
|
c = c.held_object |
|
if isinstance(c, str): |
|
final_cmd.append(c) |
|
elif isinstance(c, File): |
|
self.depend_files.append(c) |
|
final_cmd.append(c) |
|
elif isinstance(c, dependencies.ExternalProgram): |
|
if not c.found(): |
|
m = 'Tried to use not-found external program {!r} in "command"' |
|
raise InvalidArguments(m.format(c.name)) |
|
self.depend_files.append(File.from_absolute_file(c.get_path())) |
|
final_cmd += c.get_command() |
|
elif isinstance(c, (BuildTarget, CustomTarget)): |
|
self.dependencies.append(c) |
|
final_cmd.append(c) |
|
elif isinstance(c, list): |
|
final_cmd += self.flatten_command(c) |
|
else: |
|
raise InvalidArguments('Argument {!r} in "command" is invalid'.format(c)) |
|
return final_cmd |
|
|
|
def process_kwargs(self, kwargs): |
|
super().process_kwargs(kwargs) |
|
sources = flatten(kwargs.get('input', [])) |
|
self.sources = [] |
|
for s in sources: |
|
if hasattr(s, 'held_object'): |
|
s = s.held_object |
|
self.sources.append(s) |
|
if 'output' not in kwargs: |
|
raise InvalidArguments('Missing keyword argument "output".') |
|
self.outputs = kwargs['output'] |
|
if not isinstance(self.outputs, list): |
|
self.outputs = [self.outputs] |
|
# This will substitute values from the input into output and return it. |
|
inputs = get_sources_string_names(self.sources) |
|
values = get_filenames_templates_dict(inputs, []) |
|
for i in self.outputs: |
|
if not(isinstance(i, str)): |
|
raise InvalidArguments('Output argument not a string.') |
|
if '/' in i: |
|
raise InvalidArguments('Output must not contain a path segment.') |
|
if '@INPUT@' in i or '@INPUT0@' in i: |
|
m = 'Output cannot contain @INPUT@ or @INPUT0@, did you ' \ |
|
'mean @PLAINNAME@ or @BASENAME@?' |
|
raise InvalidArguments(m) |
|
# We already check this during substitution, but the error message |
|
# will be unclear/confusing, so check it here. |
|
if len(inputs) != 1 and ('@PLAINNAME@' in i or '@BASENAME@' in i): |
|
m = "Output cannot contain @PLAINNAME@ or @BASENAME@ when " \ |
|
"there is more than one input (we can't know which to use)" |
|
raise InvalidArguments(m) |
|
self.outputs = substitute_values(self.outputs, values) |
|
self.capture = kwargs.get('capture', False) |
|
if self.capture and len(self.outputs) != 1: |
|
raise InvalidArguments('Capturing can only output to a single file.') |
|
if 'command' not in kwargs: |
|
raise InvalidArguments('Missing keyword argument "command".') |
|
if 'depfile' in kwargs: |
|
depfile = kwargs['depfile'] |
|
if not isinstance(depfile, str): |
|
raise InvalidArguments('Depfile must be a string.') |
|
if os.path.split(depfile)[1] != depfile: |
|
raise InvalidArguments('Depfile must be a plain filename without a subdirectory.') |
|
self.depfile = depfile |
|
self.command = self.flatten_command(kwargs['command']) |
|
if self.capture: |
|
for c in self.command: |
|
if isinstance(c, str) and '@OUTPUT@' in c: |
|
raise InvalidArguments('@OUTPUT@ is not allowed when capturing output.') |
|
if 'install' in kwargs: |
|
self.install = kwargs['install'] |
|
if not isinstance(self.install, bool): |
|
raise InvalidArguments('"install" must be boolean.') |
|
if self.install: |
|
if 'install_dir' not in kwargs: |
|
raise InvalidArguments('"install_dir" must be specified ' |
|
'when installing a target') |
|
# If an item in this list is False, the output corresponding to |
|
# the list index of that item will not be installed |
|
self.install_dir = typeslistify(kwargs['install_dir'], (str, bool)) |
|
else: |
|
self.install = False |
|
self.install_dir = [None] |
|
self.build_always = kwargs.get('build_always', False) |
|
if not isinstance(self.build_always, bool): |
|
raise InvalidArguments('Argument build_always must be a boolean.') |
|
extra_deps = kwargs.get('depends', []) |
|
if not isinstance(extra_deps, list): |
|
extra_deps = [extra_deps] |
|
for ed in extra_deps: |
|
while hasattr(ed, 'held_object'): |
|
ed = ed.held_object |
|
if not isinstance(ed, (CustomTarget, BuildTarget)): |
|
raise InvalidArguments('Can only depend on toplevel targets: custom_target or build_target (executable or a library)') |
|
self.extra_depends.append(ed) |
|
depend_files = kwargs.get('depend_files', []) |
|
if not isinstance(depend_files, list): |
|
depend_files = [depend_files] |
|
for i in depend_files: |
|
if isinstance(i, (File, str)): |
|
self.depend_files.append(i) |
|
else: |
|
mlog.debug(i) |
|
raise InvalidArguments('Unknown type {!r} in depend_files.'.format(type(i).__name__)) |
|
|
|
def get_dependencies(self): |
|
return self.dependencies |
|
|
|
def should_install(self): |
|
return self.install |
|
|
|
def get_custom_install_dir(self): |
|
return self.install_dir |
|
|
|
def get_outputs(self): |
|
return self.outputs |
|
|
|
def get_filename(self): |
|
return self.outputs[0] |
|
|
|
def get_sources(self): |
|
return self.sources |
|
|
|
def get_generated_lists(self): |
|
genlists = [] |
|
for c in self.sources: |
|
if hasattr(c, 'held_object'): |
|
c = c.held_object |
|
if isinstance(c, GeneratedList): |
|
genlists.append(c) |
|
return genlists |
|
|
|
def get_generated_sources(self): |
|
return self.get_generated_lists() |
|
|
|
def type_suffix(self): |
|
return "@cus" |
|
|
|
class RunTarget(Target): |
|
def __init__(self, name, command, args, dependencies, subdir): |
|
super().__init__(name, subdir, False) |
|
self.command = command |
|
self.args = args |
|
self.dependencies = dependencies |
|
|
|
def __lt__(self, other): |
|
return self.get_id() < other.get_id() |
|
|
|
def __repr__(self): |
|
repr_str = "<{0} {1}: {2}>" |
|
return repr_str.format(self.__class__.__name__, self.get_id(), self.command) |
|
|
|
def get_id(self): |
|
return self.name + self.type_suffix() |
|
|
|
def get_dependencies(self): |
|
return self.dependencies |
|
|
|
def get_generated_sources(self): |
|
return [] |
|
|
|
def get_sources(self): |
|
return [] |
|
|
|
def should_install(self): |
|
return False |
|
|
|
def get_filename(self): |
|
return self.name |
|
|
|
def type_suffix(self): |
|
return "@run" |
|
|
|
class Jar(BuildTarget): |
|
def __init__(self, name, subdir, subproject, is_cross, sources, objects, environment, kwargs): |
|
super().__init__(name, subdir, subproject, is_cross, sources, objects, environment, kwargs) |
|
for s in self.sources: |
|
if not s.endswith('.java'): |
|
raise InvalidArguments('Jar source %s is not a java file.' % s) |
|
self.filename = self.name + '.jar' |
|
self.outputs = [self.filename] |
|
self.java_args = kwargs.get('java_args', []) |
|
|
|
def get_main_class(self): |
|
return self.main_class |
|
|
|
def type_suffix(self): |
|
return "@jar" |
|
|
|
def get_java_args(self): |
|
return self.java_args |
|
|
|
def validate_cross_install(self, environment): |
|
# All jar targets are installable. |
|
pass |
|
|
|
|
|
class ConfigureFile: |
|
|
|
def __init__(self, subdir, sourcename, targetname, configuration_data): |
|
self.subdir = subdir |
|
self.sourcename = sourcename |
|
self.targetname = targetname |
|
self.configuration_data = configuration_data |
|
|
|
def __repr__(self): |
|
repr_str = "<{0}: {1} -> {2}>" |
|
src = os.path.join(self.subdir, self.sourcename) |
|
dst = os.path.join(self.subdir, self.targetname) |
|
return repr_str.format(self.__class__.__name__, src, dst) |
|
|
|
def get_configuration_data(self): |
|
return self.configuration_data |
|
|
|
def get_subdir(self): |
|
return self.subdir |
|
|
|
def get_source_name(self): |
|
return self.sourcename |
|
|
|
def get_target_name(self): |
|
return self.targetname |
|
|
|
class ConfigurationData: |
|
def __init__(self): |
|
super().__init__() |
|
self.values = {} |
|
|
|
def __repr__(self): |
|
return repr(self.values) |
|
|
|
def __contains__(self, value): |
|
return value in self.values |
|
|
|
def get(self, name): |
|
return self.values[name] # (val, desc) |
|
|
|
def keys(self): |
|
return self.values.keys() |
|
|
|
# A bit poorly named, but this represents plain data files to copy |
|
# during install. |
|
class Data: |
|
def __init__(self, sources, install_dir, install_mode=None): |
|
self.sources = sources |
|
self.install_dir = install_dir |
|
self.install_mode = install_mode |
|
if not isinstance(self.sources, list): |
|
self.sources = [self.sources] |
|
for s in self.sources: |
|
assert(isinstance(s, File)) |
|
|
|
class RunScript(dict): |
|
def __init__(self, script, args): |
|
super().__init__() |
|
assert(isinstance(script, list)) |
|
assert(isinstance(args, list)) |
|
self['exe'] = script |
|
self['args'] = args |
|
|
|
class TestSetup: |
|
def __init__(self, *, exe_wrapper=None, gdb=None, timeout_multiplier=None, env=None): |
|
self.exe_wrapper = exe_wrapper |
|
self.gdb = gdb |
|
self.timeout_multiplier = timeout_multiplier |
|
self.env = env |
|
|
|
def get_sources_string_names(sources): |
|
''' |
|
For the specified list of @sources which can be strings, Files, or targets, |
|
get all the output basenames. |
|
''' |
|
names = [] |
|
for s in sources: |
|
if hasattr(s, 'held_object'): |
|
s = s.held_object |
|
if isinstance(s, str): |
|
names.append(s) |
|
elif isinstance(s, (BuildTarget, CustomTarget, GeneratedList)): |
|
names += s.get_outputs() |
|
elif isinstance(s, File): |
|
names.append(s.fname) |
|
else: |
|
raise AssertionError('Unknown source type: {!r}'.format(s)) |
|
return names
|
|
|