# Copyright 2019 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 typing as T import hashlib import os from pathlib import Path, PurePath, PureWindowsPath from .. import mlog from . import ExtensionModule from ..mesonlib import ( File, FileOrString, MesonException, path_is_in_root, ) from ..interpreterbase import FeatureNew, KwargInfo, typed_kwargs, typed_pos_args, noKwargs if T.TYPE_CHECKING: from . import ModuleState from ..interpreter import Interpreter from typing_extensions import TypedDict class ReadKwArgs(TypedDict): """Keyword Arguments for fs.read.""" encoding: str class FSModule(ExtensionModule): def __init__(self, interpreter: 'Interpreter') -> None: super().__init__(interpreter) self.methods.update({ 'expanduser': self.expanduser, 'is_absolute': self.is_absolute, 'as_posix': self.as_posix, 'exists': self.exists, 'is_symlink': self.is_symlink, 'is_file': self.is_file, 'is_dir': self.is_dir, 'hash': self.hash, 'size': self.size, 'is_samepath': self.is_samepath, 'replace_suffix': self.replace_suffix, 'parent': self.parent, 'name': self.name, 'stem': self.stem, 'read': self.read, }) def _absolute_dir(self, state: 'ModuleState', arg: 'FileOrString') -> Path: """ make an absolute path from a relative path, WITHOUT resolving symlinks """ if isinstance(arg, File): return Path(arg.absolute_path(state.source_root, self.interpreter.environment.get_build_dir())) return Path(state.source_root) / Path(state.subdir) / Path(arg).expanduser() def _resolve_dir(self, state: 'ModuleState', arg: 'FileOrString') -> Path: """ resolves symlinks and makes absolute a directory relative to calling meson.build, if not already absolute """ path = self._absolute_dir(state, arg) try: # accommodate unresolvable paths e.g. symlink loops path = path.resolve() except Exception: # return the best we could do pass return path @noKwargs @FeatureNew('fs.expanduser', '0.54.0') @typed_pos_args('fs.expanduser', str) def expanduser(self, state: 'ModuleState', args: T.Tuple[str], kwargs: T.Dict[str, T.Any]) -> str: return str(Path(args[0]).expanduser()) @noKwargs @FeatureNew('fs.is_absolute', '0.54.0') @typed_pos_args('fs.is_absolute', (str, File)) def is_absolute(self, state: 'ModuleState', args: T.Tuple['FileOrString'], kwargs: T.Dict[str, T.Any]) -> bool: if isinstance(args[0], File): FeatureNew('fs.is_absolute_file', '0.59.0').use(state.subproject) return PurePath(str(args[0])).is_absolute() @noKwargs @FeatureNew('fs.as_posix', '0.54.0') @typed_pos_args('fs.as_posix', str) def as_posix(self, state: 'ModuleState', args: T.Tuple[str], kwargs: T.Dict[str, T.Any]) -> str: """ this function assumes you are passing a Windows path, even if on a Unix-like system and so ALL '\' are turned to '/', even if you meant to escape a character """ return PureWindowsPath(args[0]).as_posix() @noKwargs @typed_pos_args('fs.exists', str) def exists(self, state: 'ModuleState', args: T.Tuple[str], kwargs: T.Dict[str, T.Any]) -> bool: return self._resolve_dir(state, args[0]).exists() @noKwargs @typed_pos_args('fs.is_symlink', (str, File)) def is_symlink(self, state: 'ModuleState', args: T.Tuple['FileOrString'], kwargs: T.Dict[str, T.Any]) -> bool: if isinstance(args[0], File): FeatureNew('fs.is_symlink_file', '0.59.0').use(state.subproject) return self._absolute_dir(state, args[0]).is_symlink() @noKwargs @typed_pos_args('fs.is_file', str) def is_file(self, state: 'ModuleState', args: T.Tuple[str], kwargs: T.Dict[str, T.Any]) -> bool: return self._resolve_dir(state, args[0]).is_file() @noKwargs @typed_pos_args('fs.is_dir', str) def is_dir(self, state: 'ModuleState', args: T.Tuple[str], kwargs: T.Dict[str, T.Any]) -> bool: return self._resolve_dir(state, args[0]).is_dir() @noKwargs @typed_pos_args('fs.hash', (str, File), str) def hash(self, state: 'ModuleState', args: T.Tuple['FileOrString', str], kwargs: T.Dict[str, T.Any]) -> str: if isinstance(args[0], File): FeatureNew('fs.hash_file', '0.59.0').use(state.subproject) file = self._resolve_dir(state, args[0]) if not file.is_file(): raise MesonException(f'{file} is not a file and therefore cannot be hashed') try: h = hashlib.new(args[1]) except ValueError: raise MesonException('hash algorithm {} is not available'.format(args[1])) mlog.debug('computing {} sum of {} size {} bytes'.format(args[1], file, file.stat().st_size)) h.update(file.read_bytes()) return h.hexdigest() @noKwargs @typed_pos_args('fs.size', (str, File)) def size(self, state: 'ModuleState', args: T.Tuple['FileOrString'], kwargs: T.Dict[str, T.Any]) -> int: if isinstance(args[0], File): FeatureNew('fs.size_file', '0.59.0').use(state.subproject) file = self._resolve_dir(state, args[0]) if not file.is_file(): raise MesonException(f'{file} is not a file and therefore cannot be sized') try: return file.stat().st_size except ValueError: raise MesonException('{} size could not be determined'.format(args[0])) @noKwargs @typed_pos_args('fs.is_samepath', (str, File), (str, File)) def is_samepath(self, state: 'ModuleState', args: T.Tuple['FileOrString', 'FileOrString'], kwargs: T.Dict[str, T.Any]) -> bool: if isinstance(args[0], File) or isinstance(args[1], File): FeatureNew('fs.is_samepath_file', '0.59.0').use(state.subproject) file1 = self._resolve_dir(state, args[0]) file2 = self._resolve_dir(state, args[1]) if not file1.exists(): return False if not file2.exists(): return False try: return file1.samefile(file2) except OSError: return False @noKwargs @typed_pos_args('fs.replace_suffix', (str, File), str) def replace_suffix(self, state: 'ModuleState', args: T.Tuple['FileOrString', str], kwargs: T.Dict[str, T.Any]) -> str: if isinstance(args[0], File): FeatureNew('fs.replace_suffix_file', '0.59.0').use(state.subproject) original = PurePath(str(args[0])) new = original.with_suffix(args[1]) return str(new) @noKwargs @typed_pos_args('fs.parent', (str, File)) def parent(self, state: 'ModuleState', args: T.Tuple['FileOrString'], kwargs: T.Dict[str, T.Any]) -> str: if isinstance(args[0], File): FeatureNew('fs.parent_file', '0.59.0').use(state.subproject) original = PurePath(str(args[0])) new = original.parent return str(new) @noKwargs @typed_pos_args('fs.name', (str, File)) def name(self, state: 'ModuleState', args: T.Tuple['FileOrString'], kwargs: T.Dict[str, T.Any]) -> str: if isinstance(args[0], File): FeatureNew('fs.name_file', '0.59.0').use(state.subproject) original = PurePath(str(args[0])) new = original.name return str(new) @noKwargs @typed_pos_args('fs.stem', (str, File)) @FeatureNew('fs.stem', '0.54.0') def stem(self, state: 'ModuleState', args: T.Tuple['FileOrString'], kwargs: T.Dict[str, T.Any]) -> str: if isinstance(args[0], File): FeatureNew('fs.stem_file', '0.59.0').use(state.subproject) original = PurePath(str(args[0])) new = original.stem return str(new) @FeatureNew('fs.read', '0.57.0') @typed_pos_args('fs.read', (str, File)) @typed_kwargs('fs.read', KwargInfo('encoding', str, default='utf-8')) def read(self, state: 'ModuleState', args: T.Tuple['FileOrString'], kwargs: 'ReadKwArgs') -> str: """Read a file from the source tree and return its value as a decoded string. If the encoding is not specified, the file is assumed to be utf-8 encoded. Paths must be relative by default (to prevent accidents) and are forbidden to be read from the build directory (to prevent build loops) """ path = args[0] encoding = kwargs['encoding'] src_dir = self.interpreter.environment.source_dir sub_dir = self.interpreter.subdir build_dir = self.interpreter.environment.get_build_dir() if isinstance(path, File): if path.is_built: raise MesonException( 'fs.read_file does not accept built files() objects') path = os.path.join(src_dir, path.relative_name()) else: if sub_dir: src_dir = os.path.join(src_dir, sub_dir) path = os.path.join(src_dir, path) path = os.path.abspath(path) if path_is_in_root(Path(path), Path(build_dir), resolve=True): raise MesonException('path must not be in the build tree') try: with open(path, encoding=encoding) as f: data = f.read() except UnicodeDecodeError: raise MesonException(f'decoding failed for {path}') # Reconfigure when this file changes as it can contain data used by any # part of the build configuration (e.g. `project(..., version: # fs.read_file('VERSION')` or `configure_file(...)` self.interpreter.add_build_def_file(path) return data def initialize(*args: T.Any, **kwargs: T.Any) -> FSModule: return FSModule(*args, **kwargs)