开源软件构建与测试

Changes of Revision 2

_service:tar_scm:meson.spec Changed

_service Changed

_service:tar_scm:meson-0.63.2.tar.gz/PKG-INFO Deleted

@@ -1,33 +0,0 @@
-Metadata-Version: 2.1
-Name: meson
-Version: 0.63.2
-Summary: A high performance build system
-Home-page: https://mesonbuild.com
-Author: Jussi Pakkanen
-Author-email: jpakkane@gmail.com
-License: Apache License, Version 2.0
-Keywords: meson,mesonbuild,build system,cmake
-Platform: UNKNOWN
-Classifier: Development Status :: 5 - Production/Stable
-Classifier: Environment :: Console
-Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: Apache Software License
-Classifier: Natural Language :: English
-Classifier: Operating System :: MacOS :: MacOS X
-Classifier: Operating System :: Microsoft :: Windows
-Classifier: Operating System :: POSIX :: BSD
-Classifier: Operating System :: POSIX :: Linux
-Classifier: Programming Language :: Python :: 3 :: Only
-Classifier: Programming Language :: Python :: 3.7
-Classifier: Programming Language :: Python :: 3.8
-Classifier: Programming Language :: Python :: 3.9
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Topic :: Software Development :: Build Tools
-Requires-Python: >=3.7
-Provides-Extra: ninja
-Provides-Extra: progress
-Provides-Extra: typing
-License-File: COPYING
-
-Meson is a cross-platform build system designed to be both as fast and as user friendly as possible. It supports many languages and compilers, including GCC, Clang, PGI, Intel, and Visual Studio. Its build definitions are written in a simple non-Turing complete DSL.
-

_service:tar_scm:meson-0.63.2.tar.gz/meson.egg-info Deleted

_service:tar_scm:meson-0.63.2.tar.gz/meson.egg-info/PKG-INFO Deleted

_service:tar_scm:meson-0.63.2.tar.gz/meson.egg-info/SOURCES.txt Deleted

@@ -1,3991 +0,0 @@
-COPYING
-MANIFEST.in
-README.md
-contributing.md
-meson.py
-pyproject.toml
-run_cross_test.py
-run_meson_command_tests.py
-run_project_tests.py
-run_tests.py
-run_unittests.py
-setup.cfg
-setup.py
-cross/arm64cl.txt
-cross/armcc.txt
-cross/armclang-linux.txt
-cross/armclang.txt
-cross/c2000.txt
-cross/ccomp-armv7a.txt
-cross/ccrx.txt
-cross/iphone.txt
-cross/linux-mingw-w64-32bit.json
-cross/linux-mingw-w64-32bit.txt
-cross/linux-mingw-w64-64bit.json
-cross/linux-mingw-w64-64bit.txt
-cross/msp430.txt
-cross/none.txt
-cross/ownstdlib.txt
-cross/tvos.txt
-cross/ubuntu-armhf.json
-cross/ubuntu-armhf.txt
-cross/ubuntu-faketarget.txt
-cross/wasm.txt
-cross/xc16.txt
-data/.coveragerc.in
-data/com.mesonbuild.install.policy
-data/macros.meson
-data/schema.xsd
-data/test.schema.json
-data/shell-completions/bash/meson
-data/shell-completions/zsh/_meson
-data/syntax-highlighting/vim/README
-data/syntax-highlighting/vim/ftdetect/meson.vim
-data/syntax-highlighting/vim/ftplugin/meson.vim
-data/syntax-highlighting/vim/indent/meson.vim
-data/syntax-highlighting/vim/syntax/meson.vim
-graphics/meson_logo.svg
-graphics/meson_logo_big.png
-graphics/wrap_logo.svg
-man/meson.1
-manual tests/1 wrap/main.c
-manual tests/1 wrap/meson.build
-manual tests/1 wrap/subprojects/sqlite.wrap
-manual tests/10 svn wrap/meson.build
-manual tests/10 svn wrap/prog.c
-manual tests/10 svn wrap/subprojects/samplesubproject.wrap
-manual tests/11 wrap imposter/meson.build
-manual tests/11 wrap imposter/subprojects/zlib.wrap
-manual tests/12 wrap mirror/meson.build
-manual tests/12 wrap mirror/subprojects/zlib.wrap
-manual tests/2 multiwrap/meson.build
-manual tests/2 multiwrap/prog.c
-manual tests/2 multiwrap/subprojects/libpng.wrap
-manual tests/2 multiwrap/subprojects/lua.wrap
-manual tests/2 multiwrap/subprojects/zlib.wrap
-manual tests/3 git wrap/meson.build
-manual tests/3 git wrap/prog.c
-manual tests/3 git wrap/subprojects/samplesubproject.wrap
-manual tests/4 standalone binaries/Info.plist
-manual tests/4 standalone binaries/build_linux_package.sh
-manual tests/4 standalone binaries/build_osx_package.sh
-manual tests/4 standalone binaries/build_windows_package.py
-manual tests/4 standalone binaries/linux_bundler.sh
-manual tests/4 standalone binaries/meson.build
-manual tests/4 standalone binaries/myapp.cpp
-manual tests/4 standalone binaries/myapp.icns
-manual tests/4 standalone binaries/myapp.iss
-manual tests/4 standalone binaries/myapp.sh
-manual tests/4 standalone binaries/osx_bundler.sh
-manual tests/4 standalone binaries/readme.txt
-manual tests/4 standalone binaries/template.dmg.gz
-manual tests/5 rpm/lib.c
-manual tests/5 rpm/lib.h
-manual tests/5 rpm/main.c
-manual tests/5 rpm/meson.build
-manual tests/6 hg wrap/meson.build
-manual tests/6 hg wrap/prog.c
-manual tests/6 hg wrap/subprojects/samplesubproject.wrap
-manual tests/7 vala composite widgets/meson.build
-manual tests/7 vala composite widgets/my-resources.xml
-manual tests/7 vala composite widgets/mywidget.ui
-manual tests/7 vala composite widgets/mywidget.vala
-manual tests/8 timeout/meson.build
-manual tests/8 timeout/sleepprog.c
-meson.egg-info/PKG-INFO
-meson.egg-info/SOURCES.txt
-meson.egg-info/dependency_links.txt
-meson.egg-info/entry_points.txt
-meson.egg-info/requires.txt
-meson.egg-info/top_level.txt
-mesonbuild/__init__.py
-mesonbuild/_pathlib.py
-mesonbuild/_typing.py
-mesonbuild/arglist.py
-mesonbuild/build.py
-mesonbuild/coredata.py
-mesonbuild/depfile.py
-mesonbuild/envconfig.py
-mesonbuild/environment.py
-mesonbuild/mcompile.py
-mesonbuild/mconf.py
-mesonbuild/mdevenv.py
-mesonbuild/mdist.py
-mesonbuild/mesondata.py
-mesonbuild/mesonmain.py
-mesonbuild/minit.py
-mesonbuild/minstall.py
-mesonbuild/mintro.py
-mesonbuild/mlog.py
-mesonbuild/mparser.py
-mesonbuild/msetup.py
-mesonbuild/msubprojects.py
-mesonbuild/mtest.py
-mesonbuild/munstable_coredata.py
-mesonbuild/optinterpreter.py
-mesonbuild/programs.py
-mesonbuild/rewriter.py
-mesonbuild/ast/__init__.py
-mesonbuild/ast/interpreter.py
-mesonbuild/ast/introspection.py
-mesonbuild/ast/postprocess.py
-mesonbuild/ast/printer.py
-mesonbuild/ast/visitor.py
-mesonbuild/backend/__init__.py
-mesonbuild/backend/backends.py
-mesonbuild/backend/ninjabackend.py
-mesonbuild/backend/vs2010backend.py
-mesonbuild/backend/vs2012backend.py
-mesonbuild/backend/vs2013backend.py
-mesonbuild/backend/vs2015backend.py
-mesonbuild/backend/vs2017backend.py
-mesonbuild/backend/vs2019backend.py
-mesonbuild/backend/vs2022backend.py
-mesonbuild/backend/xcodebackend.py
-mesonbuild/cmake/__init__.py
-mesonbuild/cmake/common.py
-mesonbuild/cmake/executor.py
-mesonbuild/cmake/fileapi.py
-mesonbuild/cmake/generator.py
-mesonbuild/cmake/interpreter.py
-mesonbuild/cmake/toolchain.py
-mesonbuild/cmake/traceparser.py
-mesonbuild/cmake/tracetargets.py
-mesonbuild/cmake/data/__init__.py
-mesonbuild/cmake/data/preload.cmake
-mesonbuild/compilers/__init__.py
-mesonbuild/compilers/c.py
-mesonbuild/compilers/c_function_attributes.py
-mesonbuild/compilers/compilers.py
-mesonbuild/compilers/cpp.py
-mesonbuild/compilers/cs.py
-mesonbuild/compilers/cuda.py
-mesonbuild/compilers/cython.py
-mesonbuild/compilers/d.py
-mesonbuild/compilers/detect.py
-mesonbuild/compilers/fortran.py
-mesonbuild/compilers/java.py
-mesonbuild/compilers/objc.py
-mesonbuild/compilers/objcpp.py
-mesonbuild/compilers/rust.py
-mesonbuild/compilers/swift.py
-mesonbuild/compilers/vala.py
-mesonbuild/compilers/mixins/__init__.py
-mesonbuild/compilers/mixins/arm.py
-mesonbuild/compilers/mixins/ccrx.py
-mesonbuild/compilers/mixins/clang.py
-mesonbuild/compilers/mixins/clike.py
-mesonbuild/compilers/mixins/compcert.py
-mesonbuild/compilers/mixins/elbrus.py
-mesonbuild/compilers/mixins/emscripten.py
-mesonbuild/compilers/mixins/gnu.py
-mesonbuild/compilers/mixins/intel.py
-mesonbuild/compilers/mixins/islinker.py
-mesonbuild/compilers/mixins/pgi.py
-mesonbuild/compilers/mixins/ti.py
-mesonbuild/compilers/mixins/visualstudio.py
-mesonbuild/compilers/mixins/xc16.py
-mesonbuild/dependencies/__init__.py
-mesonbuild/dependencies/base.py
-mesonbuild/dependencies/boost.py
-mesonbuild/dependencies/cmake.py
-mesonbuild/dependencies/coarrays.py
-mesonbuild/dependencies/configtool.py
-mesonbuild/dependencies/cuda.py
-mesonbuild/dependencies/detect.py
-mesonbuild/dependencies/dev.py
-mesonbuild/dependencies/dub.py
-mesonbuild/dependencies/factory.py
-mesonbuild/dependencies/framework.py
-mesonbuild/dependencies/hdf5.py
-mesonbuild/dependencies/misc.py
-mesonbuild/dependencies/mpi.py
-mesonbuild/dependencies/pkgconfig.py
-mesonbuild/dependencies/platform.py
-mesonbuild/dependencies/qt.py
-mesonbuild/dependencies/scalapack.py
-mesonbuild/dependencies/ui.py
-mesonbuild/dependencies/data/CMakeLists.txt
-mesonbuild/dependencies/data/CMakeListsLLVM.txt
-mesonbuild/dependencies/data/CMakePathInfo.txt
-mesonbuild/dependencies/data/__init__.py
-mesonbuild/interpreter/__init__.py
-mesonbuild/interpreter/compiler.py
-mesonbuild/interpreter/dependencyfallbacks.py
-mesonbuild/interpreter/interpreter.py
-mesonbuild/interpreter/interpreterobjects.py
-mesonbuild/interpreter/kwargs.py
-mesonbuild/interpreter/mesonmain.py
-mesonbuild/interpreter/type_checking.py
-mesonbuild/interpreter/primitives/__init__.py
-mesonbuild/interpreter/primitives/array.py
-mesonbuild/interpreter/primitives/boolean.py
-mesonbuild/interpreter/primitives/dict.py
-mesonbuild/interpreter/primitives/integer.py
-mesonbuild/interpreter/primitives/range.py
-mesonbuild/interpreter/primitives/string.py
-mesonbuild/interpreterbase/__init__.py
-mesonbuild/interpreterbase/_unholder.py
-mesonbuild/interpreterbase/baseobjects.py
-mesonbuild/interpreterbase/decorators.py
-mesonbuild/interpreterbase/disabler.py
-mesonbuild/interpreterbase/exceptions.py
-mesonbuild/interpreterbase/helpers.py
-mesonbuild/interpreterbase/interpreterbase.py
-mesonbuild/interpreterbase/operator.py
-mesonbuild/linkers/__init__.py
-mesonbuild/linkers/detect.py
-mesonbuild/linkers/linkers.py
-mesonbuild/mesonlib/__init__.py
-mesonbuild/mesonlib/platform.py
-mesonbuild/mesonlib/posix.py
-mesonbuild/mesonlib/universal.py
-mesonbuild/mesonlib/vsenv.py
-mesonbuild/mesonlib/win32.py
-mesonbuild/modules/__init__.py
-mesonbuild/modules/cmake.py
-mesonbuild/modules/dlang.py
-mesonbuild/modules/fs.py
-mesonbuild/modules/gnome.py
-mesonbuild/modules/hotdoc.py
-mesonbuild/modules/i18n.py
-mesonbuild/modules/java.py
-mesonbuild/modules/keyval.py
-mesonbuild/modules/modtest.py
-mesonbuild/modules/pkgconfig.py
-mesonbuild/modules/python.py
-mesonbuild/modules/python3.py
-mesonbuild/modules/qt.py
-mesonbuild/modules/qt4.py
-mesonbuild/modules/qt5.py
-mesonbuild/modules/qt6.py
-mesonbuild/modules/sourceset.py
-mesonbuild/modules/unstable_cuda.py
-mesonbuild/modules/unstable_external_project.py
-mesonbuild/modules/unstable_icestorm.py
-mesonbuild/modules/unstable_rust.py
-mesonbuild/modules/unstable_simd.py
-mesonbuild/modules/unstable_wayland.py
-mesonbuild/modules/windows.py
-mesonbuild/scripts/__init__.py
-mesonbuild/scripts/clangformat.py
-mesonbuild/scripts/clangtidy.py
-mesonbuild/scripts/cleantrees.py
-mesonbuild/scripts/cmake_run_ctgt.py
-mesonbuild/scripts/cmd_or_ps.ps1
-mesonbuild/scripts/copy.py
-mesonbuild/scripts/coverage.py
-mesonbuild/scripts/delwithsuffix.py
-mesonbuild/scripts/depfixer.py
-mesonbuild/scripts/depscan.py
-mesonbuild/scripts/dirchanger.py
-mesonbuild/scripts/env2mfile.py
-mesonbuild/scripts/externalproject.py
-mesonbuild/scripts/gettext.py
-mesonbuild/scripts/gtkdochelper.py
-mesonbuild/scripts/hotdochelper.py
-mesonbuild/scripts/itstool.py
-mesonbuild/scripts/meson_exe.py
-mesonbuild/scripts/msgfmthelper.py
-mesonbuild/scripts/regen_checker.py
-mesonbuild/scripts/run_tool.py
-mesonbuild/scripts/scanbuild.py
-mesonbuild/scripts/symbolextractor.py
-mesonbuild/scripts/tags.py
-mesonbuild/scripts/uninstall.py
-mesonbuild/scripts/vcstagger.py
-mesonbuild/templates/__init__.py
-mesonbuild/templates/cpptemplates.py
-mesonbuild/templates/cstemplates.py
-mesonbuild/templates/ctemplates.py
-mesonbuild/templates/cudatemplates.py
-mesonbuild/templates/dlangtemplates.py
-mesonbuild/templates/fortrantemplates.py
-mesonbuild/templates/javatemplates.py
-mesonbuild/templates/mesontemplates.py
-mesonbuild/templates/objcpptemplates.py
-mesonbuild/templates/objctemplates.py
-mesonbuild/templates/rusttemplates.py
-mesonbuild/templates/samplefactory.py
-mesonbuild/templates/sampleimpl.py
-mesonbuild/templates/valatemplates.py
-mesonbuild/wrap/__init__.py
-mesonbuild/wrap/wrap.py
-mesonbuild/wrap/wraptool.py
-packaging/License.rtf
-packaging/create_zipapp.py
-packaging/createmsi.py
-packaging/createpkg.py
-packaging/hook-mesonbuild.py
-packaging/macpages/English.lproj/conclusion.html
-packaging/macpages/English.lproj/license.html
-packaging/macpages/English.lproj/welcome.html
-test cases/cmake/1 basic/main.cpp
-test cases/cmake/1 basic/meson.build
-test cases/cmake/1 basic/subprojects/cmMod/CMakeLists.txt
-test cases/cmake/1 basic/subprojects/cmMod/cmMod.cpp
-test cases/cmake/1 basic/subprojects/cmMod/cmMod.hpp
-test cases/cmake/1 basic/subprojects/cmMod/cpp_pch.hpp
-test cases/cmake/10 header only/main.cpp
-test cases/cmake/10 header only/meson.build
-test cases/cmake/10 header only/subprojects/cmMod/CMakeLists.txt
-test cases/cmake/10 header only/subprojects/cmMod/include/cmMod.hpp
-test cases/cmake/11 cmake_module_path/meson.build
-test cases/cmake/11 cmake_module_path/cmake/FindSomethingLikePython.cmake
-test cases/cmake/11 cmake_module_path/subprojects/cmMod/CMakeLists.txt
-test cases/cmake/11 cmake_module_path/subprojects/cmMod/gen.py
-test cases/cmake/12 generator expressions/main.cpp
-test cases/cmake/12 generator expressions/meson.build
-test cases/cmake/12 generator expressions/test.json
-test cases/cmake/12 generator expressions/subprojects/cmMod/CMakeLists.txt
-test cases/cmake/12 generator expressions/subprojects/cmMod/include/cmMod.hpp
-test cases/cmake/13 system includes/main.cpp
-test cases/cmake/13 system includes/meson.build
-test cases/cmake/13 system includes/subprojects/cmMod/CMakeLists.txt
-test cases/cmake/13 system includes/subprojects/cmMod/cmMod.cpp
-test cases/cmake/13 system includes/subprojects/cmMod/cmMod.hpp
-test cases/cmake/13 system includes/subprojects/cmMod/sysInc/triggerWarn.hpp
-test cases/cmake/14 fortran threads/meson.build
-test cases/cmake/15 object library advanced/main.cpp
-test cases/cmake/15 object library advanced/meson.build
-test cases/cmake/15 object library advanced/subprojects/cmObjLib/CMakeLists.txt
-test cases/cmake/15 object library advanced/subprojects/cmObjLib/genC.cpp
-test cases/cmake/15 object library advanced/subprojects/cmObjLib/libA.cpp
-test cases/cmake/15 object library advanced/subprojects/cmObjLib/libA.hpp
-test cases/cmake/15 object library advanced/subprojects/cmObjLib/libB.cpp
-test cases/cmake/15 object library advanced/subprojects/cmObjLib/libB.hpp
-test cases/cmake/16 threads/main.cpp
-test cases/cmake/16 threads/meson.build
-test cases/cmake/16 threads/meson_options.txt
-test cases/cmake/16 threads/test.json
-test cases/cmake/16 threads/subprojects/cmMod/CMakeLists.txt
-test cases/cmake/16 threads/subprojects/cmMod/cmMod.cpp
-test cases/cmake/16 threads/subprojects/cmMod/cmMod.hpp
-test cases/cmake/16 threads/subprojects/cmMod/main.cpp
-test cases/cmake/17 include path order/main.cpp
-test cases/cmake/17 include path order/meson.build
-test cases/cmake/17 include path order/subprojects/cmMod/CMakeLists.txt
-test cases/cmake/17 include path order/subprojects/cmMod/cmMod.cpp
-test cases/cmake/17 include path order/subprojects/cmMod/incA/cmMod.hpp
-test cases/cmake/17 include path order/subprojects/cmMod/incB/cmMod.hpp
-test cases/cmake/17 include path order/subprojects/cmMod/incC/cmMod.hpp
-test cases/cmake/17 include path order/subprojects/cmMod/incD/cmMod.hpp
-test cases/cmake/17 include path order/subprojects/cmMod/incE/cmMod.hpp
-test cases/cmake/17 include path order/subprojects/cmMod/incF/cmMod.hpp
-test cases/cmake/17 include path order/subprojects/cmMod/incG/cmMod.hpp
-test cases/cmake/17 include path order/subprojects/cmMod/incH/cmMod.hpp
-test cases/cmake/17 include path order/subprojects/cmMod/incI/cmMod.hpp
-test cases/cmake/17 include path order/subprojects/cmMod/incJ/cmMod.hpp
-test cases/cmake/17 include path order/subprojects/cmMod/incL/cmMod.hpp
-test cases/cmake/17 include path order/subprojects/cmMod/incM/cmMod.hpp
-test cases/cmake/17 include path order/subprojects/cmMod/incN/cmMod.hpp
-test cases/cmake/17 include path order/subprojects/cmMod/incO/cmMod.hpp
-test cases/cmake/17 include path order/subprojects/cmMod/incP/cmMod.hpp
-test cases/cmake/18 skip include files/main.cpp
-test cases/cmake/18 skip include files/meson.build
-test cases/cmake/18 skip include files/subprojects/cmMod/CMakeLists.txt
-test cases/cmake/18 skip include files/subprojects/cmMod/cmMod.cpp
-test cases/cmake/18 skip include files/subprojects/cmMod/cmMod.hpp
-test cases/cmake/18 skip include files/subprojects/cmMod/fakeInc/CMakeLists.txt
-test cases/cmake/18 skip include files/subprojects/cmMod/fakeInc/cmModInc1.cpp
-test cases/cmake/18 skip include files/subprojects/cmMod/fakeInc/cmModInc2.cpp
-test cases/cmake/18 skip include files/subprojects/cmMod/fakeInc/cmModInc3.cpp
-test cases/cmake/18 skip include files/subprojects/cmMod/fakeInc/cmModInc4.cpp
-test cases/cmake/19 advanced options/main.cpp
-test cases/cmake/19 advanced options/meson.build
-test cases/cmake/19 advanced options/test.json
-test cases/cmake/19 advanced options/subprojects/cmOpts/CMakeLists.txt
-test cases/cmake/19 advanced options/subprojects/cmOpts/cmMod.cpp
-test cases/cmake/19 advanced options/subprojects/cmOpts/cmMod.hpp
-test cases/cmake/19 advanced options/subprojects/cmOpts/cmTest.cpp
-test cases/cmake/19 advanced options/subprojects/cmOpts/cmTest.hpp
-test cases/cmake/19 advanced options/subprojects/cmOpts/main.cpp
-test cases/cmake/2 advanced/main.cpp
-test cases/cmake/2 advanced/meson.build
-test cases/cmake/2 advanced/test.json
-test cases/cmake/2 advanced/subprojects/cmMod/CMakeLists.txt
-test cases/cmake/2 advanced/subprojects/cmMod/config.h.in
-test cases/cmake/2 advanced/subprojects/cmMod/main.cpp
-test cases/cmake/2 advanced/subprojects/cmMod/lib/cmMod.cpp
-test cases/cmake/2 advanced/subprojects/cmMod/lib/cmMod.hpp
-test cases/cmake/20 cmake file/foolib.cmake.in
-test cases/cmake/20 cmake file/meson.build
-test cases/cmake/20 cmake file/test.json
-test cases/cmake/21 shared module/meson.build
-test cases/cmake/21 shared module/prog.c
-test cases/cmake/21 shared module/runtime.c
-test cases/cmake/21 shared module/subprojects/cmMod/CMakeLists.txt
-test cases/cmake/21 shared module/subprojects/cmMod/module/module.c
-test cases/cmake/21 shared module/subprojects/cmMod/module/module.h
-test cases/cmake/22 cmake module/meson.build
-test cases/cmake/22 cmake module/projectConfig.cmake.in
-test cases/cmake/22 cmake module/test.json
-test cases/cmake/22 cmake module/cmake_project/CMakeLists.txt
-test cases/cmake/23 cmake toolchain/CMakeToolchain.cmake
-test cases/cmake/23 cmake toolchain/meson.build
-test cases/cmake/23 cmake toolchain/nativefile.ini.in
-test cases/cmake/23 cmake toolchain/subprojects/cmMod/CMakeLists.txt
-test cases/cmake/23 cmake toolchain/subprojects/cmModFortran/CMakeLists.txt
-test cases/cmake/24 mixing languages/main.c
-test cases/cmake/24 mixing languages/meson.build
-test cases/cmake/24 mixing languages/subprojects/cmTest/CMakeLists.txt
-test cases/cmake/24 mixing languages/subprojects/cmTest/cmTest.c
-test cases/cmake/24 mixing languages/subprojects/cmTest/cmTest.h
-test cases/cmake/24 mixing languages/subprojects/cmTest/cmTest.m
-test cases/cmake/25 assembler/main.c
-test cases/cmake/25 assembler/meson.build
-test cases/cmake/25 assembler/subprojects/cmTest/CMakeLists.txt
-test cases/cmake/25 assembler/subprojects/cmTest/cmTest.c
-test cases/cmake/25 assembler/subprojects/cmTest/cmTestAsm.s
-test cases/cmake/3 advanced no dep/main.cpp
-test cases/cmake/3 advanced no dep/meson.build
-test cases/cmake/3 advanced no dep/test.json
-test cases/cmake/3 advanced no dep/subprojects/cmMod/CMakeLists.txt
-test cases/cmake/3 advanced no dep/subprojects/cmMod/config.h.in
-test cases/cmake/3 advanced no dep/subprojects/cmMod/main.cpp
-test cases/cmake/3 advanced no dep/subprojects/cmMod/lib/cmMod.cpp
-test cases/cmake/3 advanced no dep/subprojects/cmMod/lib/cmMod.hpp
-test cases/cmake/4 code gen/main.cpp
-test cases/cmake/4 code gen/meson.build
-test cases/cmake/4 code gen/test.hpp
-test cases/cmake/4 code gen/subprojects/cmCodeGen/CMakeLists.txt
-test cases/cmake/4 code gen/subprojects/cmCodeGen/main.cpp
-test cases/cmake/5 object library/main.cpp
-test cases/cmake/5 object library/meson.build
-test cases/cmake/5 object library/subprojects/cmObjLib/CMakeLists.txt
-test cases/cmake/5 object library/subprojects/cmObjLib/libA.cpp
-test cases/cmake/5 object library/subprojects/cmObjLib/libA.hpp
-test cases/cmake/5 object library/subprojects/cmObjLib/libB.cpp
-test cases/cmake/5 object library/subprojects/cmObjLib/libB.hpp
-test cases/cmake/6 object library no dep/main.cpp
-test cases/cmake/6 object library no dep/meson.build
-test cases/cmake/6 object library no dep/subprojects/cmObjLib/CMakeLists.txt
-test cases/cmake/6 object library no dep/subprojects/cmObjLib/libA.cpp
-test cases/cmake/6 object library no dep/subprojects/cmObjLib/libA.hpp
-test cases/cmake/6 object library no dep/subprojects/cmObjLib/libB.cpp
-test cases/cmake/6 object library no dep/subprojects/cmObjLib/libB.hpp
-test cases/cmake/7 cmake options/meson.build
-test cases/cmake/7 cmake options/test.json
-test cases/cmake/7 cmake options/subprojects/cmOpts/CMakeLists.txt
-test cases/cmake/8 custom command/main.cpp
-test cases/cmake/8 custom command/meson.build
-test cases/cmake/8 custom command/subprojects/cmMod/CMakeLists.txt
-test cases/cmake/8 custom command/subprojects/cmMod/args_test.cpp
-test cases/cmake/8 custom command/subprojects/cmMod/cmMod.cpp
-test cases/cmake/8 custom command/subprojects/cmMod/cmMod.hpp
-test cases/cmake/8 custom command/subprojects/cmMod/cp.cpp
-test cases/cmake/8 custom command/subprojects/cmMod/cpyBase.cpp.am
-test cases/cmake/8 custom command/subprojects/cmMod/cpyBase.hpp.am
-test cases/cmake/8 custom command/subprojects/cmMod/cpyInc.hpp.am
-test cases/cmake/8 custom command/subprojects/cmMod/cpyNext.cpp.am
-test cases/cmake/8 custom command/subprojects/cmMod/cpyNext.hpp.am
-test cases/cmake/8 custom command/subprojects/cmMod/cpyTest.cpp
-test cases/cmake/8 custom command/subprojects/cmMod/genMain.cpp
-test cases/cmake/8 custom command/subprojects/cmMod/macro_name.cpp
-test cases/cmake/8 custom command/subprojects/cmMod/cpyTest/CMakeLists.txt
-test cases/cmake/8 custom command/subprojects/cmMod/cpyTest/cpyTest.hpp
-test cases/cmake/8 custom command/subprojects/cmMod/cpyTest/cpyTest2.hpp
-test cases/cmake/8 custom command/subprojects/cmMod/cpyTest/cpyTest3.hpp
-test cases/cmake/8 custom command/subprojects/cmMod/cpyTest/cpyTest4.hpp
-test cases/cmake/8 custom command/subprojects/cmMod/cpyTest/cpyTest5.hpp
-test cases/cmake/8 custom command/subprojects/cmMod/mycpy/.gitkeep
-test cases/cmake/9 disabled subproject/meson.build
-test cases/common/1 trivial/meson.build
-test cases/common/1 trivial/trivial.c
-test cases/common/10 man install/bar.2
-test cases/common/10 man install/baz.1.in
-test cases/common/10 man install/foo.1
-test cases/common/10 man install/foo.fr.1
-test cases/common/10 man install/meson.build
-test cases/common/10 man install/test.json
-test cases/common/10 man install/vanishing/meson.build
-test cases/common/10 man install/vanishing/vanishing.1
-test cases/common/10 man install/vanishing/vanishing.2
-test cases/common/100 postconf with args/meson.build
-test cases/common/100 postconf with args/postconf.py
-test cases/common/100 postconf with args/prog.c
-test cases/common/100 postconf with args/raw.dat
-test cases/common/101 testframework options/meson.build
-test cases/common/101 testframework options/meson_options.txt
-test cases/common/101 testframework options/test.json
-test cases/common/102 extract same name/lib.c
-test cases/common/102 extract same name/main.c
-test cases/common/102 extract same name/meson.build
-test cases/common/102 extract same name/src/lib.c
-test cases/common/103 has header symbol/meson.build
-test cases/common/104 has arg/meson.build
-test cases/common/105 generatorcustom/catter.py
-test cases/common/105 generatorcustom/gen-resx.py
-test cases/common/105 generatorcustom/gen.py
-test cases/common/105 generatorcustom/main.c
-test cases/common/105 generatorcustom/meson.build
-test cases/common/105 generatorcustom/res1.txt
-test cases/common/105 generatorcustom/res2.txt
-test cases/common/106 multiple dir configure file/meson.build
-test cases/common/106 multiple dir configure file/subdir/foo.txt
-test cases/common/106 multiple dir configure file/subdir/meson.build
-test cases/common/106 multiple dir configure file/subdir/someinput.in
-test cases/common/107 spaces backslash/comparer-end-notstring.c
-test cases/common/107 spaces backslash/comparer-end.c
-test cases/common/107 spaces backslash/comparer.c
-test cases/common/107 spaces backslash/meson.build
-test cases/common/107 spaces backslash/asm output/meson.build
-test cases/common/107 spaces backslash/include/comparer.h
-test cases/common/108 ternary/meson.build
-test cases/common/109 custom target capture/data_source.txt
-test cases/common/109 custom target capture/meson.build
-test cases/common/109 custom target capture/my_compiler.py
-test cases/common/109 custom target capture/test.json
-test cases/common/11 subdir/meson.build
-test cases/common/11 subdir/subdir/meson.build
-test cases/common/11 subdir/subdir/prog.c
-test cases/common/110 allgenerate/converter.py
-test cases/common/110 allgenerate/foobar.cpp.in
-test cases/common/110 allgenerate/meson.build
-test cases/common/111 pathjoin/meson.build
-test cases/common/112 subdir subproject/meson.build
-test cases/common/112 subdir subproject/prog/meson.build
-test cases/common/112 subdir subproject/prog/prog.c
-test cases/common/112 subdir subproject/subprojects/sub/meson.build
-test cases/common/112 subdir subproject/subprojects/sub/sub.c
-test cases/common/112 subdir subproject/subprojects/sub/sub.h
-test cases/common/113 interpreter copy mutable var on assignment/meson.build
-test cases/common/114 skip/meson.build
-test cases/common/115 subproject project arguments/exe.c
-test cases/common/115 subproject project arguments/exe.cpp
-test cases/common/115 subproject project arguments/meson.build
-test cases/common/115 subproject project arguments/subprojects/subexe/meson.build
-test cases/common/115 subproject project arguments/subprojects/subexe/subexe.c
-test cases/common/116 test skip/meson.build
-test cases/common/116 test skip/test_skip.c
-test cases/common/117 shared module/meson.build
-test cases/common/117 shared module/module.c
-test cases/common/117 shared module/nosyms.c
-test cases/common/117 shared module/prog.c
-test cases/common/117 shared module/runtime.c
-test cases/common/117 shared module/test.json
-test cases/common/118 llvm ir and assembly/main.c
-test cases/common/118 llvm ir and assembly/main.cpp
-test cases/common/118 llvm ir and assembly/meson.build
-test cases/common/118 llvm ir and assembly/square-aarch64.S
-test cases/common/118 llvm ir and assembly/square-arm.S
-test cases/common/118 llvm ir and assembly/square-x86.S
-test cases/common/118 llvm ir and assembly/square-x86_64.S
-test cases/common/118 llvm ir and assembly/square.ll
-test cases/common/118 llvm ir and assembly/symbol-underscore.h
-test cases/common/119 cpp and asm/meson.build
-test cases/common/119 cpp and asm/retval-arm.S
-test cases/common/119 cpp and asm/retval-x86.S
-test cases/common/119 cpp and asm/retval-x86_64.S
-test cases/common/119 cpp and asm/symbol-underscore.h
-test cases/common/119 cpp and asm/trivial.cc
-test cases/common/12 data/datafile.dat
-test cases/common/12 data/etcfile.dat
-test cases/common/12 data/fileobject_datafile.dat
-test cases/common/12 data/meson.build
-test cases/common/12 data/runscript.sh
-test cases/common/12 data/somefile.txt
-test cases/common/12 data/test.json
-test cases/common/12 data/to_be_renamed_1.txt
-test cases/common/12 data/to_be_renamed_3.txt
-test cases/common/12 data/to_be_renamed_4.txt
-test cases/common/12 data/vanishing/meson.build
-test cases/common/12 data/vanishing/to_be_renamed_2.txt
-test cases/common/12 data/vanishing/vanishing.dat
-test cases/common/12 data/vanishing/vanishing2.dat
-test cases/common/120 extract all shared library/extractor.h
-test cases/common/120 extract all shared library/four.c
-test cases/common/120 extract all shared library/func1234.def
-test cases/common/120 extract all shared library/meson.build
-test cases/common/120 extract all shared library/one.c
-test cases/common/120 extract all shared library/prog.c
-test cases/common/120 extract all shared library/three.c
-test cases/common/120 extract all shared library/two.c
-test cases/common/121 object only target/meson.build
-test cases/common/121 object only target/obj_generator.py
-test cases/common/121 object only target/prog.c
-test cases/common/121 object only target/source.c
-test cases/common/121 object only target/source2.c
-test cases/common/121 object only target/source2.def
-test cases/common/121 object only target/source3.c
-test cases/common/121 object only target/test.json
-test cases/common/121 object only target/objdir/meson.build
-test cases/common/121 object only target/objdir/source4.c
-test cases/common/121 object only target/objdir/source5.c
-test cases/common/121 object only target/objdir/source6.c
-test cases/common/122 no buildincdir/meson.build
-test cases/common/122 no buildincdir/prog.c
-test cases/common/122 no buildincdir/include/header.h
-test cases/common/123 custom target directory install/docgen.py
-test cases/common/123 custom target directory install/meson.build
-test cases/common/123 custom target directory install/test.json
-test cases/common/124 dependency file generation/main .c
-test cases/common/124 dependency file generation/meson.build
-test cases/common/125 configure file in generator/meson.build
-test cases/common/125 configure file in generator/inc/confdata.in
-test cases/common/125 configure file in generator/inc/meson.build
-test cases/common/125 configure file in generator/src/gen.py
-test cases/common/125 configure file in generator/src/main.c
-test cases/common/125 configure file in generator/src/meson.build
-test cases/common/125 configure file in generator/src/source
-test cases/common/126 generated llvm ir/copyfile.py
-test cases/common/126 generated llvm ir/main.c
-test cases/common/126 generated llvm ir/meson.build
-test cases/common/126 generated llvm ir/square.ll.in
-test cases/common/127 generated assembly/copyfile.py
-test cases/common/127 generated assembly/empty.c
-test cases/common/127 generated assembly/main.c
-test cases/common/127 generated assembly/meson.build
-test cases/common/127 generated assembly/square-arm.S.in
-test cases/common/127 generated assembly/square-x86.S.in
-test cases/common/127 generated assembly/square-x86_64.S.in
-test cases/common/127 generated assembly/square.def
-test cases/common/127 generated assembly/symbol-underscore.h
-test cases/common/128 build by default targets in tests/main.c
-test cases/common/128 build by default targets in tests/meson.build
-test cases/common/128 build by default targets in tests/write_file.py
-test cases/common/129 build by default/checkexists.py
-test cases/common/129 build by default/foo.c
-test cases/common/129 build by default/meson.build
-test cases/common/129 build by default/mygen.py
-test cases/common/129 build by default/source.txt
-test cases/common/13 pch/meson.build
-test cases/common/13 pch/c/meson.build
-test cases/common/13 pch/c/prog.c
-test cases/common/13 pch/c/pch/prog.h
-test cases/common/13 pch/cpp/meson.build
-test cases/common/13 pch/cpp/prog.cc
-test cases/common/13 pch/cpp/pch/prog.hh
-test cases/common/13 pch/generated/gen_custom.py
-test cases/common/13 pch/generated/gen_generator.py
-test cases/common/13 pch/generated/generated_generator.in
-test cases/common/13 pch/generated/meson.build
-test cases/common/13 pch/generated/prog.c
-test cases/common/13 pch/generated/pch/prog.h
-test cases/common/13 pch/mixed/func.c
-test cases/common/13 pch/mixed/main.cc
-test cases/common/13 pch/mixed/meson.build
-test cases/common/13 pch/mixed/pch/func.h
-test cases/common/13 pch/mixed/pch/main.h
-test cases/common/13 pch/userDefined/meson.build
-test cases/common/13 pch/userDefined/prog.c
-test cases/common/13 pch/userDefined/pch/pch.c
-test cases/common/13 pch/userDefined/pch/pch.h
-test cases/common/13 pch/withIncludeDirectories/meson.build
-test cases/common/13 pch/withIncludeDirectories/prog.c
-test cases/common/13 pch/withIncludeDirectories/include/lib/lib.h
-test cases/common/13 pch/withIncludeDirectories/pch/prog.h
-test cases/common/13 pch/withIncludeFile/meson.build
-test cases/common/13 pch/withIncludeFile/prog.c
-test cases/common/13 pch/withIncludeFile/pch/prog.h
-test cases/common/130 include order/meson.build
-test cases/common/130 include order/ordertest.c
-test cases/common/130 include order/ctsub/copyfile.py
-test cases/common/130 include order/ctsub/emptyfile.c
-test cases/common/130 include order/ctsub/main.h
-test cases/common/130 include order/ctsub/meson.build
-test cases/common/130 include order/inc1/hdr.h
-test cases/common/130 include order/inc2/hdr.h
-test cases/common/130 include order/sub1/main.h
-test cases/common/130 include order/sub1/meson.build
-test cases/common/130 include order/sub1/some.c
-test cases/common/130 include order/sub1/some.h
-test cases/common/130 include order/sub2/main.h
-test cases/common/130 include order/sub2/meson.build
-test cases/common/130 include order/sub3/main.h
-test cases/common/130 include order/sub3/meson.build
-test cases/common/130 include order/sub4/main.c
-test cases/common/130 include order/sub4/main.h
-test cases/common/130 include order/sub4/meson.build
-test cases/common/131 override options/four.c
-test cases/common/131 override options/meson.build
-test cases/common/131 override options/one.c
-test cases/common/131 override options/three.c
-test cases/common/131 override options/two.c
-test cases/common/132 get define/concat.h
-test cases/common/132 get define/meson.build
-test cases/common/132 get define/meson_options.txt
-test cases/common/133 c cpp and asm/main.c
-test cases/common/133 c cpp and asm/main.cpp
-test cases/common/133 c cpp and asm/meson.build
-test cases/common/133 c cpp and asm/retval-arm.S
-test cases/common/133 c cpp and asm/retval-x86.S
-test cases/common/133 c cpp and asm/retval-x86_64.S
-test cases/common/133 c cpp and asm/somelib.c
-test cases/common/133 c cpp and asm/symbol-underscore.h
-test cases/common/134 compute int/config.h.in
-test cases/common/134 compute int/foobar.h
-test cases/common/134 compute int/meson.build
-test cases/common/134 compute int/prog.c.in
-test cases/common/135 custom target object output/meson.build
-test cases/common/135 custom target object output/obj_generator.py
-test cases/common/135 custom target object output/objdir/meson.build
-test cases/common/135 custom target object output/objdir/source.c
-test cases/common/135 custom target object output/progdir/meson.build
-test cases/common/135 custom target object output/progdir/prog.c
-test cases/common/136 empty build file/meson.build
-test cases/common/136 empty build file/subdir/meson.build
-test cases/common/137 whole archive/func1.c
-test cases/common/137 whole archive/func2.c
-test cases/common/137 whole archive/meson.build
-test cases/common/137 whole archive/mylib.h
-test cases/common/137 whole archive/prog.c
-test cases/common/137 whole archive/exe/meson.build
-test cases/common/137 whole archive/exe2/meson.build
-test cases/common/137 whole archive/exe3/meson.build
-test cases/common/137 whole archive/exe4/meson.build
-test cases/common/137 whole archive/sh_func2_dep_func1/meson.build
-test cases/common/137 whole archive/sh_func2_linked_func1/meson.build
-test cases/common/137 whole archive/sh_func2_transdep_func1/meson.build
-test cases/common/137 whole archive/sh_only_link_whole/meson.build
-test cases/common/137 whole archive/st_func1/meson.build
-test cases/common/137 whole archive/st_func2/meson.build
-test cases/common/138 C and CPP link/dummy.c
-test cases/common/138 C and CPP link/foo.c
-test cases/common/138 C and CPP link/foo.cpp
-test cases/common/138 C and CPP link/foo.h
-test cases/common/138 C and CPP link/foo.hpp
-test cases/common/138 C and CPP link/foobar.c
-test cases/common/138 C and CPP link/foobar.h
-test cases/common/138 C and CPP link/meson.build
-test cases/common/138 C and CPP link/sub.c
-test cases/common/138 C and CPP link/sub.h
-test cases/common/139 mesonintrospect from scripts/check_env.py
-test cases/common/139 mesonintrospect from scripts/check_introspection.py
-test cases/common/139 mesonintrospect from scripts/meson.build
-test cases/common/14 configure file/basename.py
-test cases/common/14 configure file/check_file.py
-test cases/common/14 configure file/check_inputs.py
-test cases/common/14 configure file/config.h
-test cases/common/14 configure file/config.h.in
-test cases/common/14 configure file/config4a.h.in
-test cases/common/14 configure file/config4b.h.in
-test cases/common/14 configure file/config5.h.in
-test cases/common/14 configure file/config6.h.in
-test cases/common/14 configure file/config7.h.in
-test cases/common/14 configure file/config8.h.in
-test cases/common/14 configure file/depfile
-test cases/common/14 configure file/differentafterbasename1.in
-test cases/common/14 configure file/differentafterbasename2.in
-test cases/common/14 configure file/dummy.dat
-test cases/common/14 configure file/dumpprog.c
-test cases/common/14 configure file/file_contains.py
-test cases/common/14 configure file/generator-deps.py
-test cases/common/14 configure file/generator-without-input-file.py
-test cases/common/14 configure file/generator.py
-test cases/common/14 configure file/invalid-utf8.bin.in
-test cases/common/14 configure file/meson.build
-test cases/common/14 configure file/nosubst-nocopy1.txt.in
-test cases/common/14 configure file/nosubst-nocopy2.txt.in
-test cases/common/14 configure file/prog.c
-test cases/common/14 configure file/prog2.c
-test cases/common/14 configure file/prog4.c
-test cases/common/14 configure file/prog5.c
-test cases/common/14 configure file/prog6.c
-test cases/common/14 configure file/prog7.c
-test cases/common/14 configure file/prog9.c
-test cases/common/14 configure file/sameafterbasename.in
-test cases/common/14 configure file/sameafterbasename.in2
-test cases/common/14 configure file/test.json
-test cases/common/14 configure file/test.py.in
-test cases/common/14 configure file/touch.py
-test cases/common/14 configure file/subdir/meson.build
-test cases/common/140 custom target multiple outputs/generator.py
-test cases/common/140 custom target multiple outputs/meson.build
-test cases/common/140 custom target multiple outputs/test.json
-test cases/common/141 special characters/.editorconfig
-test cases/common/141 special characters/arg-char-test.c
-test cases/common/141 special characters/arg-string-test.c
-test cases/common/141 special characters/arg-unquoted-test.c
-test cases/common/141 special characters/check_quoting.py
-test cases/common/141 special characters/meson.build
-test cases/common/141 special characters/test.json
-test cases/common/142 nested links/meson.build
-test cases/common/142 nested links/xephyr.c
-test cases/common/143 list of file sources/foo
-test cases/common/143 list of file sources/gen.py
-test cases/common/143 list of file sources/meson.build
-test cases/common/144 link depends custom target/foo.c
-test cases/common/144 link depends custom target/make_file.py
-test cases/common/144 link depends custom target/meson.build
-test cases/common/145 recursive linking/lib.h
-test cases/common/145 recursive linking/main.c
-test cases/common/145 recursive linking/meson.build
-test cases/common/145 recursive linking/3rdorderdeps/lib.c.in
-test cases/common/145 recursive linking/3rdorderdeps/main.c.in
-test cases/common/145 recursive linking/3rdorderdeps/meson.build
-test cases/common/145 recursive linking/circular/lib1.c
-test cases/common/145 recursive linking/circular/lib2.c
-test cases/common/145 recursive linking/circular/lib3.c
-test cases/common/145 recursive linking/circular/main.c
-test cases/common/145 recursive linking/circular/meson.build
-test cases/common/145 recursive linking/circular/prop1.c
-test cases/common/145 recursive linking/circular/prop2.c
-test cases/common/145 recursive linking/circular/prop3.c
-test cases/common/145 recursive linking/edge-cases/libsto.c
-test cases/common/145 recursive linking/edge-cases/meson.build
-test cases/common/145 recursive linking/edge-cases/shstmain.c
-test cases/common/145 recursive linking/edge-cases/stobuilt.c
-test cases/common/145 recursive linking/edge-cases/stomain.c
-test cases/common/145 recursive linking/shnodep/lib.c
-test cases/common/145 recursive linking/shnodep/meson.build
-test cases/common/145 recursive linking/shshdep/lib.c
-test cases/common/145 recursive linking/shshdep/meson.build
-test cases/common/145 recursive linking/shstdep/lib.c
-test cases/common/145 recursive linking/shstdep/meson.build
-test cases/common/145 recursive linking/stnodep/lib.c
-test cases/common/145 recursive linking/stnodep/meson.build
-test cases/common/145 recursive linking/stshdep/lib.c
-test cases/common/145 recursive linking/stshdep/meson.build
-test cases/common/145 recursive linking/ststdep/lib.c
-test cases/common/145 recursive linking/ststdep/meson.build
-test cases/common/146 library at root/lib.c
-test cases/common/146 library at root/meson.build
-test cases/common/146 library at root/main/main.c
-test cases/common/146 library at root/main/meson.build
-test cases/common/147 simd/fallback.c
-test cases/common/147 simd/meson.build
-test cases/common/147 simd/simd_avx.c
-test cases/common/147 simd/simd_avx2.c
-test cases/common/147 simd/simd_mmx.c
-test cases/common/147 simd/simd_neon.c
-test cases/common/147 simd/simd_sse.c
-test cases/common/147 simd/simd_sse2.c
-test cases/common/147 simd/simd_sse3.c
-test cases/common/147 simd/simd_sse41.c
-test cases/common/147 simd/simd_sse42.c
-test cases/common/147 simd/simd_ssse3.c
-test cases/common/147 simd/simdchecker.c
-test cases/common/147 simd/simdfuncs.h
-test cases/common/147 simd/include/simdheader.h
-test cases/common/148 shared module resolving symbol in executable/meson.build
-test cases/common/148 shared module resolving symbol in executable/module.c
-test cases/common/148 shared module resolving symbol in executable/prog.c
-test cases/common/149 dotinclude/dotproc.c
-test cases/common/149 dotinclude/meson.build
-test cases/common/149 dotinclude/stdio.h
-test cases/common/15 if/meson.build
-test cases/common/15 if/prog.c
-test cases/common/150 reserved targets/meson.build
-test cases/common/150 reserved targets/test.c
-test cases/common/150 reserved targets/all/meson.build
-test cases/common/150 reserved targets/benchmark/meson.build
-test cases/common/150 reserved targets/clean/meson.build
-test cases/common/150 reserved targets/clean-ctlist/meson.build
-test cases/common/150 reserved targets/clean-gcda/meson.build
-test cases/common/150 reserved targets/clean-gcno/meson.build
-test cases/common/150 reserved targets/coverage/meson.build
-test cases/common/150 reserved targets/coverage-html/meson.build
-test cases/common/150 reserved targets/coverage-sonarqube/meson.build
-test cases/common/150 reserved targets/coverage-text/meson.build
-test cases/common/150 reserved targets/coverage-xml/meson.build
-test cases/common/150 reserved targets/dist/meson.build
-test cases/common/150 reserved targets/distcheck/meson.build
-test cases/common/150 reserved targets/install/meson.build
-test cases/common/150 reserved targets/phony/meson.build
-test cases/common/150 reserved targets/reconfigure/meson.build
-test cases/common/150 reserved targets/runtarget/echo.py
-test cases/common/150 reserved targets/runtarget/meson.build
-test cases/common/150 reserved targets/scan-build/meson.build
-test cases/common/150 reserved targets/test/meson.build
-test cases/common/150 reserved targets/uninstall/meson.build
-test cases/common/151 duplicate source names/meson.build
-test cases/common/151 duplicate source names/dir1/file.c
-test cases/common/151 duplicate source names/dir1/meson.build
-test cases/common/151 duplicate source names/dir2/file.c
-test cases/common/151 duplicate source names/dir2/meson.build
-test cases/common/151 duplicate source names/dir2/dir1/file.c
-test cases/common/151 duplicate source names/dir3/file.c
-test cases/common/151 duplicate source names/dir3/meson.build
-test cases/common/151 duplicate source names/dir3/dir1/file.c
-test cases/common/152 index customtarget/check_args.py
-test cases/common/152 index customtarget/gen_sources.py
-test cases/common/152 index customtarget/lib.c
-test cases/common/152 index customtarget/meson.build
-test cases/common/152 index customtarget/subdir/foo.c
-test cases/common/152 index customtarget/subdir/meson.build
-test cases/common/153 wrap file should not failed/meson.build
-test cases/common/153 wrap file should not failed/src/meson.build
-test cases/common/153 wrap file should not failed/src/test.c
-test cases/common/153 wrap file should not failed/src/subprojects/prog.c
-test cases/common/153 wrap file should not failed/src/subprojects/foo/prog2.c
-test cases/common/153 wrap file should not failed/subprojects/.gitignore
-test cases/common/153 wrap file should not failed/subprojects/bar.wrap
-test cases/common/153 wrap file should not failed/subprojects/foo.wrap
-test cases/common/153 wrap file should not failed/subprojects/patchdir.wrap
-test cases/common/153 wrap file should not failed/subprojects/patchfile.wrap
-test cases/common/153 wrap file should not failed/subprojects/zlib.wrap
-test cases/common/153 wrap file should not failed/subprojects/bar-1.0/bar.c
-test cases/common/153 wrap file should not failed/subprojects/bar-1.0/meson.build
-test cases/common/153 wrap file should not failed/subprojects/foo-1.0/foo.c
-test cases/common/153 wrap file should not failed/subprojects/foo-1.0/meson.build
-test cases/common/153 wrap file should not failed/subprojects/foo-1.0-patchdir/foo.c
-test cases/common/153 wrap file should not failed/subprojects/foo-1.0-patchdir/meson.build
-test cases/common/153 wrap file should not failed/subprojects/packagecache/foo-1.0-patch.tar.xz
-test cases/common/153 wrap file should not failed/subprojects/packagecache/foo-1.0.tar.xz
-test cases/common/153 wrap file should not failed/subprojects/packagecache/zlib-1.2.8-8-wrap.zip
-test cases/common/153 wrap file should not failed/subprojects/packagecache/zlib-1.2.8.tar.gz
-test cases/common/153 wrap file should not failed/subprojects/packagefiles/bar-1.0-patch.tar.xz
-test cases/common/153 wrap file should not failed/subprojects/packagefiles/bar-1.0.tar.xz
-test cases/common/153 wrap file should not failed/subprojects/packagefiles/foo-1.0/meson.build
-test cases/common/153 wrap file should not failed/subprojects/packagefiles/patchfile/0001-Change-foo-to-executable.patch
-test cases/common/153 wrap file should not failed/subprojects/packagefiles/patchfile/0001-Change-return-value-to-43.patch
-test cases/common/153 wrap file should not failed/subprojects/packagefiles/patchfile/0002-Change-return-value-to-44.patch
-test cases/common/153 wrap file should not failed/subprojects/zlib-1.2.8/foo.c
-test cases/common/153 wrap file should not failed/subprojects/zlib-1.2.8/meson.build
-test cases/common/154 includedir subproj/meson.build
-test cases/common/154 includedir subproj/prog.c
-test cases/common/154 includedir subproj/subprojects/inctest/meson.build
-test cases/common/154 includedir subproj/subprojects/inctest/include/incfile.h
-test cases/common/155 subproject dir name collision/a.c
-test cases/common/155 subproject dir name collision/meson.build
-test cases/common/155 subproject dir name collision/custom_subproject_dir/B/b.c
-test cases/common/155 subproject dir name collision/custom_subproject_dir/B/meson.build
-test cases/common/155 subproject dir name collision/custom_subproject_dir/C/c.c
-test cases/common/155 subproject dir name collision/custom_subproject_dir/C/meson.build
-test cases/common/155 subproject dir name collision/other_subdir/meson.build
-test cases/common/155 subproject dir name collision/other_subdir/custom_subproject_dir/other.c
-test cases/common/156 config tool variable/meson.build
-test cases/common/157 custom target subdir depend files/copyfile.py
-test cases/common/157 custom target subdir depend files/meson.build
-test cases/common/157 custom target subdir depend files/subdir/dep.dat
-test cases/common/157 custom target subdir depend files/subdir/foo.c.in
-test cases/common/157 custom target subdir depend files/subdir/meson.build
-test cases/common/158 disabler/meson.build
-test cases/common/159 array option/meson.build
-test cases/common/159 array option/meson_options.txt
-test cases/common/16 comparison/meson.build
-test cases/common/16 comparison/prog.c
-test cases/common/160 custom target template substitution/checkcopy.py
-test cases/common/160 custom target template substitution/foo.c.in
-test cases/common/160 custom target template substitution/meson.build
-test cases/common/161 not-found dependency/meson.build
-test cases/common/161 not-found dependency/testlib.c
-test cases/common/161 not-found dependency/sub/meson.build
-test cases/common/161 not-found dependency/subprojects/trivial/meson.build
-test cases/common/161 not-found dependency/subprojects/trivial/trivial.c
-test cases/common/162 subdir if_found/meson.build
-test cases/common/162 subdir if_found/subdir/meson.build
-test cases/common/163 default options prefix dependent defaults/meson.build
-test cases/common/164 dependency factory/meson.build
-test cases/common/165 get project license/bar.c
-test cases/common/165 get project license/meson.build
-test cases/common/166 yield/meson.build
-test cases/common/166 yield/meson_options.txt
-test cases/common/166 yield/subprojects/sub/meson.build
-test cases/common/166 yield/subprojects/sub/meson_options.txt
-test cases/common/167 subproject nested subproject dirs/meson.build
-test cases/common/167 subproject nested subproject dirs/prog.c
-test cases/common/167 subproject nested subproject dirs/contrib/subprojects/alpha/a.c
-test cases/common/167 subproject nested subproject dirs/contrib/subprojects/alpha/meson.build
-test cases/common/167 subproject nested subproject dirs/contrib/subprojects/alpha/var/subprojects/wrap_files_might_be_here
-test cases/common/167 subproject nested subproject dirs/contrib/subprojects/beta/b.c
-test cases/common/167 subproject nested subproject dirs/contrib/subprojects/beta/meson.build
-test cases/common/168 preserve gendir/base.inp
-test cases/common/168 preserve gendir/genprog.py
-test cases/common/168 preserve gendir/meson.build
-test cases/common/168 preserve gendir/testprog.c
-test cases/common/168 preserve gendir/com/mesonbuild/subbie.inp
-test cases/common/169 source in dep/bar.cpp
-test cases/common/169 source in dep/foo.c
-test cases/common/169 source in dep/meson.build
-test cases/common/169 source in dep/generated/funname
-test cases/common/169 source in dep/generated/genheader.py
-test cases/common/169 source in dep/generated/main.c
-test cases/common/169 source in dep/generated/meson.build
-test cases/common/17 array/func.c
-test cases/common/17 array/meson.build
-test cases/common/17 array/prog.c
-test cases/common/170 generator link whole/export.h
-test cases/common/170 generator link whole/generator.py
-test cases/common/170 generator link whole/main.c
-test cases/common/170 generator link whole/meson.build
-test cases/common/170 generator link whole/meson_test_function.tmpl
-test cases/common/170 generator link whole/pull_meson_test_function.c
-test cases/common/171 initial c_args/meson.build
-test cases/common/171 initial c_args/test.json
-test cases/common/172 identical target name in subproject flat layout/foo.c
-test cases/common/172 identical target name in subproject flat layout/main.c
-test cases/common/172 identical target name in subproject flat layout/meson.build
-test cases/common/172 identical target name in subproject flat layout/subprojects/subproj/foo.c
-test cases/common/172 identical target name in subproject flat layout/subprojects/subproj/meson.build
-test cases/common/173 as-needed/config.h
-test cases/common/173 as-needed/libA.cpp
-test cases/common/173 as-needed/libA.h
-test cases/common/173 as-needed/libB.cpp
-test cases/common/173 as-needed/main.cpp
-test cases/common/173 as-needed/meson.build
-test cases/common/174 ndebug if-release enabled/main.c
-test cases/common/174 ndebug if-release enabled/meson.build
-test cases/common/175 ndebug if-release disabled/main.c
-test cases/common/175 ndebug if-release disabled/meson.build
-test cases/common/176 subproject version/meson.build
-test cases/common/176 subproject version/subprojects/a/meson.build
-test cases/common/177 subdir_done/meson.build
-test cases/common/178 bothlibraries/dummy.py
-test cases/common/178 bothlibraries/libfile.c
-test cases/common/178 bothlibraries/main.c
-test cases/common/178 bothlibraries/meson.build
-test cases/common/178 bothlibraries/mylib.h
-test cases/common/179 escape and unicode/file.c.in
-test cases/common/179 escape and unicode/file.py
-test cases/common/179 escape and unicode/find.py
-test cases/common/179 escape and unicode/fun.c
-test cases/common/179 escape and unicode/main.c
-test cases/common/179 escape and unicode/meson.build
-test cases/common/18 includedir/meson.build
-test cases/common/18 includedir/include/func.h
-test cases/common/18 includedir/src/func.c
-test cases/common/18 includedir/src/meson.build
-test cases/common/18 includedir/src/prog.c
-test cases/common/180 has link arg/meson.build
-test cases/common/181 same target name flat layout/foo.c
-test cases/common/181 same target name flat layout/main.c
-test cases/common/181 same target name flat layout/meson.build
-test cases/common/181 same target name flat layout/subdir/foo.c
-test cases/common/181 same target name flat layout/subdir/meson.build
-test cases/common/182 find override/meson.build
-test cases/common/182 find override/otherdir/main.c
-test cases/common/182 find override/otherdir/main2.c
-test cases/common/182 find override/otherdir/meson.build
-test cases/common/182 find override/otherdir/source.desc
-test cases/common/182 find override/otherdir/source2.desc
-test cases/common/182 find override/subdir/converter.py
-test cases/common/182 find override/subdir/gencodegen.py.in
-test cases/common/182 find override/subdir/meson.build
-test cases/common/182 find override/subprojects/sub.wrap
-test cases/common/182 find override/subprojects/sub/meson.build
-test cases/common/183 partial dependency/meson.build
-test cases/common/183 partial dependency/declare_dependency/main.c
-test cases/common/183 partial dependency/declare_dependency/meson.build
-test cases/common/183 partial dependency/declare_dependency/other.c
-test cases/common/183 partial dependency/declare_dependency/headers/foo.c
-test cases/common/183 partial dependency/declare_dependency/headers/foo.h
-test cases/common/184 openmp/main.c
-test cases/common/184 openmp/main.cpp
-test cases/common/184 openmp/main.f90
-test cases/common/184 openmp/meson.build
-test cases/common/185 same target name/file.c
-test cases/common/185 same target name/meson.build
-test cases/common/185 same target name/sub/file2.c
-test cases/common/185 same target name/sub/meson.build
-test cases/common/186 test depends/gen.py
-test cases/common/186 test depends/main.c
-test cases/common/186 test depends/meson.build
-test cases/common/186 test depends/test.py
-test cases/common/187 args flattening/meson.build
-test cases/common/188 dict/meson.build
-test cases/common/188 dict/prog.c
-test cases/common/189 check header/meson.build
-test cases/common/189 check header/ouagadougou.h
-test cases/common/19 header in file list/header.h
-test cases/common/19 header in file list/meson.build
-test cases/common/19 header in file list/prog.c
-test cases/common/190 install_mode/config.h.in
-test cases/common/190 install_mode/data_source.txt
-test cases/common/190 install_mode/foo.1
-test cases/common/190 install_mode/meson.build
-test cases/common/190 install_mode/rootdir.h
-test cases/common/190 install_mode/runscript.sh
-test cases/common/190 install_mode/stat.c
-test cases/common/190 install_mode/test.json
-test cases/common/190 install_mode/trivial.c
-test cases/common/190 install_mode/sub1/second.dat
-test cases/common/190 install_mode/sub2/stub
-test cases/common/191 subproject array version/meson.build
-test cases/common/191 subproject array version/subprojects/foo/meson.build
-test cases/common/192 feature option/meson.build
-test cases/common/192 feature option/meson_options.txt
-test cases/common/193 feature option disabled/meson.build
-test cases/common/193 feature option disabled/meson_options.txt
-test cases/common/194 static threads/lib1.c
-test cases/common/194 static threads/lib2.c
-test cases/common/194 static threads/meson.build
-test cases/common/194 static threads/prog.c
-test cases/common/195 generator in subdir/meson.build
-test cases/common/195 generator in subdir/com/mesonbuild/genprog.py
-test cases/common/195 generator in subdir/com/mesonbuild/meson.build
-test cases/common/195 generator in subdir/com/mesonbuild/subbie.inp
-test cases/common/195 generator in subdir/com/mesonbuild/testprog.c
-test cases/common/196 subproject with features/meson.build
-test cases/common/196 subproject with features/meson_options.txt
-test cases/common/196 subproject with features/nothing.c
-test cases/common/196 subproject with features/subprojects/auto_sub_with_missing_dep/meson.build
-test cases/common/196 subproject with features/subprojects/disabled_sub/meson.build
-test cases/common/196 subproject with features/subprojects/disabled_sub/lib/meson.build
-test cases/common/196 subproject with features/subprojects/disabled_sub/lib/sub.c
-test cases/common/196 subproject with features/subprojects/disabled_sub/lib/sub.h
-test cases/common/196 subproject with features/subprojects/sub/meson.build
-test cases/common/196 subproject with features/subprojects/sub/lib/meson.build
-test cases/common/196 subproject with features/subprojects/sub/lib/sub.c
-test cases/common/196 subproject with features/subprojects/sub/lib/sub.h
-test cases/common/197 function attributes/meson.build
-test cases/common/197 function attributes/meson_options.txt
-test cases/common/197 function attributes/test.json
-test cases/common/198 broken subproject/meson.build
-test cases/common/198 broken subproject/subprojects/broken/broken.c
-test cases/common/198 broken subproject/subprojects/broken/meson.build
-test cases/common/199 argument syntax/meson.build
-test cases/common/2 cpp/VERSIONFILE
-test cases/common/2 cpp/cpp.C
-test cases/common/2 cpp/meson.build
-test cases/common/2 cpp/something.txt
-test cases/common/2 cpp/trivial.cc
-test cases/common/20 global arg/meson.build
-test cases/common/20 global arg/prog.c
-test cases/common/20 global arg/prog.cc
-test cases/common/200 install name_prefix name_suffix/libfile.c
-test cases/common/200 install name_prefix name_suffix/meson.build
-test cases/common/200 install name_prefix name_suffix/test.json
-test cases/common/201 kwarg entry/meson.build
-test cases/common/201 kwarg entry/prog.c
-test cases/common/201 kwarg entry/test.json
-test cases/common/201 kwarg entry/inc/prog.h
-test cases/common/202 custom target build by default/docgen.py
-test cases/common/202 custom target build by default/meson.build
-test cases/common/202 custom target build by default/test.json
-test cases/common/203 find_library and headers/foo.h
-test cases/common/203 find_library and headers/meson.build
-test cases/common/204 line continuation/meson.build
-test cases/common/205 native file path override/main.cpp
-test cases/common/205 native file path override/meson.build
-test cases/common/205 native file path override/nativefile.ini
-test cases/common/205 native file path override/test.json
-test cases/common/206 tap tests/cat.c
-test cases/common/206 tap tests/issue7515.txt
-test cases/common/206 tap tests/meson.build
-test cases/common/206 tap tests/tester.c
-test cases/common/207 warning level 0/main.cpp
-test cases/common/207 warning level 0/meson.build
-test cases/common/208 link custom/custom_stlib.py
-test cases/common/208 link custom/custom_target.c
-test cases/common/208 link custom/custom_target.py
-test cases/common/208 link custom/dummy.c
-test cases/common/208 link custom/lib.c
-test cases/common/208 link custom/meson.build
-test cases/common/208 link custom/outerlib.c
-test cases/common/208 link custom/prog.c
-test cases/common/209 link custom_i single from multiple/generate_conflicting_stlibs.py
-test cases/common/209 link custom_i single from multiple/meson.build
-test cases/common/209 link custom_i single from multiple/prog.c
-test cases/common/21 target arg/func.c
-test cases/common/21 target arg/func2.c
-test cases/common/21 target arg/meson.build
-test cases/common/21 target arg/prog.cc
-test cases/common/21 target arg/prog2.cc
-test cases/common/210 link custom_i multiple from multiple/generate_stlibs.py
-test cases/common/210 link custom_i multiple from multiple/meson.build
-test cases/common/210 link custom_i multiple from multiple/prog.c
-test cases/common/211 dependency get_variable method/meson.build
-test cases/common/211 dependency get_variable method/test.json
-test cases/common/212 source set configuration_data/a.c
-test cases/common/212 source set configuration_data/all.h
-test cases/common/212 source set configuration_data/f.c
-test cases/common/212 source set configuration_data/g.c
-test cases/common/212 source set configuration_data/meson.build
-test cases/common/212 source set configuration_data/nope.c
-test cases/common/212 source set configuration_data/subdir/b.c
-test cases/common/212 source set configuration_data/subdir/meson.build
-test cases/common/213 source set dictionary/a.c
-test cases/common/213 source set dictionary/all.h
-test cases/common/213 source set dictionary/f.c
-test cases/common/213 source set dictionary/g.c
-test cases/common/213 source set dictionary/meson.build
-test cases/common/213 source set dictionary/nope.c
-test cases/common/213 source set dictionary/subdir/b.c
-test cases/common/213 source set dictionary/subdir/meson.build
-test cases/common/214 source set custom target/a.c
-test cases/common/214 source set custom target/all.h
-test cases/common/214 source set custom target/cp.py
-test cases/common/214 source set custom target/f.c
-test cases/common/214 source set custom target/g.c
-test cases/common/214 source set custom target/meson.build
-test cases/common/215 source set realistic example/common.h
-test cases/common/215 source set realistic example/main.cc
-test cases/common/215 source set realistic example/meson.build
-test cases/common/215 source set realistic example/not-found.cc
-test cases/common/215 source set realistic example/was-found.cc
-test cases/common/215 source set realistic example/zlib.cc
-test cases/common/215 source set realistic example/boards/meson.build
-test cases/common/215 source set realistic example/boards/arm/aarch64.cc
-test cases/common/215 source set realistic example/boards/arm/arm.cc
-test cases/common/215 source set realistic example/boards/arm/arm.h
-test cases/common/215 source set realistic example/boards/arm/arm32.cc
-test cases/common/215 source set realistic example/boards/arm/versatilepb.cc
-test cases/common/215 source set realistic example/boards/arm/virt.cc
-test cases/common/215 source set realistic example/boards/arm/xlnx_zcu102.cc
-test cases/common/215 source set realistic example/boards/x86/pc.cc
-test cases/common/215 source set realistic example/config/aarch64
-test cases/common/215 source set realistic example/config/arm
-test cases/common/215 source set realistic example/config/x86
-test cases/common/215 source set realistic example/devices/meson.build
-test cases/common/215 source set realistic example/devices/virtio-mmio.cc
-test cases/common/215 source set realistic example/devices/virtio-pci.cc
-test cases/common/215 source set realistic example/devices/virtio.cc
-test cases/common/215 source set realistic example/devices/virtio.h
-test cases/common/216 custom target input extracted objects/check_object.py
-test cases/common/216 custom target input extracted objects/meson.build
-test cases/common/216 custom target input extracted objects/libdir/gen.py
-test cases/common/216 custom target input extracted objects/libdir/meson.build
-test cases/common/216 custom target input extracted objects/libdir/source.c
-test cases/common/217 test priorities/meson.build
-test cases/common/217 test priorities/testprog.py
-test cases/common/218 include_dir dot/meson.build
-test cases/common/218 include_dir dot/rone.h
-test cases/common/218 include_dir dot/src/main.c
-test cases/common/218 include_dir dot/src/meson.build
-test cases/common/218 include_dir dot/src/rone.c
-test cases/common/219 include_type dependency/main.cpp
-test cases/common/219 include_type dependency/meson.build
-test cases/common/219 include_type dependency/pch/test.hpp
-test cases/common/219 include_type dependency/subprojects/subDep/meson.build
-test cases/common/22 object extraction/check-obj.py
-test cases/common/22 object extraction/create-source.py
-test cases/common/22 object extraction/header.h
-test cases/common/22 object extraction/lib.c
-test cases/common/22 object extraction/lib2.c
-test cases/common/22 object extraction/main.c
-test cases/common/22 object extraction/meson.build
-test cases/common/22 object extraction/src/lib.c
-test cases/common/220 fs module/meson.build
-test cases/common/220 fs module/subdir/meson.build
-test cases/common/220 fs module/subdir/subdirfile.txt
-test cases/common/220 fs module/subprojects/subbie/meson.build
-test cases/common/220 fs module/subprojects/subbie/subprojectfile.txt
-test cases/common/220 fs module/subprojects/subbie/subsub/meson.build
-test cases/common/220 fs module/subprojects/subbie/subsub/subsubfile.txt
-test cases/common/221 zlib/meson.build
-test cases/common/222 native prop/crossfile.ini
-test cases/common/222 native prop/meson.build
-test cases/common/222 native prop/nativefile.ini
-test cases/common/223 persubproject options/foo.c
-test cases/common/223 persubproject options/main.cpp
-test cases/common/223 persubproject options/meson.build
-test cases/common/223 persubproject options/test.json
-test cases/common/223 persubproject options/subprojects/sub1/foo.c
-test cases/common/223 persubproject options/subprojects/sub1/meson.build
-test cases/common/223 persubproject options/subprojects/sub2/foo.c
-test cases/common/223 persubproject options/subprojects/sub2/foo.cpp
-test cases/common/223 persubproject options/subprojects/sub2/meson.build
-test cases/common/224 arithmetic operators/meson.build
-test cases/common/225 link language/c_linkage.cpp
-test cases/common/225 link language/c_linkage.h
-test cases/common/225 link language/lib.cpp
-test cases/common/225 link language/main.c
-test cases/common/225 link language/meson.build
-test cases/common/226 link depends indexed custom target/check_arch.py
-test cases/common/226 link depends indexed custom target/foo.c
-test cases/common/226 link depends indexed custom target/make_file.py
-test cases/common/226 link depends indexed custom target/meson.build
-test cases/common/227 very long commmand line/codegen.py
-test cases/common/227 very long commmand line/main.c
-test cases/common/227 very long commmand line/meson.build
-test cases/common/227 very long commmand line/name_gen.py
-test cases/common/228 custom_target source/a
-test cases/common/228 custom_target source/meson.build
-test cases/common/228 custom_target source/x.py
-test cases/common/229 disabler array addition/meson.build
-test cases/common/229 disabler array addition/test.c
-test cases/common/23 endian/meson.build
-test cases/common/23 endian/prog.c
-test cases/common/230 external project/app.c
-test cases/common/230 external project/func.c
-test cases/common/230 external project/func.h
-test cases/common/230 external project/meson.build
-test cases/common/230 external project/test.json
-test cases/common/230 external project/libfoo/configure
-test cases/common/230 external project/libfoo/libfoo.c
-test cases/common/230 external project/libfoo/libfoo.h
-test cases/common/230 external project/libfoo/meson.build
-test cases/common/231 subdir files/meson.build
-test cases/common/231 subdir files/subdir/meson.build
-test cases/common/231 subdir files/subdir/prog.c
-test cases/common/232 dependency allow_fallback/meson.build
-test cases/common/232 dependency allow_fallback/subprojects/foob/meson.build
-test cases/common/232 dependency allow_fallback/subprojects/foob3/meson.build
-test cases/common/233 wrap case/meson.build
-test cases/common/233 wrap case/prog.c
-test cases/common/233 wrap case/subprojects/up_down.wrap
-test cases/common/233 wrap case/subprojects/up_down/meson.build
-test cases/common/233 wrap case/subprojects/up_down/up_down.h
-test cases/common/234 get_file_contents/.gitattributes
-test cases/common/234 get_file_contents/VERSION
-test cases/common/234 get_file_contents/meson.build
-test cases/common/234 get_file_contents/utf-16-text
-test cases/common/234 get_file_contents/other/meson.build
-test cases/common/235 invalid standard overriden to valid/main.c
-test cases/common/235 invalid standard overriden to valid/meson.build
-test cases/common/235 invalid standard overriden to valid/test.json
-test cases/common/236 proper args splitting/main.c
-test cases/common/236 proper args splitting/meson.build
-test cases/common/236 proper args splitting/test.json
-test cases/common/237 fstrings/meson.build
-test cases/common/238 dependency include_type inconsistency/meson.build
-test cases/common/238 dependency include_type inconsistency/bar/meson.build
-test cases/common/238 dependency include_type inconsistency/subprojects/baz.wrap
-test cases/common/238 dependency include_type inconsistency/subprojects/foo.wrap
-test cases/common/238 dependency include_type inconsistency/subprojects/baz/meson.build
-test cases/common/238 dependency include_type inconsistency/subprojects/foo/meson.build
-test cases/common/239 includedir violation/meson.build
-test cases/common/239 includedir violation/test.json
-test cases/common/239 includedir violation/subprojects/sub/meson.build
-test cases/common/239 includedir violation/subprojects/sub/include/placeholder.h
-test cases/common/24 library versions/lib.c
-test cases/common/24 library versions/meson.build
-test cases/common/24 library versions/test.json
-test cases/common/24 library versions/subdir/meson.build
-test cases/common/240 dependency native host == build/meson.build
-test cases/common/240 dependency native host == build/test.json
-test cases/common/241 set and get variable/meson.build
-test cases/common/241 set and get variable/test1.txt
-test cases/common/241 set and get variable/test2.txt
-test cases/common/242 custom target feed/data_source.txt
-test cases/common/242 custom target feed/meson.build
-test cases/common/242 custom target feed/my_compiler.py
-test cases/common/242 custom target feed/test.json
-test cases/common/243 escape++/meson.build
-test cases/common/243 escape++/test.c
-test cases/common/244 variable scope/meson.build
-test cases/common/245 custom target index source/code_source.c
-test cases/common/245 custom target index source/copyfile.py
-test cases/common/245 custom target index source/copyfile2.py
-test cases/common/245 custom target index source/header_source.h
-test cases/common/245 custom target index source/main.c
-test cases/common/245 custom target index source/meson.build
-test cases/common/246 dependency fallbacks/meson.build
-test cases/common/246 dependency fallbacks/subprojects/png/meson.build
-test cases/common/247 deprecated option/meson.build
-test cases/common/247 deprecated option/meson_options.txt
-test cases/common/247 deprecated option/test.json
-test cases/common/248 install_emptydir/meson.build
-test cases/common/248 install_emptydir/test.json
-test cases/common/249 install_symlink/datafile.dat
-test cases/common/249 install_symlink/meson.build
-test cases/common/249 install_symlink/test.json
-test cases/common/25 config subdir/meson.build
-test cases/common/25 config subdir/include/config.h.in
-test cases/common/25 config subdir/include/meson.build
-test cases/common/25 config subdir/src/meson.build
-test cases/common/25 config subdir/src/prog.c
-test cases/common/250 system include dir/main.cpp
-test cases/common/250 system include dir/meson.build
-test cases/common/250 system include dir/lib/lib.hpp
-test cases/common/251 add_project_dependencies/lib.c
-test cases/common/251 add_project_dependencies/main.c
-test cases/common/251 add_project_dependencies/meson.build
-test cases/common/251 add_project_dependencies/inc/lib.h
-test cases/common/251 subproject dependency variables/meson.build
-test cases/common/251 subproject dependency variables/test.json
-test cases/common/251 subproject dependency variables/subprojects/subfiles/foo.c
-test cases/common/251 subproject dependency variables/subprojects/subfiles/meson.build
-test cases/common/251 subproject dependency variables/subprojects/subfiles/subdir/foo.c
-test cases/common/251 subproject dependency variables/subprojects/subfiles/subdir2/foo.c
-test cases/common/253 long output/dumper.c
-test cases/common/253 long output/meson.build
-test cases/common/253 subproject extracted objects/foo.c
-test cases/common/253 subproject extracted objects/meson.build
-test cases/common/253 subproject extracted objects/test.json
-test cases/common/253 subproject extracted objects/subprojects/myobjects/cpplib.cpp
-test cases/common/253 subproject extracted objects/subprojects/myobjects/cpplib.h
-test cases/common/253 subproject extracted objects/subprojects/myobjects/meson.build
-test cases/common/26 find program/meson.build
-test cases/common/26 find program/print-version-with-prefix.py
-test cases/common/26 find program/print-version.py
-test cases/common/26 find program/source.in
-test cases/common/26 find program/scripts/test_subdir.py
-test cases/common/27 multiline string/meson.build
-test cases/common/28 try compile/invalid.c
-test cases/common/28 try compile/meson.build
-test cases/common/28 try compile/valid.c
-test cases/common/29 compiler id/meson.build
-test cases/common/3 static/libfile.c
-test cases/common/3 static/libfile2.c
-test cases/common/3 static/meson.build
-test cases/common/3 static/meson_options.txt
-test cases/common/30 sizeof/config.h.in
-test cases/common/30 sizeof/meson.build
-test cases/common/30 sizeof/prog.c.in
-test cases/common/31 define10/config.h.in
-test cases/common/31 define10/meson.build
-test cases/common/31 define10/prog.c
-test cases/common/32 has header/meson.build
-test cases/common/32 has header/ouagadougou.h
-test cases/common/33 run program/check-env.py
-test cases/common/33 run program/get-version.py
-test cases/common/33 run program/meson.build
-test cases/common/33 run program/scripts/hello.bat
-test cases/common/33 run program/scripts/hello.sh
-test cases/common/34 logic ops/meson.build
-test cases/common/35 string operations/meson.build
-test cases/common/36 has function/meson.build
-test cases/common/37 has member/meson.build
-test cases/common/38 alignment/meson.build
-test cases/common/39 library chain/main.c
-test cases/common/39 library chain/meson.build
-test cases/common/39 library chain/test.json
-test cases/common/39 library chain/subdir/lib1.c
-test cases/common/39 library chain/subdir/meson.build
-test cases/common/39 library chain/subdir/subdir2/lib2.c
-test cases/common/39 library chain/subdir/subdir2/meson.build
-test cases/common/39 library chain/subdir/subdir3/lib3.c
-test cases/common/39 library chain/subdir/subdir3/meson.build
-test cases/common/4 shared/libfile.c
-test cases/common/4 shared/meson.build
-test cases/common/40 options/meson.build
-test cases/common/40 options/meson_options.txt
-test cases/common/41 test args/cmd_args.c
-test cases/common/41 test args/copyfile.py
-test cases/common/41 test args/env2vars.c
-test cases/common/41 test args/envvars.c
-test cases/common/41 test args/meson.build
-test cases/common/41 test args/tester.c
-test cases/common/41 test args/tester.py
-test cases/common/41 test args/testfile.txt
-test cases/common/42 subproject/meson.build
-test cases/common/42 subproject/test.json
-test cases/common/42 subproject/user.c
-test cases/common/42 subproject/subprojects/sublib/meson.build
-test cases/common/42 subproject/subprojects/sublib/simpletest.c
-test cases/common/42 subproject/subprojects/sublib/sublib.c
-test cases/common/42 subproject/subprojects/sublib/include/subdefs.h
-test cases/common/43 subproject options/meson.build
-test cases/common/43 subproject options/meson_options.txt
-test cases/common/43 subproject options/subprojects/subproject/meson.build
-test cases/common/43 subproject options/subprojects/subproject/meson_options.txt
-test cases/common/44 pkgconfig-gen/answer.c
-test cases/common/44 pkgconfig-gen/foo.c
-test cases/common/44 pkgconfig-gen/meson.build
-test cases/common/44 pkgconfig-gen/simple.c
-test cases/common/44 pkgconfig-gen/simple.h
-test cases/common/44 pkgconfig-gen/simple5.c
-test cases/common/44 pkgconfig-gen/test.json
-test cases/common/44 pkgconfig-gen/dependencies/custom.c
-test cases/common/44 pkgconfig-gen/dependencies/exposed.c
-test cases/common/44 pkgconfig-gen/dependencies/internal.c
-test cases/common/44 pkgconfig-gen/dependencies/main.c
-test cases/common/44 pkgconfig-gen/dependencies/meson.build
-test cases/common/45 custom install dirs/datafile.cat
-test cases/common/45 custom install dirs/meson.build
-test cases/common/45 custom install dirs/prog.1
-test cases/common/45 custom install dirs/prog.c
-test cases/common/45 custom install dirs/sample.h
-test cases/common/45 custom install dirs/test.json
-test cases/common/45 custom install dirs/subdir/datafile.dog
-test cases/common/46 subproject subproject/meson.build
-test cases/common/46 subproject subproject/prog.c
-test cases/common/46 subproject subproject/subprojects/a/a.c
-test cases/common/46 subproject subproject/subprojects/a/meson.build
-test cases/common/46 subproject subproject/subprojects/b/b.c
-test cases/common/46 subproject subproject/subprojects/b/meson.build
-test cases/common/46 subproject subproject/subprojects/c/meson.build
-test cases/common/47 same file name/meson.build
-test cases/common/47 same file name/prog.c
-test cases/common/47 same file name/d1/file.c
-test cases/common/47 same file name/d2/file.c
-test cases/common/48 file grabber/a.c
-test cases/common/48 file grabber/b.c
-test cases/common/48 file grabber/c.c
-test cases/common/48 file grabber/grabber.bat
-test cases/common/48 file grabber/grabber.sh
-test cases/common/48 file grabber/grabber2.bat
-test cases/common/48 file grabber/meson.build
-test cases/common/48 file grabber/prog.c
-test cases/common/48 file grabber/subdir/meson.build
-test cases/common/48 file grabber/subdir/suba.c
-test cases/common/48 file grabber/subdir/subb.c
-test cases/common/48 file grabber/subdir/subc.c
-test cases/common/48 file grabber/subdir/subprog.c
-test cases/common/49 custom target/data_source.txt
-test cases/common/49 custom target/meson.build
-test cases/common/49 custom target/my_compiler.py
-test cases/common/49 custom target/test.json
-test cases/common/49 custom target/depfile/dep.py
-test cases/common/49 custom target/depfile/meson.build
-test cases/common/5 linkstatic/libfile.c
-test cases/common/5 linkstatic/libfile2.c
-test cases/common/5 linkstatic/libfile3.c
-test cases/common/5 linkstatic/libfile4.c
-test cases/common/5 linkstatic/main.c
-test cases/common/5 linkstatic/meson.build
-test cases/common/50 custom target chain/data_source.txt
-test cases/common/50 custom target chain/meson.build
-test cases/common/50 custom target chain/my_compiler.py
-test cases/common/50 custom target chain/my_compiler2.py
-test cases/common/50 custom target chain/test.json
-test cases/common/50 custom target chain/usetarget/meson.build
-test cases/common/50 custom target chain/usetarget/myexe.c
-test cases/common/50 custom target chain/usetarget/subcomp.py
-test cases/common/51 run target/check-env.py
-test cases/common/51 run target/check_exists.py
-test cases/common/51 run target/configure.in
-test cases/common/51 run target/converter.py
-test cases/common/51 run target/fakeburner.py
-test cases/common/51 run target/helloprinter.c
-test cases/common/51 run target/meson.build
-test cases/common/51 run target/subdir/textprinter.py
-test cases/common/52 object generator/meson.build
-test cases/common/52 object generator/obj_generator.py
-test cases/common/52 object generator/prog.c
-test cases/common/52 object generator/source.c
-test cases/common/52 object generator/source2.c
-test cases/common/52 object generator/source3.c
-test cases/common/53 install script/customtarget.py
-test cases/common/53 install script/meson.build
-test cases/common/53 install script/myinstall.py
-test cases/common/53 install script/prog.c
-test cases/common/53 install script/test.json
-test cases/common/53 install script/src/a file.txt
-test cases/common/53 install script/src/foo.c
-test cases/common/53 install script/src/meson.build
-test cases/common/53 install script/src/myinstall.py
-test cases/common/54 custom target source output/generator.py
-test cases/common/54 custom target source output/main.c
-test cases/common/54 custom target source output/meson.build
-test cases/common/55 exe static shared/meson.build
-test cases/common/55 exe static shared/prog.c
-test cases/common/55 exe static shared/shlib2.c
-test cases/common/55 exe static shared/stat.c
-test cases/common/55 exe static shared/stat2.c
-test cases/common/55 exe static shared/subdir/exports.h
-test cases/common/55 exe static shared/subdir/meson.build
-test cases/common/55 exe static shared/subdir/shlib.c
-test cases/common/56 array methods/a.txt
-test cases/common/56 array methods/b.txt
-test cases/common/56 array methods/c.txt
-test cases/common/56 array methods/meson.build
-test cases/common/57 custom header generator/input.def
-test cases/common/57 custom header generator/makeheader.py
-test cases/common/57 custom header generator/meson.build
-test cases/common/57 custom header generator/prog.c
-test cases/common/57 custom header generator/somefile.txt
-test cases/common/58 multiple generators/data2.dat
-test cases/common/58 multiple generators/main.cpp
-test cases/common/58 multiple generators/meson.build
-test cases/common/58 multiple generators/mygen.py
-test cases/common/58 multiple generators/subdir/data.dat
-test cases/common/58 multiple generators/subdir/meson.build
-test cases/common/59 install subdir/meson.build
-test cases/common/59 install subdir/test.json
-test cases/common/59 install subdir/nested_elided/sub/eighth.dat
-test cases/common/59 install subdir/nested_elided/sub/dircheck/ninth.dat
-test cases/common/59 install subdir/sub/sub1/third.dat
-test cases/common/59 install subdir/sub1/second.dat
-test cases/common/59 install subdir/sub2/excluded-three.dat
-test cases/common/59 install subdir/sub2/one.dat
-test cases/common/59 install subdir/sub2/dircheck/excluded-three.dat
-test cases/common/59 install subdir/sub2/excluded/two.dat
-test cases/common/59 install subdir/sub_elided/fourth.dat
-test cases/common/59 install subdir/sub_elided/dircheck/fifth.dat
-test cases/common/59 install subdir/subdir/meson.build
-test cases/common/59 install subdir/subdir/sub1/data1.dat
-test cases/common/59 install subdir/subdir/sub1/sub2/data2.dat
-test cases/common/59 install subdir/subdir/sub_elided/sixth.dat
-test cases/common/59 install subdir/subdir/sub_elided/dircheck/seventh.dat
-test cases/common/6 linkshared/cpplib.cpp
-test cases/common/6 linkshared/cpplib.h
-test cases/common/6 linkshared/cppmain.cpp
-test cases/common/6 linkshared/libfile.c
-test cases/common/6 linkshared/main.c
-test cases/common/6 linkshared/meson.build
-test cases/common/6 linkshared/test.json
-test cases/common/60 foreach/meson.build
-test cases/common/60 foreach/prog1.c
-test cases/common/60 foreach/prog2.c
-test cases/common/60 foreach/prog3.c
-test cases/common/60 foreach/test.json
-test cases/common/61 number arithmetic/meson.build
-test cases/common/62 string arithmetic/meson.build
-test cases/common/62 string arithmetic/test.json
-test cases/common/63 array arithmetic/meson.build
-test cases/common/64 arithmetic bidmas/meson.build
-test cases/common/65 build always/main.c
-test cases/common/65 build always/meson.build
-test cases/common/65 build always/version.c.in
-test cases/common/65 build always/version.h
-test cases/common/65 build always/version_gen.py
-test cases/common/66 vcstag/meson.build
-test cases/common/66 vcstag/tagprog.c
-test cases/common/66 vcstag/vcstag.c.in
-test cases/common/66 vcstag/version.py
-test cases/common/67 modules/meson.build
-test cases/common/67 modules/meson_options.txt
-test cases/common/68 should fail/failing.c
-test cases/common/68 should fail/meson.build
-test cases/common/69 configure file in custom target/meson.build
-test cases/common/69 configure file in custom target/inc/confdata.in
-test cases/common/69 configure file in custom target/inc/meson.build
-test cases/common/69 configure file in custom target/src/meson.build
-test cases/common/69 configure file in custom target/src/mycompiler.py
-test cases/common/7 mixed/func.c
-test cases/common/7 mixed/main.cc
-test cases/common/7 mixed/meson.build
-test cases/common/70 external test program/meson.build
-test cases/common/70 external test program/mytest.py
-test cases/common/71 ctarget dependency/gen1.py
-test cases/common/71 ctarget dependency/gen2.py
-test cases/common/71 ctarget dependency/input.dat
-test cases/common/71 ctarget dependency/meson.build
-test cases/common/72 shared subproject/a.c
-test cases/common/72 shared subproject/meson.build
-test cases/common/72 shared subproject/subprojects/B/b.c
-test cases/common/72 shared subproject/subprojects/B/meson.build
-test cases/common/72 shared subproject/subprojects/C/c.c
-test cases/common/72 shared subproject/subprojects/C/meson.build
-test cases/common/73 shared subproject 2/a.c
-test cases/common/73 shared subproject 2/meson.build
-test cases/common/73 shared subproject 2/subprojects/B/b.c
-test cases/common/73 shared subproject 2/subprojects/B/meson.build
-test cases/common/73 shared subproject 2/subprojects/C/c.c
-test cases/common/73 shared subproject 2/subprojects/C/meson.build
-test cases/common/74 file object/lib.c
-test cases/common/74 file object/meson.build
-test cases/common/74 file object/prog.c
-test cases/common/74 file object/subdir1/lib.c
-test cases/common/74 file object/subdir1/meson.build
-test cases/common/74 file object/subdir1/prog.c
-test cases/common/74 file object/subdir2/lib.c
-test cases/common/74 file object/subdir2/meson.build
-test cases/common/74 file object/subdir2/prog.c
-test cases/common/75 custom subproject dir/a.c
-test cases/common/75 custom subproject dir/meson.build
-test cases/common/75 custom subproject dir/custom_subproject_dir/B/b.c
-test cases/common/75 custom subproject dir/custom_subproject_dir/B/meson.build
-test cases/common/75 custom subproject dir/custom_subproject_dir/C/c.c
-test cases/common/75 custom subproject dir/custom_subproject_dir/C/meson.build
-test cases/common/76 has type/meson.build
-test cases/common/77 extract from nested subdir/meson.build
-test cases/common/77 extract from nested subdir/src/meson.build
-test cases/common/77 extract from nested subdir/src/first/lib_first.c
-test cases/common/77 extract from nested subdir/src/first/meson.build
-test cases/common/77 extract from nested subdir/tst/meson.build
-test cases/common/77 extract from nested subdir/tst/first/exe_first.c
-test cases/common/77 extract from nested subdir/tst/first/meson.build
-test cases/common/78 internal dependency/meson.build
-test cases/common/78 internal dependency/proj1/meson.build
-test cases/common/78 internal dependency/proj1/proj1f1.c
-test cases/common/78 internal dependency/proj1/proj1f2.c
-test cases/common/78 internal dependency/proj1/proj1f3.c
-test cases/common/78 internal dependency/proj1/include/proj1.h
-test cases/common/78 internal dependency/src/main.c
-test cases/common/78 internal dependency/src/meson.build
-test cases/common/79 same basename/exe1.c
-test cases/common/79 same basename/exe2.c
-test cases/common/79 same basename/lib.c
-test cases/common/79 same basename/meson.build
-test cases/common/79 same basename/sharedsub/meson.build
-test cases/common/79 same basename/staticsub/meson.build
-test cases/common/8 install/gendir.py
-test cases/common/8 install/meson.build
-test cases/common/8 install/prog.c
-test cases/common/8 install/stat.c
-test cases/common/8 install/test.json
-test cases/common/80 declare dep/main.c
-test cases/common/80 declare dep/meson.build
-test cases/common/80 declare dep/entity/entity.h
-test cases/common/80 declare dep/entity/entity1.c
-test cases/common/80 declare dep/entity/entity2.c
-test cases/common/80 declare dep/entity/meson.build
-test cases/common/81 extract all/extractor.h
-test cases/common/81 extract all/four.c
-test cases/common/81 extract all/meson.build
-test cases/common/81 extract all/one.c
-test cases/common/81 extract all/prog.c
-test cases/common/81 extract all/three.c
-test cases/common/81 extract all/two.c
-test cases/common/82 add language/meson.build
-test cases/common/82 add language/prog.c
-test cases/common/82 add language/prog.cc
-test cases/common/83 identical target name in subproject/bar.c
-test cases/common/83 identical target name in subproject/meson.build
-test cases/common/83 identical target name in subproject/true.py
-test cases/common/83 identical target name in subproject/subprojects/foo/bar.c
-test cases/common/83 identical target name in subproject/subprojects/foo/meson.build
-test cases/common/83 identical target name in subproject/subprojects/foo/true.py
-test cases/common/84 plusassign/meson.build
-test cases/common/85 skip subdir/meson.build
-test cases/common/85 skip subdir/subdir1/meson.build
-test cases/common/85 skip subdir/subdir1/subdir2/meson.build
-test cases/common/86 private include/meson.build
-test cases/common/86 private include/stlib/compiler.py
-test cases/common/86 private include/stlib/foo1.def
-test cases/common/86 private include/stlib/foo2.def
-test cases/common/86 private include/stlib/meson.build
-test cases/common/86 private include/user/libuser.c
-test cases/common/86 private include/user/meson.build
-test cases/common/87 default options/meson.build
-test cases/common/87 default options/subprojects/sub1/meson.build
-test cases/common/87 default options/subprojects/sub1/meson_options.txt
-test cases/common/88 dep fallback/gensrc.py
-test cases/common/88 dep fallback/meson.build
-test cases/common/88 dep fallback/tester.c
-test cases/common/88 dep fallback/subprojects/boblib/bob.c
-test cases/common/88 dep fallback/subprojects/boblib/bob.h
-test cases/common/88 dep fallback/subprojects/boblib/genbob.py
-test cases/common/88 dep fallback/subprojects/boblib/meson.build
-test cases/common/88 dep fallback/subprojects/dummylib/meson.build
-test cases/common/89 default library/ef.cpp
-test cases/common/89 default library/ef.h
-test cases/common/89 default library/eftest.cpp
-test cases/common/89 default library/meson.build
-test cases/common/9 header install/meson.build
-test cases/common/9 header install/rootdir.h
-test cases/common/9 header install/subdir.h
-test cases/common/9 header install/test.json
-test cases/common/9 header install/child/childdir.h
-test cases/common/9 header install/sub/fileheader.h
-test cases/common/9 header install/sub/meson.build
-test cases/common/9 header install/vanishing_subdir/meson.build
-test cases/common/9 header install/vanishing_subdir/vanished.h
-test cases/common/90 gen extra/meson.build
-test cases/common/90 gen extra/name.dat
-test cases/common/90 gen extra/name.l
-test cases/common/90 gen extra/plain.c
-test cases/common/90 gen extra/srcgen.py
-test cases/common/90 gen extra/srcgen2.py
-test cases/common/90 gen extra/srcgen3.py
-test cases/common/90 gen extra/upper.c
-test cases/common/91 benchmark/delayer.c
-test cases/common/91 benchmark/meson.build
-test cases/common/92 test workdir/meson.build
-test cases/common/92 test workdir/opener.c
-test cases/common/92 test workdir/subdir/checker.py
-test cases/common/92 test workdir/subdir/meson.build
-test cases/common/93 suites/exe1.c
-test cases/common/93 suites/exe2.c
-test cases/common/93 suites/meson.build
-test cases/common/93 suites/subprojects/sub/meson.build
-test cases/common/93 suites/subprojects/sub/sub1.c
-test cases/common/93 suites/subprojects/sub/sub2.c
-test cases/common/94 threads/meson.build
-test cases/common/94 threads/threadprog.c
-test cases/common/94 threads/threadprog.cpp
-test cases/common/95 manygen/depuser.c
-test cases/common/95 manygen/meson.build
-test cases/common/95 manygen/subdir/funcinfo.def
-test cases/common/95 manygen/subdir/manygen.py
-test cases/common/95 manygen/subdir/meson.build
-test cases/common/96 stringdef/meson.build
-test cases/common/96 stringdef/stringdef.c
-test cases/common/97 find program path/meson.build
-test cases/common/97 find program path/program.py
-test cases/common/98 subproject subdir/meson.build
-test cases/common/98 subproject subdir/prog.c
-test cases/common/98 subproject subdir/test.json
-test cases/common/98 subproject subdir/subprojects/sub_implicit.wrap
-test cases/common/98 subproject subdir/subprojects/sub/meson.build
-test cases/common/98 subproject subdir/subprojects/sub/lib/meson.build
-test cases/common/98 subproject subdir/subprojects/sub/lib/sub.c
-test cases/common/98 subproject subdir/subprojects/sub/lib/sub.h
-test cases/common/98 subproject subdir/subprojects/sub_implicit/meson.build
-test cases/common/98 subproject subdir/subprojects/sub_implicit/meson_options.txt
-test cases/common/98 subproject subdir/subprojects/sub_implicit/subprojects/subsub/foo.h
-test cases/common/98 subproject subdir/subprojects/sub_implicit/subprojects/subsub/meson.build
-test cases/common/98 subproject subdir/subprojects/sub_implicit/subprojects/subsub/subprojects/subsubsub.wrap
-test cases/common/98 subproject subdir/subprojects/sub_implicit/subprojects/subsub/subprojects/packagefiles/subsubsub-1.0.zip
-test cases/common/98 subproject subdir/subprojects/sub_novar/meson.build
-test cases/common/98 subproject subdir/subprojects/sub_static/meson.build
-test cases/common/99 postconf/meson.build
-test cases/common/99 postconf/postconf.py
-test cases/common/99 postconf/prog.c
-test cases/common/99 postconf/raw.dat
-test cases/csharp/1 basic/meson.build
-test cases/csharp/1 basic/prog.cs
-test cases/csharp/1 basic/test.json
-test cases/csharp/1 basic/text.cs
-test cases/csharp/2 library/helper.cs
-test cases/csharp/2 library/meson.build
-test cases/csharp/2 library/prog.cs
-test cases/csharp/2 library/test.json
-test cases/csharp/3 resource/TestRes.resx
-test cases/csharp/3 resource/meson.build
-test cases/csharp/3 resource/resprog.cs
-test cases/csharp/4 external dep/hello.txt
-test cases/csharp/4 external dep/meson.build
-test cases/csharp/4 external dep/prog.cs
-test cases/csharp/4 external dep/test.json
-test cases/cuda/1 simple/meson.build
-test cases/cuda/1 simple/prog.cu
-test cases/cuda/10 cuda dependency/meson.build
-test cases/cuda/10 cuda dependency/c/meson.build
-test cases/cuda/10 cuda dependency/c/prog.c
-test cases/cuda/10 cuda dependency/cpp/meson.build
-test cases/cuda/10 cuda dependency/cpp/prog.cc
-test cases/cuda/10 cuda dependency/modules/meson.build
-test cases/cuda/10 cuda dependency/modules/prog.cc
-test cases/cuda/10 cuda dependency/version_reqs/meson.build
-test cases/cuda/10 cuda dependency/version_reqs/prog.cc
-test cases/cuda/11 cuda dependency (nvcc)/meson.build
-test cases/cuda/11 cuda dependency (nvcc)/modules/meson.build
-test cases/cuda/11 cuda dependency (nvcc)/modules/prog.cu
-test cases/cuda/11 cuda dependency (nvcc)/version_reqs/meson.build
-test cases/cuda/11 cuda dependency (nvcc)/version_reqs/prog.cu
-test cases/cuda/12 cuda dependency (mixed)/kernel.cu
-test cases/cuda/12 cuda dependency (mixed)/meson.build
-test cases/cuda/12 cuda dependency (mixed)/prog.cpp
-test cases/cuda/13 cuda compiler setting/meson.build
-test cases/cuda/13 cuda compiler setting/nativefile.ini
-test cases/cuda/13 cuda compiler setting/prog.cu
-test cases/cuda/14 cuda has header symbol/meson.build
-test cases/cuda/15 sanitizer/meson.build
-test cases/cuda/15 sanitizer/prog.cu
-test cases/cuda/16 multistd/lib.cu
-test cases/cuda/16 multistd/main.cu
-test cases/cuda/16 multistd/meson.build
-test cases/cuda/2 split/lib.cu
-test cases/cuda/2 split/main.cpp
-test cases/cuda/2 split/meson.build
-test cases/cuda/2 split/static/lib.cu
-test cases/cuda/2 split/static/libsta.cu
-test cases/cuda/2 split/static/main_static.cpp
-test cases/cuda/2 split/static/meson.build
-test cases/cuda/3 cudamodule/meson.build
-test cases/cuda/3 cudamodule/prog.cu
-test cases/cuda/4 shared/main.cu
-test cases/cuda/4 shared/meson.build
-test cases/cuda/4 shared/shared/kernels.cu
-test cases/cuda/4 shared/shared/kernels.h
-test cases/cuda/4 shared/shared/meson.build
-test cases/cuda/5 threads/main.cu
-test cases/cuda/5 threads/meson.build
-test cases/cuda/5 threads/shared/kernels.cu
-test cases/cuda/5 threads/shared/kernels.h
-test cases/cuda/5 threads/shared/meson.build
-test cases/cuda/6 std/main.cu
-test cases/cuda/6 std/meson.build
-test cases/cuda/7 static vs runtime/main.cu
-test cases/cuda/7 static vs runtime/meson.build
-test cases/cuda/8 release/main.cu
-test cases/cuda/8 release/meson.build
-test cases/cuda/9 optimize for space/main.cu
-test cases/cuda/9 optimize for space/meson.build
-test cases/cython/1 basic/cytest.py
-test cases/cython/1 basic/meson.build
-test cases/cython/1 basic/test.json
-test cases/cython/1 basic/libdir/cstorer.pxd
-test cases/cython/1 basic/libdir/meson.build
-test cases/cython/1 basic/libdir/storer.c
-test cases/cython/1 basic/libdir/storer.h
-test cases/cython/1 basic/libdir/storer.pyx
-test cases/cython/2 generated sources/configure.pyx.in
-test cases/cython/2 generated sources/g.in
-test cases/cython/2 generated sources/gen.py
-test cases/cython/2 generated sources/generator.py
-test cases/cython/2 generated sources/meson.build
-test cases/cython/2 generated sources/test.py
-test cases/cython/2 generated sources/libdir/gen.py
-test cases/cython/2 generated sources/libdir/meson.build
-test cases/cython/3 cython_args/cythonargs.pyx
-test cases/cython/3 cython_args/meson.build
-test cases/cython/3 cython_args/test.py
-test cases/d/1 simple/app.d
-test cases/d/1 simple/meson.build
-test cases/d/1 simple/test.json
-test cases/d/1 simple/utils.d
-test cases/d/10 d cpp/cppmain.cpp
-test cases/d/10 d cpp/dmain.d
-test cases/d/10 d cpp/libfile.cpp
-test cases/d/10 d cpp/libfile.d
-test cases/d/10 d cpp/meson.build
-test cases/d/11 dub/.gitignore
-test cases/d/11 dub/meson.build
-test cases/d/11 dub/test.d
-test cases/d/12 root include directory/meson.build
-test cases/d/12 root include directory/some/meson.build
-test cases/d/12 root include directory/some/dlang/code.d
-test cases/d/12 root include directory/some/dlang/meson.build
-test cases/d/13 declare dep/meson.build
-test cases/d/13 declare dep/test.d
-test cases/d/13 declare dep/views/test.txt
-test cases/d/14 dub with deps/meson.build
-test cases/d/14 dub with deps/test.d
-test cases/d/15 compiler run checks/meson.build
-test cases/d/15 compiler run checks/test_sizeof.d
-test cases/d/16 code generation/exe.d
-test cases/d/16 code generation/generator.d
-test cases/d/16 code generation/input.txt
-test cases/d/16 code generation/meson.build
-test cases/d/2 static library/app.d
-test cases/d/2 static library/libstuff.d
-test cases/d/2 static library/meson.build
-test cases/d/2 static library/test.json
-test cases/d/3 shared library/app.d
-test cases/d/3 shared library/libstuff.d
-test cases/d/3 shared library/libstuff.di
-test cases/d/3 shared library/lld-test.py
-test cases/d/3 shared library/meson.build
-test cases/d/3 shared library/test.json
-test cases/d/3 shared library/sub/libstuff.d
-test cases/d/3 shared library/sub/meson.build
-test cases/d/4 library versions/lib.d
-test cases/d/4 library versions/meson.build
-test cases/d/4 library versions/test.json
-test cases/d/5 mixed/app.d
-test cases/d/5 mixed/libstuff.c
-test cases/d/5 mixed/meson.build
-test cases/d/5 mixed/test.json
-test cases/d/6 unittest/app.d
-test cases/d/6 unittest/meson.build
-test cases/d/6 unittest/second_unit.d
-test cases/d/6 unittest/test.json
-test cases/d/7 multilib/app.d
-test cases/d/7 multilib/meson.build
-test cases/d/7 multilib/say1.d
-test cases/d/7 multilib/say1.di
-test cases/d/7 multilib/say2.d
-test cases/d/7 multilib/say2.di
-test cases/d/7 multilib/test.json
-test cases/d/8 has multi arguments/meson.build
-test cases/d/9 features/app.d
-test cases/d/9 features/extra.d
-test cases/d/9 features/meson.build
-test cases/d/9 features/data/food.txt
-test cases/d/9 features/data/people.txt
-test cases/failing build/1 vala c werror/meson.build
-test cases/failing build/1 vala c werror/prog.vala
-test cases/failing build/1 vala c werror/unused-var.c
-test cases/failing build/2 hidden symbol/bob.c
-test cases/failing build/2 hidden symbol/bob.h
-test cases/failing build/2 hidden symbol/bobuser.c
-test cases/failing build/2 hidden symbol/meson.build
-test cases/failing build/3 pch disabled/meson.build
-test cases/failing build/3 pch disabled/c/meson.build
-test cases/failing build/3 pch disabled/c/prog.c
-test cases/failing build/3 pch disabled/c/pch/prog.h
-test cases/failing build/3 pch disabled/c/pch/prog_pch.c
-test cases/failing build/4 cmake subproject isolation/main.cpp
-test cases/failing build/4 cmake subproject isolation/meson.build
-test cases/failing build/4 cmake subproject isolation/test.json
-test cases/failing build/4 cmake subproject isolation/incDir/fileA.hpp
-test cases/failing build/4 cmake subproject isolation/subprojects/cmMod/CMakeLists.txt
-test cases/failing build/4 cmake subproject isolation/subprojects/cmMod/cmMod.cpp
-test cases/failing build/4 cmake subproject isolation/subprojects/cmMod/cmMod.hpp
-test cases/failing build/5 failed pickled/false.py
-test cases/failing build/5 failed pickled/meson.build
-test cases/failing test/1 trivial/main.c
-test cases/failing test/1 trivial/meson.build
-test cases/failing test/2 signal/main.c
-test cases/failing test/2 signal/meson.build
-test cases/failing test/3 ambiguous/main.c
-test cases/failing test/3 ambiguous/meson.build
-test cases/failing test/3 ambiguous/test_runner.sh
-test cases/failing test/4 hard error/main.c
-test cases/failing test/4 hard error/meson.build
-test cases/failing test/5 tap tests/meson.build
-test cases/failing test/5 tap tests/tester.c
-test cases/failing test/5 tap tests/tester_with_status.c
-test cases/failing test/6 xpass/meson.build
-test cases/failing test/6 xpass/xpass.c
-test cases/failing/1 project not first/meson.build
-test cases/failing/1 project not first/prog.c
-test cases/failing/1 project not first/test.json
-test cases/failing/10 out of bounds/meson.build
-test cases/failing/10 out of bounds/test.json
-test cases/failing/100 no glib-compile-resources/meson.build
-test cases/failing/100 no glib-compile-resources/test.json
-test cases/failing/100 no glib-compile-resources/trivial.gresource.xml
-test cases/failing/101 number in combo/meson.build
-test cases/failing/101 number in combo/nativefile.ini
-test cases/failing/101 number in combo/test.json
-test cases/failing/102 bool in combo/meson.build
-test cases/failing/102 bool in combo/meson_options.txt
-test cases/failing/102 bool in combo/nativefile.ini
-test cases/failing/102 bool in combo/test.json
-test cases/failing/103 compiler no lang/meson.build
-test cases/failing/103 compiler no lang/test.json
-test cases/failing/104 no fallback/meson.build
-test cases/failing/104 no fallback/test.json
-test cases/failing/104 no fallback/subprojects/foob/meson.build
-test cases/failing/105 feature require/meson.build
-test cases/failing/105 feature require/meson_options.txt
-test cases/failing/105 feature require/test.json
-test cases/failing/106 feature require.bis/meson.build
-test cases/failing/106 feature require.bis/meson_options.txt
-test cases/failing/106 feature require.bis/test.json
-test cases/failing/107 no build get_external_property/meson.build
-test cases/failing/107 no build get_external_property/test.json
-test cases/failing/108 enter subdir twice/meson.build
-test cases/failing/108 enter subdir twice/test.json
-test cases/failing/108 enter subdir twice/sub/meson.build
-test cases/failing/109 invalid fstring/meson.build
-test cases/failing/109 invalid fstring/test.json
-test cases/failing/109 invalid fstring/109 invalid fstring/meson.build
-test cases/failing/109 invalid fstring/109 invalid fstring/test.json
-test cases/failing/11 object arithmetic/meson.build
-test cases/failing/11 object arithmetic/test.json
-test cases/failing/110 compiler argument checking/meson.build
-test cases/failing/110 compiler argument checking/test.json
-test cases/failing/111 empty fallback/meson.build
-test cases/failing/111 empty fallback/test.json
-test cases/failing/111 empty fallback/subprojects/foo/meson.build
-test cases/failing/112 cmake executable dependency/meson.build
-test cases/failing/112 cmake executable dependency/test.json
-test cases/failing/112 cmake executable dependency/subprojects/cmlib/CMakeLists.txt
-test cases/failing/112 cmake executable dependency/subprojects/cmlib/main.c
-test cases/failing/113 allow_fallback with fallback/meson.build
-test cases/failing/113 allow_fallback with fallback/test.json
-test cases/failing/114 nonsensical bindgen/meson.build
-test cases/failing/114 nonsensical bindgen/test.json
-test cases/failing/114 nonsensical bindgen/src/header.h
-test cases/failing/114 nonsensical bindgen/src/source.c
-test cases/failing/115 run_target in test/meson.build
-test cases/failing/115 run_target in test/test.json
-test cases/failing/115 run_target in test/trivial.c
-test cases/failing/116 run_target in add_install_script/meson.build
-test cases/failing/116 run_target in add_install_script/test.json
-test cases/failing/116 run_target in add_install_script/trivial.c
-test cases/failing/117 pathsep in install_symlink/meson.build
-test cases/failing/117 pathsep in install_symlink/test.json
-test cases/failing/118 subproject version conflict/meson.build
-test cases/failing/118 subproject version conflict/test.json
-test cases/failing/118 subproject version conflict/subprojects/A/meson.build
-test cases/failing/118 subproject version conflict/subprojects/B/meson.build
-test cases/failing/119 structured source empty string/main.rs
-test cases/failing/119 structured source empty string/meson.build
-test cases/failing/119 structured source empty string/test.json
-test cases/failing/12 string arithmetic/meson.build
-test cases/failing/12 string arithmetic/test.json
-test cases/failing/120 structured_sources conflicts/main.rs
-test cases/failing/120 structured_sources conflicts/meson.build
-test cases/failing/120 structured_sources conflicts/test.json
-test cases/failing/121 missing compiler/meson.build
-test cases/failing/121 missing compiler/test.json
-test cases/failing/121 missing compiler/subprojects/sub/main.c
-test cases/failing/121 missing compiler/subprojects/sub/meson.build
-test cases/failing/122 cmake subproject error/meson.build
-test cases/failing/122 cmake subproject error/test.json
-test cases/failing/122 cmake subproject error/subprojects/cmlib/CMakeLists.txt
-test cases/failing/123 pkgconfig not relocatable outside prefix/meson.build
-test cases/failing/123 pkgconfig not relocatable outside prefix/test.json
-test cases/failing/123 subproject sandbox violation/meson.build
-test cases/failing/123 subproject sandbox violation/meson_options.txt
-test cases/failing/123 subproject sandbox violation/test.json
-test cases/failing/123 subproject sandbox violation/subprojects/subproj1/file.txt
-test cases/failing/123 subproject sandbox violation/subprojects/subproj1/meson.build
-test cases/failing/123 subproject sandbox violation/subprojects/subproj1/nested/meson.build
-test cases/failing/123 subproject sandbox violation/subprojects/subproj2/file.txt
-test cases/failing/123 subproject sandbox violation/subprojects/subproj2/meson.build
-test cases/failing/123 subproject sandbox violation/subprojects/subproj2/nested/meson.build
-test cases/failing/123 subproject sandbox violation/subprojects/subproj3/file.txt
-test cases/failing/123 subproject sandbox violation/subprojects/subproj3/meson.build
-test cases/failing/124 override and add_project_dependency/lib.c
-test cases/failing/124 override and add_project_dependency/meson.build
-test cases/failing/124 override and add_project_dependency/test.json
-test cases/failing/124 override and add_project_dependency/inc/lib.h
-test cases/failing/124 override and add_project_dependency/subprojects/a/meson.build
-test cases/failing/124 override and add_project_dependency/subprojects/a/prog.c
-test cases/failing/125 targets before add_project_dependency/lib.c
-test cases/failing/125 targets before add_project_dependency/meson.build
-test cases/failing/125 targets before add_project_dependency/test.json
-test cases/failing/125 targets before add_project_dependency/inc/lib.h
-test cases/failing/126 extract from unity/meson.build
-test cases/failing/126 extract from unity/src1.c
-test cases/failing/126 extract from unity/src2.c
-test cases/failing/126 extract from unity/test.json
-test cases/failing/127 subproject object as a dependency/main.c
-test cases/failing/127 subproject object as a dependency/meson.build
-test cases/failing/127 subproject object as a dependency/test.json
-test cases/failing/127 subproject object as a dependency/subprojects/sub/meson.build
-test cases/failing/13 array arithmetic/meson.build
-test cases/failing/13 array arithmetic/test.json
-test cases/failing/14 invalid option name/meson.build
-test cases/failing/14 invalid option name/meson_options.txt
-test cases/failing/14 invalid option name/test.json
-test cases/failing/15 kwarg before arg/meson.build
-test cases/failing/15 kwarg before arg/prog.c
-test cases/failing/15 kwarg before arg/test.json
-test cases/failing/16 extract from subproject/main.c
-test cases/failing/16 extract from subproject/meson.build
-test cases/failing/16 extract from subproject/test.json
-test cases/failing/16 extract from subproject/subprojects/sub_project/meson.build
-test cases/failing/16 extract from subproject/subprojects/sub_project/sub_lib.c
-test cases/failing/17 same target/file.c
-test cases/failing/17 same target/meson.build
-test cases/failing/17 same target/test.json
-test cases/failing/18 wrong plusassign/meson.build
-test cases/failing/18 wrong plusassign/test.json
-test cases/failing/19 target clash/clash.c
-test cases/failing/19 target clash/meson.build
-test cases/failing/19 target clash/test.json
-test cases/failing/2 missing file/meson.build
-test cases/failing/2 missing file/test.json
-test cases/failing/20 version/meson.build
-test cases/failing/20 version/test.json
-test cases/failing/21 subver/meson.build
-test cases/failing/21 subver/test.json
-test cases/failing/21 subver/subprojects/foo/meson.build
-test cases/failing/22 assert/meson.build
-test cases/failing/22 assert/test.json
-test cases/failing/23 rel testdir/meson.build
-test cases/failing/23 rel testdir/simple.c
-test cases/failing/23 rel testdir/test.json
-test cases/failing/24 int conversion/meson.build
-test cases/failing/24 int conversion/test.json
-test cases/failing/25 badlang/meson.build
-test cases/failing/25 badlang/test.json
-test cases/failing/26 output subdir/foo.in
-test cases/failing/26 output subdir/meson.build
-test cases/failing/26 output subdir/test.json
-test cases/failing/26 output subdir/subdir/dummy.txt
-test cases/failing/27 noprog use/meson.build
-test cases/failing/27 noprog use/test.json
-test cases/failing/28 no crossprop/meson.build
-test cases/failing/28 no crossprop/test.json
-test cases/failing/29 nested ternary/meson.build
-test cases/failing/29 nested ternary/test.json
-test cases/failing/3 missing subdir/meson.build
-test cases/failing/3 missing subdir/test.json
-test cases/failing/30 invalid man extension/foo.a1
-test cases/failing/30 invalid man extension/meson.build
-test cases/failing/30 invalid man extension/test.json
-test cases/failing/31 no man extension/foo
-test cases/failing/31 no man extension/meson.build
-test cases/failing/31 no man extension/test.json
-test cases/failing/32 exe static shared/meson.build
-test cases/failing/32 exe static shared/prog.c
-test cases/failing/32 exe static shared/shlib2.c
-test cases/failing/32 exe static shared/stat.c
-test cases/failing/32 exe static shared/test.json
-test cases/failing/33 non-root subproject/meson.build
-test cases/failing/33 non-root subproject/test.json
-test cases/failing/33 non-root subproject/some/meson.build
-test cases/failing/34 dependency not-required then required/meson.build
-test cases/failing/34 dependency not-required then required/test.json
-test cases/failing/35 project argument after target/exe.c
-test cases/failing/35 project argument after target/meson.build
-test cases/failing/35 project argument after target/test.json
-test cases/failing/36 pkgconfig dependency impossible conditions/meson.build
-test cases/failing/36 pkgconfig dependency impossible conditions/test.json
-test cases/failing/37 has function external dependency/meson.build
-test cases/failing/37 has function external dependency/mylib.c
-test cases/failing/37 has function external dependency/test.json
-test cases/failing/38 prefix absolute/meson.build
-test cases/failing/38 prefix absolute/test.json
-test cases/failing/39 kwarg assign/dummy.c
-test cases/failing/39 kwarg assign/meson.build
-test cases/failing/39 kwarg assign/prog.c
-test cases/failing/39 kwarg assign/test.json
-test cases/failing/4 missing meson.build/meson.build
-test cases/failing/4 missing meson.build/test.json
-test cases/failing/4 missing meson.build/subdir/dummy.txt
-test cases/failing/40 custom target plainname many inputs/1.txt
-test cases/failing/40 custom target plainname many inputs/2.txt
-test cases/failing/40 custom target plainname many inputs/catfiles.py
-test cases/failing/40 custom target plainname many inputs/meson.build
-test cases/failing/40 custom target plainname many inputs/test.json
-test cases/failing/41 custom target outputs not matching install_dirs/generator.py
-test cases/failing/41 custom target outputs not matching install_dirs/meson.build
-test cases/failing/41 custom target outputs not matching install_dirs/test.json
-test cases/failing/42 project name colon/meson.build
-test cases/failing/42 project name colon/test.json
-test cases/failing/43 abs subdir/meson.build
-test cases/failing/43 abs subdir/test.json
-test cases/failing/43 abs subdir/bob/meson.build
-test cases/failing/44 abspath to srcdir/meson.build
-test cases/failing/44 abspath to srcdir/test.json
-test cases/failing/45 pkgconfig variables reserved/meson.build
-test cases/failing/45 pkgconfig variables reserved/simple.c
-test cases/failing/45 pkgconfig variables reserved/simple.h
-test cases/failing/45 pkgconfig variables reserved/test.json
-test cases/failing/46 pkgconfig variables zero length/meson.build
-test cases/failing/46 pkgconfig variables zero length/simple.c
-test cases/failing/46 pkgconfig variables zero length/simple.h
-test cases/failing/46 pkgconfig variables zero length/test.json
-test cases/failing/47 pkgconfig variables zero length value/meson.build
-test cases/failing/47 pkgconfig variables zero length value/simple.c
-test cases/failing/47 pkgconfig variables zero length value/simple.h
-test cases/failing/47 pkgconfig variables zero length value/test.json
-test cases/failing/48 pkgconfig variables not key value/meson.build
-test cases/failing/48 pkgconfig variables not key value/simple.c
-test cases/failing/48 pkgconfig variables not key value/simple.h
-test cases/failing/48 pkgconfig variables not key value/test.json
-test cases/failing/49 executable comparison/meson.build
-test cases/failing/49 executable comparison/prog.c
-test cases/failing/49 executable comparison/test.json
-test cases/failing/5 misplaced option/meson.build
-test cases/failing/5 misplaced option/test.json
-test cases/failing/50 inconsistent comparison/meson.build
-test cases/failing/50 inconsistent comparison/test.json
-test cases/failing/51 slashname/meson.build
-test cases/failing/51 slashname/test.json
-test cases/failing/51 slashname/sub/meson.build
-test cases/failing/51 slashname/sub/prog.c
-test cases/failing/52 reserved meson prefix/meson.build
-test cases/failing/52 reserved meson prefix/test.json
-test cases/failing/52 reserved meson prefix/meson-foo/meson.build
-test cases/failing/53 wrong shared crate type/foo.rs
-test cases/failing/53 wrong shared crate type/meson.build
-test cases/failing/53 wrong shared crate type/test.json
-test cases/failing/54 wrong static crate type/foo.rs
-test cases/failing/54 wrong static crate type/meson.build
-test cases/failing/54 wrong static crate type/test.json
-test cases/failing/55 or on new line/meson.build
-test cases/failing/55 or on new line/meson_options.txt
-test cases/failing/55 or on new line/test.json
-test cases/failing/56 link with executable/meson.build
-test cases/failing/56 link with executable/module.c
-test cases/failing/56 link with executable/prog.c
-test cases/failing/56 link with executable/test.json
-test cases/failing/57 assign custom target index/meson.build
-test cases/failing/57 assign custom target index/test.json
-test cases/failing/58 getoption prefix/meson.build
-test cases/failing/58 getoption prefix/test.json
-test cases/failing/58 getoption prefix/subprojects/abc/meson.build
-test cases/failing/58 getoption prefix/subprojects/abc/meson_options.txt
-test cases/failing/59 bad option argument/meson.build
-test cases/failing/59 bad option argument/meson_options.txt
-test cases/failing/59 bad option argument/test.json
-test cases/failing/6 missing incdir/meson.build
-test cases/failing/6 missing incdir/test.json
-test cases/failing/60 subproj filegrab/meson.build
-test cases/failing/60 subproj filegrab/prog.c
-test cases/failing/60 subproj filegrab/test.json
-test cases/failing/60 subproj filegrab/subprojects/a/meson.build
-test cases/failing/61 grab subproj/meson.build
-test cases/failing/61 grab subproj/test.json
-test cases/failing/61 grab subproj/subprojects/foo/meson.build
-test cases/failing/61 grab subproj/subprojects/foo/sub.c
-test cases/failing/62 grab sibling/meson.build
-test cases/failing/62 grab sibling/test.json
-test cases/failing/62 grab sibling/subprojects/a/meson.build
-test cases/failing/62 grab sibling/subprojects/b/meson.build
-test cases/failing/62 grab sibling/subprojects/b/sneaky.c
-test cases/failing/63 string as link target/meson.build
-test cases/failing/63 string as link target/prog.c
-test cases/failing/63 string as link target/test.json
-test cases/failing/64 dependency not-found and required/meson.build
-test cases/failing/64 dependency not-found and required/test.json
-test cases/failing/65 subproj different versions/main.c
-test cases/failing/65 subproj different versions/meson.build
-test cases/failing/65 subproj different versions/test.json
-test cases/failing/65 subproj different versions/subprojects/a/a.c
-test cases/failing/65 subproj different versions/subprojects/a/a.h
-test cases/failing/65 subproj different versions/subprojects/a/meson.build
-test cases/failing/65 subproj different versions/subprojects/b/b.c
-test cases/failing/65 subproj different versions/subprojects/b/b.h
-test cases/failing/65 subproj different versions/subprojects/b/meson.build
-test cases/failing/65 subproj different versions/subprojects/c/c.h
-test cases/failing/65 subproj different versions/subprojects/c/meson.build
-test cases/failing/66 wrong boost module/meson.build
-test cases/failing/66 wrong boost module/test.json
-test cases/failing/67 install_data rename bad size/file1.txt
-test cases/failing/67 install_data rename bad size/file2.txt
-test cases/failing/67 install_data rename bad size/meson.build
-test cases/failing/67 install_data rename bad size/test.json
-test cases/failing/68 skip only subdir/meson.build
-test cases/failing/68 skip only subdir/test.json
-test cases/failing/68 skip only subdir/subdir/meson.build
-test cases/failing/69 dual override/meson.build
-test cases/failing/69 dual override/overrides.py
-test cases/failing/69 dual override/test.json
-test cases/failing/7 go to subproject/meson.build
-test cases/failing/7 go to subproject/test.json
-test cases/failing/7 go to subproject/subprojects/meson.build
-test cases/failing/70 override used/meson.build
-test cases/failing/70 override used/other.py
-test cases/failing/70 override used/something.py
-test cases/failing/70 override used/test.json
-test cases/failing/71 run_command unclean exit/meson.build
-test cases/failing/71 run_command unclean exit/returncode.py
-test cases/failing/71 run_command unclean exit/test.json
-test cases/failing/72 int literal leading zero/meson.build
-test cases/failing/72 int literal leading zero/test.json
-test cases/failing/73 configuration immutable/input
-test cases/failing/73 configuration immutable/meson.build
-test cases/failing/73 configuration immutable/test.json
-test cases/failing/74 link with shared module on osx/meson.build
-test cases/failing/74 link with shared module on osx/module.c
-test cases/failing/74 link with shared module on osx/prog.c
-test cases/failing/74 link with shared module on osx/test.json
-test cases/failing/75 non ascii in ascii encoded configure file/config9.h.in
-test cases/failing/75 non ascii in ascii encoded configure file/meson.build
-test cases/failing/75 non ascii in ascii encoded configure file/test.json
-test cases/failing/76 subproj dependency not-found and required/meson.build
-test cases/failing/76 subproj dependency not-found and required/test.json
-test cases/failing/77 unfound run/meson.build
-test cases/failing/77 unfound run/test.json
-test cases/failing/78 framework dependency with version/meson.build
-test cases/failing/78 framework dependency with version/test.json
-test cases/failing/79 override exe config/foo.c
-test cases/failing/79 override exe config/meson.build
-test cases/failing/79 override exe config/test.json
-test cases/failing/8 recursive/meson.build
-test cases/failing/8 recursive/test.json
-test cases/failing/8 recursive/subprojects/a/meson.build
-test cases/failing/8 recursive/subprojects/b/meson.build
-test cases/failing/80 gl dependency with version/meson.build
-test cases/failing/80 gl dependency with version/test.json
-test cases/failing/81 threads dependency with version/meson.build
-test cases/failing/81 threads dependency with version/test.json
-test cases/failing/82 gtest dependency with version/meson.build
-test cases/failing/82 gtest dependency with version/test.json
-test cases/failing/83 dub libray/meson.build
-test cases/failing/83 dub libray/test.json
-test cases/failing/84 dub executable/meson.build
-test cases/failing/84 dub executable/test.json
-test cases/failing/85 dub compiler/meson.build
-test cases/failing/85 dub compiler/test.json
-test cases/failing/86 subproj not-found dep/meson.build
-test cases/failing/86 subproj not-found dep/test.json
-test cases/failing/86 subproj not-found dep/subprojects/somesubproj/meson.build
-test cases/failing/87 invalid configure file/input
-test cases/failing/87 invalid configure file/meson.build
-test cases/failing/87 invalid configure file/test.json
-test cases/failing/88 kwarg dupe/meson.build
-test cases/failing/88 kwarg dupe/prog.c
-test cases/failing/88 kwarg dupe/test.json
-test cases/failing/89 missing pch file/meson.build
-test cases/failing/89 missing pch file/prog.c
-test cases/failing/89 missing pch file/test.json
-test cases/failing/9 missing extra file/meson.build
-test cases/failing/9 missing extra file/prog.c
-test cases/failing/9 missing extra file/test.json
-test cases/failing/90 pch source different folder/meson.build
-test cases/failing/90 pch source different folder/prog.c
-test cases/failing/90 pch source different folder/test.json
-test cases/failing/90 pch source different folder/include/pch.h
-test cases/failing/90 pch source different folder/src/pch.c
-test cases/failing/91 unknown config tool/meson.build
-test cases/failing/91 unknown config tool/test.json
-test cases/failing/92 custom target install data/Info.plist.cpp
-test cases/failing/92 custom target install data/meson.build
-test cases/failing/92 custom target install data/preproc.py
-test cases/failing/92 custom target install data/test.json
-test cases/failing/93 add dict non string key/meson.build
-test cases/failing/93 add dict non string key/test.json
-test cases/failing/94 add dict duplicate keys/meson.build
-test cases/failing/94 add dict duplicate keys/test.json
-test cases/failing/95 no host get_external_property/meson.build
-test cases/failing/95 no host get_external_property/test.json
-test cases/failing/96 no native compiler/main.c
-test cases/failing/96 no native compiler/meson.build
-test cases/failing/96 no native compiler/test.json
-test cases/failing/97 subdir parse error/meson.build
-test cases/failing/97 subdir parse error/test.json
-test cases/failing/97 subdir parse error/subdir/meson.build
-test cases/failing/98 invalid option file/meson.build
-test cases/failing/98 invalid option file/meson_options.txt
-test cases/failing/98 invalid option file/test.json
-test cases/failing/99 no lang/main.c
-test cases/failing/99 no lang/meson.build
-test cases/failing/99 no lang/test.json
-test cases/fortran/1 basic/meson.build
-test cases/fortran/1 basic/simple.f90
-test cases/fortran/10 find library/gzip.f90
-test cases/fortran/10 find library/main.f90
-test cases/fortran/10 find library/meson.build
-test cases/fortran/11 compiles links runs/meson.build
-test cases/fortran/12 submodule/a1.f90
-test cases/fortran/12 submodule/a2.f90
-test cases/fortran/12 submodule/a3.f90
-test cases/fortran/12 submodule/child.f90
-test cases/fortran/12 submodule/meson.build
-test cases/fortran/12 submodule/parent.f90
-test cases/fortran/13 coarray/main.f90
-test cases/fortran/13 coarray/meson.build
-test cases/fortran/14 fortran links c/clib.c
-test cases/fortran/14 fortran links c/clib.def
-test cases/fortran/14 fortran links c/f_call_c.f90
-test cases/fortran/14 fortran links c/meson.build
-test cases/fortran/15 include/inc1.f90
-test cases/fortran/15 include/inc2.f90
-test cases/fortran/15 include/include_hierarchy.f90
-test cases/fortran/15 include/include_syntax.f90
-test cases/fortran/15 include/meson.build
-test cases/fortran/15 include/timestwo.f90
-test cases/fortran/15 include/subprojects/cmake_inc/CMakeLists.txt
-test cases/fortran/15 include/subprojects/cmake_inc/main.f90
-test cases/fortran/15 include/subprojects/cmake_inc/thousand.f90
-test cases/fortran/16 openmp/main.f90
-test cases/fortran/16 openmp/meson.build
-test cases/fortran/17 add_languages/meson.build
-test cases/fortran/18 first_arg/main.f90
-test cases/fortran/18 first_arg/meson.build
-test cases/fortran/19 fortran_std/legacy.f
-test cases/fortran/19 fortran_std/meson.build
-test cases/fortran/19 fortran_std/std2003.f90
-test cases/fortran/19 fortran_std/std2008.f90
-test cases/fortran/19 fortran_std/std2018.f90
-test cases/fortran/19 fortran_std/std95.f90
-test cases/fortran/2 modules/comment_mod.f90
-test cases/fortran/2 modules/meson.build
-test cases/fortran/2 modules/mymod.F90
-test cases/fortran/2 modules/prog.f90
-test cases/fortran/20 buildtype/main.f90
-test cases/fortran/20 buildtype/meson.build
-test cases/fortran/21 install static/main.f90
-test cases/fortran/21 install static/main_lib.f90
-test cases/fortran/21 install static/meson.build
-test cases/fortran/21 install static/test.json
-test cases/fortran/21 install static/subprojects/static_hello/meson.build
-test cases/fortran/21 install static/subprojects/static_hello/static_hello.f90
-test cases/fortran/3 module procedure/meson.build
-test cases/fortran/3 module procedure/use_syntax.f90
-test cases/fortran/4 self dependency/meson.build
-test cases/fortran/4 self dependency/selfdep.f90
-test cases/fortran/4 self dependency/src/selfdep_mod.f90
-test cases/fortran/4 self dependency/subprojects/sub1/main.f90
-test cases/fortran/4 self dependency/subprojects/sub1/meson.build
-test cases/fortran/5 static/main.f90
-test cases/fortran/5 static/meson.build
-test cases/fortran/5 static/static_hello.f90
-test cases/fortran/6 dynamic/dynamic.f90
-test cases/fortran/6 dynamic/main.f90
-test cases/fortran/6 dynamic/meson.build
-test cases/fortran/7 generated/meson.build
-test cases/fortran/7 generated/mod1.fpp
-test cases/fortran/7 generated/mod2.fpp
-test cases/fortran/7 generated/mod3.f90
-test cases/fortran/7 generated/prog.f90
-test cases/fortran/8 module names/meson.build
-test cases/fortran/8 module names/mod1.f90
-test cases/fortran/8 module names/mod2.f90
-test cases/fortran/8 module names/test.f90
-test cases/fortran/9 cpp/fortran.f
-test cases/fortran/9 cpp/main.c
-test cases/fortran/9 cpp/main.cpp
-test cases/fortran/9 cpp/meson.build
-test cases/fpga/1 simple/meson.build
-test cases/fpga/1 simple/spin.pcf
-test cases/fpga/1 simple/spin.v
-test cases/frameworks/1 boost/extralib.cpp
-test cases/frameworks/1 boost/linkexe.cc
-test cases/frameworks/1 boost/meson.build
-test cases/frameworks/1 boost/meson_options.txt
-test cases/frameworks/1 boost/nomod.cpp
-test cases/frameworks/1 boost/python_module.cpp
-test cases/frameworks/1 boost/test.json
-test cases/frameworks/1 boost/test_python_module.py
-test cases/frameworks/1 boost/unit_test.cpp
-test cases/frameworks/1 boost/partial_dep/foo.cpp
-test cases/frameworks/1 boost/partial_dep/foo.hpp
-test cases/frameworks/1 boost/partial_dep/main.cpp
-test cases/frameworks/1 boost/partial_dep/meson.build
-test cases/frameworks/10 gtk-doc/foo.c
-test cases/frameworks/10 gtk-doc/meson.build
-test cases/frameworks/10 gtk-doc/test.json
-test cases/frameworks/10 gtk-doc/doc/foobar-docs.sgml
-test cases/frameworks/10 gtk-doc/doc/meson.build
-test cases/frameworks/10 gtk-doc/doc/version.xml.in
-test cases/frameworks/10 gtk-doc/doc/foobar1/baz.jpg
-test cases/frameworks/10 gtk-doc/doc/foobar1/baz.png.in
-test cases/frameworks/10 gtk-doc/doc/foobar1/foobar-docs.sgml
-test cases/frameworks/10 gtk-doc/doc/foobar1/foobar-sections.txt
-test cases/frameworks/10 gtk-doc/doc/foobar1/foobar.types
-test cases/frameworks/10 gtk-doc/doc/foobar1/meson.build
-test cases/frameworks/10 gtk-doc/doc/foobar2/foobar-docs.sgml
-test cases/frameworks/10 gtk-doc/doc/foobar2/meson.build
-test cases/frameworks/10 gtk-doc/doc/foobar3/foobar-docs.sgml
-test cases/frameworks/10 gtk-doc/doc/foobar3/meson.build
-test cases/frameworks/10 gtk-doc/doc/foobar4/foobar-docs.sgml
-test cases/frameworks/10 gtk-doc/doc/foobar4/meson.build
-test cases/frameworks/10 gtk-doc/include/foo-version.h.in
-test cases/frameworks/10 gtk-doc/include/foo.h
-test cases/frameworks/10 gtk-doc/include/generate-enums-docbook.py
-test cases/frameworks/10 gtk-doc/include/meson.build
-test cases/frameworks/11 gir subproject/meson.build
-test cases/frameworks/11 gir subproject/test.json
-test cases/frameworks/11 gir subproject/gir/meson-subsample.c
-test cases/frameworks/11 gir subproject/gir/meson-subsample.h
-test cases/frameworks/11 gir subproject/gir/meson.build
-test cases/frameworks/11 gir subproject/gir/prog.c
-test cases/frameworks/11 gir subproject/gir/prog.py
-test cases/frameworks/11 gir subproject/subprojects/mesongir/meson-sample.c
-test cases/frameworks/11 gir subproject/subprojects/mesongir/meson-sample.h
-test cases/frameworks/11 gir subproject/subprojects/mesongir/meson.build
-test cases/frameworks/12 multiple gir/meson.build
-test cases/frameworks/12 multiple gir/test.json
-test cases/frameworks/12 multiple gir/gir/meson-subsample.c
-test cases/frameworks/12 multiple gir/gir/meson-subsample.h
-test cases/frameworks/12 multiple gir/gir/meson.build
-test cases/frameworks/12 multiple gir/gir/prog.c
-test cases/frameworks/12 multiple gir/mesongir/meson-sample.c
-test cases/frameworks/12 multiple gir/mesongir/meson-sample.h.in
-test cases/frameworks/12 multiple gir/mesongir/meson.build
-test cases/frameworks/13 yelp/meson.build
-test cases/frameworks/13 yelp/test.json
-test cases/frameworks/13 yelp/help/LINGUAS
-test cases/frameworks/13 yelp/help/meson.build
-test cases/frameworks/13 yelp/help/C/index.page
-test cases/frameworks/13 yelp/help/C/index2.page
-test cases/frameworks/13 yelp/help/C/index3.page
-test cases/frameworks/13 yelp/help/C/media/test.txt
-test cases/frameworks/13 yelp/help/de/de.po
-test cases/frameworks/13 yelp/help/es/es.po
-test cases/frameworks/13 yelp/help/es/media/test.txt
-test cases/frameworks/14 doxygen/meson.build
-test cases/frameworks/14 doxygen/test.json
-test cases/frameworks/14 doxygen/doc/Doxyfile.in
-test cases/frameworks/14 doxygen/doc/meson.build
-test cases/frameworks/14 doxygen/include/comedian.h
-test cases/frameworks/14 doxygen/include/spede.h
-test cases/frameworks/14 doxygen/src/spede.cpp
-test cases/frameworks/15 llvm/meson.build
-test cases/frameworks/15 llvm/meson_options.txt
-test cases/frameworks/15 llvm/sum.c
-test cases/frameworks/15 llvm/test.json
-test cases/frameworks/16 sdl2/meson.build
-test cases/frameworks/16 sdl2/meson_options.txt
-test cases/frameworks/16 sdl2/sdl2prog.c
-test cases/frameworks/16 sdl2/test.json
-test cases/frameworks/17 mpi/main.c
-test cases/frameworks/17 mpi/main.cpp
-test cases/frameworks/17 mpi/main.f90
-test cases/frameworks/17 mpi/meson.build
-test cases/frameworks/17 mpi/meson_options.txt
-test cases/frameworks/17 mpi/test.json
-test cases/frameworks/18 vulkan/meson.build
-test cases/frameworks/18 vulkan/test.json
-test cases/frameworks/18 vulkan/vulkanprog.c
-test cases/frameworks/19 pcap/meson.build
-test cases/frameworks/19 pcap/pcap_prog.c
-test cases/frameworks/19 pcap/test.json
-test cases/frameworks/2 gtest/meson.build
-test cases/frameworks/2 gtest/test.cc
-test cases/frameworks/2 gtest/test.json
-test cases/frameworks/2 gtest/test_nomain.cc
-test cases/frameworks/20 cups/cups_prog.c
-test cases/frameworks/20 cups/meson.build
-test cases/frameworks/20 cups/test.json
-test cases/frameworks/21 libwmf/libwmf_prog.c
-test cases/frameworks/21 libwmf/meson.build
-test cases/frameworks/21 libwmf/test.json
-test cases/frameworks/22 gir link order/meson-sample.c
-test cases/frameworks/22 gir link order/meson-sample.h
-test cases/frameworks/22 gir link order/meson.build
-test cases/frameworks/22 gir link order/test.json
-test cases/frameworks/22 gir link order/fake-gthread/fake-gthread.c
-test cases/frameworks/22 gir link order/fake-gthread/fake-gthread.h
-test cases/frameworks/22 gir link order/fake-gthread/meson.build
-test cases/frameworks/22 gir link order/get-prgname/get-prgname.c
-test cases/frameworks/22 gir link order/get-prgname/get-prgname.h
-test cases/frameworks/22 gir link order/get-prgname/meson.build
-test cases/frameworks/23 hotdoc/meson.build
-test cases/frameworks/23 hotdoc/test.json
-test cases/frameworks/23 hotdoc/doc/index.md
-test cases/frameworks/23 hotdoc/doc/meson.build
-test cases/frameworks/23 hotdoc/doc/sitemap.txt
-test cases/frameworks/24 libgcrypt/libgcrypt_prog.c
-test cases/frameworks/24 libgcrypt/meson.build
-test cases/frameworks/24 libgcrypt/test.json
-test cases/frameworks/25 hdf5/main.c
-test cases/frameworks/25 hdf5/main.cpp
-test cases/frameworks/25 hdf5/main.f90
-test cases/frameworks/25 hdf5/meson.build
-test cases/frameworks/25 hdf5/meson_options.txt
-test cases/frameworks/25 hdf5/test.json
-test cases/frameworks/26 netcdf/main.c
-test cases/frameworks/26 netcdf/main.cpp
-test cases/frameworks/26 netcdf/main.f90
-test cases/frameworks/26 netcdf/meson.build
-test cases/frameworks/26 netcdf/test.json
-test cases/frameworks/27 gpgme/gpgme_prog.c
-test cases/frameworks/27 gpgme/meson.build
-test cases/frameworks/27 gpgme/test.json
-test cases/frameworks/28 gir link order 2/meson-sample.c
-test cases/frameworks/28 gir link order 2/meson-sample.h
-test cases/frameworks/28 gir link order 2/meson.build
-test cases/frameworks/28 gir link order 2/test.json
-test cases/frameworks/28 gir link order 2/samelibname/meson.build
-test cases/frameworks/29 blocks/main.c
-test cases/frameworks/29 blocks/meson.build
-test cases/frameworks/29 blocks/test.json
-test cases/frameworks/3 gmock/gmocktest.cc
-test cases/frameworks/3 gmock/meson.build
-test cases/frameworks/3 gmock/test.json
-test cases/frameworks/30 scalapack/main.c
-test cases/frameworks/30 scalapack/main.f90
-test cases/frameworks/30 scalapack/meson.build
-test cases/frameworks/30 scalapack/test.json
-test cases/frameworks/30 scalapack/cmake/FindSCALAPACK.cmake
-test cases/frameworks/31 curses/main.c
-test cases/frameworks/31 curses/meson.build
-test cases/frameworks/31 curses/meson_options.txt
-test cases/frameworks/31 curses/test.json
-test cases/frameworks/32 boost root/meson.build
-test cases/frameworks/32 boost root/nativefile.ini.in
-test cases/frameworks/32 boost root/boost/include/boost/version.hpp
-test cases/frameworks/32 boost root/boost/lib/boost_regex-vc142-mt-gd-x32-0_1.lib
-test cases/frameworks/32 boost root/boost/lib/boost_regex-vc142-mt-gd-x64-0_1.lib
-test cases/frameworks/32 boost root/boost/lib/libboost_regex.so.0.1.0
-test cases/frameworks/33 boost split root/meson.build
-test cases/frameworks/33 boost split root/nativefile.ini.in
-test cases/frameworks/33 boost split root/boost/extra-dir/include/boost/version.hpp
-test cases/frameworks/33 boost split root/boost/lib/boost_regex-vc142-mt-gd-x32-0_2.lib
-test cases/frameworks/33 boost split root/boost/lib/boost_regex-vc142-mt-gd-x64-0_2.lib
-test cases/frameworks/33 boost split root/boost/lib/libboost_regex.so.0.2.0
-test cases/frameworks/34 gir static lib/meson.build
-test cases/frameworks/34 gir static lib/test.json
-test cases/frameworks/34 gir static lib/statichelper/meson-sample.c
-test cases/frameworks/34 gir static lib/statichelper/meson-sample.h.in
-test cases/frameworks/34 gir static lib/statichelper/meson.build
-test cases/frameworks/34 gir static lib/subdir/gir/meson-subsample.c
-test cases/frameworks/34 gir static lib/subdir/gir/meson-subsample.h
-test cases/frameworks/34 gir static lib/subdir/gir/meson.build
-test cases/frameworks/34 gir static lib/subdir/gir/prog.c
-test cases/frameworks/35 boost symlinks/meson.build
-test cases/frameworks/35 boost symlinks/nativefile.ini.in
-test cases/frameworks/35 boost symlinks/boost/Cellar/boost-python/0.3.0/lib/boost_python-vc142-mt-gd-x32-0_3.lib
-test cases/frameworks/35 boost symlinks/boost/Cellar/boost-python/0.3.0/lib/boost_python-vc142-mt-gd-x64-0_3.lib
-test cases/frameworks/35 boost symlinks/boost/Cellar/boost-python/0.3.0/lib/libboost_python.so.0.3.0
-test cases/frameworks/35 boost symlinks/boost/Cellar/boost/0.3.0/include/boost/version.hpp
-test cases/frameworks/35 boost symlinks/boost/Cellar/boost/0.3.0/lib/boost_regex-vc142-mt-gd-x32-0_3.lib
-test cases/frameworks/35 boost symlinks/boost/Cellar/boost/0.3.0/lib/boost_regex-vc142-mt-gd-x64-0_3.lib
-test cases/frameworks/35 boost symlinks/boost/Cellar/boost/0.3.0/lib/libboost_regex.so.0.3.0
-test cases/frameworks/35 boost symlinks/boost/include/boost/version.hpp
-test cases/frameworks/35 boost symlinks/boost/lib/boost_python-vc142-mt-gd-x32-0_3.lib
-test cases/frameworks/35 boost symlinks/boost/lib/boost_python-vc142-mt-gd-x64-0_3.lib
-test cases/frameworks/35 boost symlinks/boost/lib/boost_regex-vc142-mt-gd-x32-0_3.lib
-test cases/frameworks/35 boost symlinks/boost/lib/boost_regex-vc142-mt-gd-x64-0_3.lib
-test cases/frameworks/35 boost symlinks/boost/lib/libboost_python.so.0.3.0
-test cases/frameworks/35 boost symlinks/boost/lib/libboost_regex.so.0.3.0
-test cases/frameworks/4 qt/main.cpp
-test cases/frameworks/4 qt/mainWindow.cpp
-test cases/frameworks/4 qt/mainWindow.h
-test cases/frameworks/4 qt/mainWindow.ui
-test cases/frameworks/4 qt/manualinclude.cpp
-test cases/frameworks/4 qt/manualinclude.h
-test cases/frameworks/4 qt/meson.build
-test cases/frameworks/4 qt/meson_options.txt
-test cases/frameworks/4 qt/q5core.cpp
-test cases/frameworks/4 qt/qt4_lang.qrc
-test cases/frameworks/4 qt/qt4core_fr.ts
-test cases/frameworks/4 qt/qt4embedded_fr.ts
-test cases/frameworks/4 qt/qt5_lang.qrc
-test cases/frameworks/4 qt/qt5core_fr.ts
-test cases/frameworks/4 qt/qt5embedded_fr.ts
-test cases/frameworks/4 qt/qt6_lang.qrc
-test cases/frameworks/4 qt/qt6core_fr.ts
-test cases/frameworks/4 qt/qt6embedded_fr.ts
-test cases/frameworks/4 qt/qtinterface.cpp
-test cases/frameworks/4 qt/stuff.qrc
-test cases/frameworks/4 qt/stuff2.qrc
-test cases/frameworks/4 qt/test.json
-test cases/frameworks/4 qt/thing.png
-test cases/frameworks/4 qt/thing2.png
-test cases/frameworks/4 qt/plugin/plugin.cpp
-test cases/frameworks/4 qt/plugin/plugin.h
-test cases/frameworks/4 qt/plugin/plugin.json
-test cases/frameworks/4 qt/pluginInterface/plugin_if.h
-test cases/frameworks/4 qt/subfolder/generator.py
-test cases/frameworks/4 qt/subfolder/main.cpp
-test cases/frameworks/4 qt/subfolder/meson.build
-test cases/frameworks/4 qt/subfolder/resources/stuff3.qrc
-test cases/frameworks/4 qt/subfolder/resources/stuff4.qrc.in
-test cases/frameworks/4 qt/subfolder/resources/thing.png
-test cases/frameworks/5 protocol buffers/defs.proto
-test cases/frameworks/5 protocol buffers/main.cpp
-test cases/frameworks/5 protocol buffers/meson.build
-test cases/frameworks/5 protocol buffers/test.json
-test cases/frameworks/5 protocol buffers/asubdir/defs.proto
-test cases/frameworks/5 protocol buffers/asubdir/main.cpp
-test cases/frameworks/5 protocol buffers/asubdir/meson.build
-test cases/frameworks/5 protocol buffers/sidedir/meson.build
-test cases/frameworks/5 protocol buffers/sidedir/sideprog.cpp
-test cases/frameworks/5 protocol buffers/withpath/meson.build
-test cases/frameworks/5 protocol buffers/withpath/pathprog.cpp
-test cases/frameworks/5 protocol buffers/withpath/com/mesonbuild/simple.proto
-test cases/frameworks/5 protocol buffers/withpath/com/mesonbuild/subsite/complex.proto
-test cases/frameworks/6 gettext/meson.build
-test cases/frameworks/6 gettext/meson_options.txt
-test cases/frameworks/6 gettext/test.json
-test cases/frameworks/6 gettext/data/meson.build
-test cases/frameworks/6 gettext/data/test.desktop.in
-test cases/frameworks/6 gettext/data/test2.desktop.in
-test cases/frameworks/6 gettext/data/test5.desktop.in.in
-test cases/frameworks/6 gettext/data/test6.desktop.in.in
-test cases/frameworks/6 gettext/data/data3/meson.build
-test cases/frameworks/6 gettext/data/data3/test.desktop.in
-test cases/frameworks/6 gettext/data2/meson.build
-test cases/frameworks/6 gettext/data2/test.desktop.in
-test cases/frameworks/6 gettext/data3/com.mesonbuild.test.intlprog.metainfo.xml
-test cases/frameworks/6 gettext/data3/meson.build
-test cases/frameworks/6 gettext/data3/metainfo.its
-test cases/frameworks/6 gettext/data3/verify.py
-test cases/frameworks/6 gettext/generated/desktopgenerator.py
-test cases/frameworks/6 gettext/generated/meson.build
-test cases/frameworks/6 gettext/generated/something.desktop.in.in
-test cases/frameworks/6 gettext/po/LINGUAS
-test cases/frameworks/6 gettext/po/POTFILES
-test cases/frameworks/6 gettext/po/de.po
-test cases/frameworks/6 gettext/po/fi.po
-test cases/frameworks/6 gettext/po/intltest.pot
-test cases/frameworks/6 gettext/po/meson.build
-test cases/frameworks/6 gettext/po/ru.po
-test cases/frameworks/6 gettext/src/intlmain.c
-test cases/frameworks/6 gettext/src/meson.build
-test cases/frameworks/7 gnome/meson.build
-test cases/frameworks/7 gnome/test.json
-test cases/frameworks/7 gnome/gdbus/gdbusprog.c
-test cases/frameworks/7 gnome/gdbus/meson.build
-test cases/frameworks/7 gnome/gdbus/data/com.example.Sample.xml
-test cases/frameworks/7 gnome/genmarshal/main.c.in
-test cases/frameworks/7 gnome/genmarshal/marshaller.list
-test cases/frameworks/7 gnome/genmarshal/meson.build
-test cases/frameworks/7 gnome/gir/copy.py
-test cases/frameworks/7 gnome/gir/meson-sample.c
-test cases/frameworks/7 gnome/gir/meson-sample.h
-test cases/frameworks/7 gnome/gir/meson-sample2.c
-test cases/frameworks/7 gnome/gir/meson-sample2.h
-test cases/frameworks/7 gnome/gir/meson.build
-test cases/frameworks/7 gnome/gir/prog.c
-test cases/frameworks/7 gnome/gir/prog.py
-test cases/frameworks/7 gnome/gir/dep1/dep1.c
-test cases/frameworks/7 gnome/gir/dep1/dep1.h
-test cases/frameworks/7 gnome/gir/dep1/meson.build
-test cases/frameworks/7 gnome/gir/dep1/dep2/dep2.c
-test cases/frameworks/7 gnome/gir/dep1/dep2/dep2.h
-test cases/frameworks/7 gnome/gir/dep1/dep2/meson.build
-test cases/frameworks/7 gnome/gir/dep1/dep3/dep3.c
-test cases/frameworks/7 gnome/gir/dep1/dep3/dep3.h
-test cases/frameworks/7 gnome/gir/dep1/dep3/meson.build
-test cases/frameworks/7 gnome/mkenums/enums.c.in
-test cases/frameworks/7 gnome/mkenums/enums.h.in
-test cases/frameworks/7 gnome/mkenums/enums2.c.in
-test cases/frameworks/7 gnome/mkenums/enums2.h.in
-test cases/frameworks/7 gnome/mkenums/main.c
-test cases/frameworks/7 gnome/mkenums/main4.c
-test cases/frameworks/7 gnome/mkenums/main5.c
-test cases/frameworks/7 gnome/mkenums/meson-decls.h
-test cases/frameworks/7 gnome/mkenums/meson-sample.h
-test cases/frameworks/7 gnome/mkenums/meson.build
-test cases/frameworks/7 gnome/resources/copyfile.py
-test cases/frameworks/7 gnome/resources/generated-main.c
-test cases/frameworks/7 gnome/resources/generated.gresource.xml
-test cases/frameworks/7 gnome/resources/meson.build
-test cases/frameworks/7 gnome/resources/myresource.gresource.xml
-test cases/frameworks/7 gnome/resources/res3.txt
-test cases/frameworks/7 gnome/resources/resources.py
-test cases/frameworks/7 gnome/resources/simple-main.c
-test cases/frameworks/7 gnome/resources/simple.gresource.xml
-test cases/frameworks/7 gnome/resources-data/meson.build
-test cases/frameworks/7 gnome/resources-data/res1.txt
-test cases/frameworks/7 gnome/resources-data/res3.txt.in
-test cases/frameworks/7 gnome/resources-data/subdir/meson.build
-test cases/frameworks/7 gnome/resources-data/subdir/res2.txt
-test cases/frameworks/7 gnome/resources-data/subdir/res4.txt.in
-test cases/frameworks/7 gnome/resources/generated/meson.build
-test cases/frameworks/7 gnome/schemas/com.github.meson.gschema.xml
-test cases/frameworks/7 gnome/schemas/meson.build
-test cases/frameworks/7 gnome/schemas/schemaprog.c
-test cases/frameworks/8 flex/lexer.l
-test cases/frameworks/8 flex/meson.build
-test cases/frameworks/8 flex/parser.y
-test cases/frameworks/8 flex/prog.c
-test cases/frameworks/8 flex/test.json
-test cases/frameworks/8 flex/test.txt
-test cases/frameworks/8 flex/testfile
-test cases/frameworks/9 wxwidgets/mainwin.h
-test cases/frameworks/9 wxwidgets/meson.build
-test cases/frameworks/9 wxwidgets/wxprog.cpp
-test cases/frameworks/9 wxwidgets/wxstc.cpp
-test cases/java/1 basic/meson.build
-test cases/java/1 basic/test.json
-test cases/java/1 basic/com/mesonbuild/Simple.java
-test cases/java/10 resources/meson.build
-test cases/java/10 resources/src/meson.build
-test cases/java/10 resources/src/com/mesonbuild/Resources.java
-test cases/java/10 resources/src/resources/resource1.txt
-test cases/java/10 resources/src/resources/subdir/resource2.txt
-test cases/java/2 subdir/meson.build
-test cases/java/2 subdir/sub/meson.build
-test cases/java/2 subdir/sub/com/mesonbuild/Simple.java
-test cases/java/2 subdir/sub/com/mesonbuild/TextPrinter.java
-test cases/java/3 args/meson.build
-test cases/java/3 args/com/mesonbuild/Simple.java
-test cases/java/4 inner class/meson.build
-test cases/java/4 inner class/com/mesonbuild/Simple.java
-test cases/java/5 includedirs/meson.build
-test cases/java/5 includedirs/com/mesonbuild/Simple.java
-test cases/java/5 includedirs/com/mesonbuild/TextPrinter.java
-test cases/java/6 codegen/meson.build
-test cases/java/6 codegen/com/mesonbuild/Config.java.in
-test cases/java/6 codegen/com/mesonbuild/Simple.java
-test cases/java/6 codegen/com/mesonbuild/TextPrinter.java
-test cases/java/6 codegen/com/mesonbuild/meson.build
-test cases/java/7 linking/meson.build
-test cases/java/7 linking/com/mesonbuild/Linking.java
-test cases/java/7 linking/sub/meson.build
-test cases/java/7 linking/sub/com/mesonbuild/SimpleLib.java
-test cases/java/8 codegen custom target/meson.build
-test cases/java/8 codegen custom target/com/mesonbuild/Config.java.in
-test cases/java/8 codegen custom target/com/mesonbuild/Simple.java
-test cases/java/8 codegen custom target/com/mesonbuild/TextPrinter.java
-test cases/java/8 codegen custom target/com/mesonbuild/meson.build
-test cases/java/9 jni/meson.build
-test cases/java/9 jni/lib/com_mesonbuild_JniTest.c
-test cases/java/9 jni/lib/meson.build
-test cases/java/9 jni/lib/native.c
-test cases/java/9 jni/src/meson.build
-test cases/java/9 jni/src/com/mesonbuild/Configured.java.in
-test cases/java/9 jni/src/com/mesonbuild/JniTest.java
-test cases/java/9 jni/src/com/mesonbuild/meson.build
-test cases/keyval/1 basic/.config
-test cases/keyval/1 basic/meson.build
-test cases/keyval/1 basic/test.json
-test cases/keyval/2 subdir/.config
-test cases/keyval/2 subdir/meson.build
-test cases/keyval/2 subdir/dir/meson.build
-test cases/keyval/3 load_config files/meson.build
-test cases/keyval/3 load_config files/dir/config
-test cases/keyval/3 load_config files/dir/meson.build
-test cases/keyval/4 load_config builddir/config
-test cases/keyval/4 load_config builddir/meson.build
-test cases/linuxlike/1 pkg-config/meson.build
-test cases/linuxlike/1 pkg-config/prog-checkver.c
-test cases/linuxlike/1 pkg-config/prog.c
-test cases/linuxlike/1 pkg-config/incdir/myinc.h
-test cases/linuxlike/10 large file support/meson.build
-test cases/linuxlike/11 runpath rpath ldlibrarypath/lib.c
-test cases/linuxlike/11 runpath rpath ldlibrarypath/main.c
-test cases/linuxlike/11 runpath rpath ldlibrarypath/meson.build
-test cases/linuxlike/11 runpath rpath ldlibrarypath/lib1/meson.build
-test cases/linuxlike/11 runpath rpath ldlibrarypath/lib2/meson.build
-test cases/linuxlike/12 subprojects in subprojects/main.c
-test cases/linuxlike/12 subprojects in subprojects/meson.build
-test cases/linuxlike/12 subprojects in subprojects/subprojects/a/a.c
-test cases/linuxlike/12 subprojects in subprojects/subprojects/a/a.h
-test cases/linuxlike/12 subprojects in subprojects/subprojects/a/meson.build
-test cases/linuxlike/12 subprojects in subprojects/subprojects/b/b.c
-test cases/linuxlike/12 subprojects in subprojects/subprojects/b/b.h
-test cases/linuxlike/12 subprojects in subprojects/subprojects/b/meson.build
-test cases/linuxlike/12 subprojects in subprojects/subprojects/c/c.h
-test cases/linuxlike/12 subprojects in subprojects/subprojects/c/meson.build
-test cases/linuxlike/13 cmake dependency/meson.build
-test cases/linuxlike/13 cmake dependency/prog-checkver.c
-test cases/linuxlike/13 cmake dependency/prog.c
-test cases/linuxlike/13 cmake dependency/test.json
-test cases/linuxlike/13 cmake dependency/testFlagSet.c
-test cases/linuxlike/13 cmake dependency/cmake/FindImportedOldStyle.cmake
-test cases/linuxlike/13 cmake dependency/cmake/FindImportedTarget.cmake
-test cases/linuxlike/13 cmake dependency/cmake/FindSomethingLikeZLIB.cmake
-test cases/linuxlike/13 cmake dependency/cmake_fake1/cmMesonTestF1Config.cmake
-test cases/linuxlike/13 cmake dependency/cmake_fake2/cmMesonTestF2Config.cmake
-test cases/linuxlike/13 cmake dependency/cmake_fake3/bin/.gitkeep
-test cases/linuxlike/13 cmake dependency/cmake_fake3/lib/cmake/cmMesonTestF3/cmMesonTestF3Config.cmake
-test cases/linuxlike/13 cmake dependency/cmake_pref_env/lib/cmake/cmMesonTestDep/cmMesonTestDepConfig.cmake
-test cases/linuxlike/13 cmake dependency/cmake_pref_env/lib/cmake/cmMesonVersionedTestDep/cmMesonVersionedTestDepConfig.cmake
-test cases/linuxlike/13 cmake dependency/cmake_pref_env/lib/cmake/cmMesonVersionedTestDep/cmMesonVersionedTestDepConfigVersion.cmake
-test cases/linuxlike/13 cmake dependency/incdir/myinc.h
-test cases/linuxlike/14 static dynamic linkage/main.c
-test cases/linuxlike/14 static dynamic linkage/meson.build
-test cases/linuxlike/14 static dynamic linkage/verify_static.py
-test cases/linuxlike/15 ld binary/meson.build
-test cases/linuxlike/2 external library/meson.build
-test cases/linuxlike/2 external library/prog.c
-test cases/linuxlike/3 linker script/bob.c
-test cases/linuxlike/3 linker script/bob.h
-test cases/linuxlike/3 linker script/bob.map
-test cases/linuxlike/3 linker script/bob.map.in
-test cases/linuxlike/3 linker script/copy.py
-test cases/linuxlike/3 linker script/meson.build
-test cases/linuxlike/3 linker script/prog.c
-test cases/linuxlike/3 linker script/sub/foo.map
-test cases/linuxlike/3 linker script/sub/meson.build
-test cases/linuxlike/4 extdep static lib/lib.c
-test cases/linuxlike/4 extdep static lib/meson.build
-test cases/linuxlike/4 extdep static lib/prog.c
-test cases/linuxlike/5 dependency versions/meson.build
-test cases/linuxlike/5 dependency versions/subprojects/fakezlib/meson.build
-test cases/linuxlike/5 dependency versions/subprojects/somelib/lib.c
-test cases/linuxlike/5 dependency versions/subprojects/somelib/meson.build
-test cases/linuxlike/5 dependency versions/subprojects/somelibnover/lib.c
-test cases/linuxlike/5 dependency versions/subprojects/somelibnover/meson.build
-test cases/linuxlike/5 dependency versions/subprojects/somelibver/lib.c
-test cases/linuxlike/5 dependency versions/subprojects/somelibver/meson.build
-test cases/linuxlike/6 subdir include order/meson.build
-test cases/linuxlike/6 subdir include order/prog.c
-test cases/linuxlike/6 subdir include order/subdir/glib.h
-test cases/linuxlike/7 library versions/exe.orig.c
-test cases/linuxlike/7 library versions/lib.c
-test cases/linuxlike/7 library versions/meson.build
-test cases/linuxlike/7 library versions/test.json
-test cases/linuxlike/8 subproject library install/meson.build
-test cases/linuxlike/8 subproject library install/test.json
-test cases/linuxlike/8 subproject library install/subprojects/sublib/meson.build
-test cases/linuxlike/8 subproject library install/subprojects/sublib/sublib.c
-test cases/linuxlike/8 subproject library install/subprojects/sublib/include/subdefs.h
-test cases/linuxlike/9 compiler checks with dependencies/meson.build
-test cases/nasm/1 configure file/hello.asm
-test cases/nasm/1 configure file/meson.build
-test cases/native/1 trivial/meson.build
-test cases/native/1 trivial/trivial.c
-test cases/native/2 global arg/meson.build
-test cases/native/2 global arg/prog.c
-test cases/native/2 global arg/prog.cc
-test cases/native/3 pipeline/input_src.dat
-test cases/native/3 pipeline/meson.build
-test cases/native/3 pipeline/prog.c
-test cases/native/3 pipeline/srcgen.c
-test cases/native/3 pipeline/depends/copyrunner.py
-test cases/native/3 pipeline/depends/filecopier.c
-test cases/native/3 pipeline/depends/libsrc.c.in
-test cases/native/3 pipeline/depends/meson.build
-test cases/native/3 pipeline/depends/prog.c
-test cases/native/3 pipeline/src/input_src.dat
-test cases/native/3 pipeline/src/meson.build
-test cases/native/3 pipeline/src/prog.c
-test cases/native/3 pipeline/src/srcgen.c
-test cases/native/4 tryrun/error.c
-test cases/native/4 tryrun/meson.build
-test cases/native/4 tryrun/no_compile.c
-test cases/native/4 tryrun/ok.c
-test cases/native/5 install script/file.txt
-test cases/native/5 install script/meson.build
-test cases/native/5 install script/test.json
-test cases/native/5 install script/wrap.py
-test cases/native/5 install script/src/exe.c
-test cases/native/5 install script/src/meson.build
-test cases/native/6 add language/meson.build
-test cases/native/6 add language/prog.cc
-test cases/native/7 selfbuilt custom/checkarg.cpp
-test cases/native/7 selfbuilt custom/data.dat
-test cases/native/7 selfbuilt custom/mainprog.cpp
-test cases/native/7 selfbuilt custom/meson.build
-test cases/native/7 selfbuilt custom/tool.cpp
-test cases/native/8 external program shebang parsing/input.txt
-test cases/native/8 external program shebang parsing/main.c
-test cases/native/8 external program shebang parsing/meson.build
-test cases/native/8 external program shebang parsing/script.int.in
-test cases/native/9 override with exe/main2.input
-test cases/native/9 override with exe/meson.build
-test cases/native/9 override with exe/subprojects/sub/foobar.c
-test cases/native/9 override with exe/subprojects/sub/meson.build
-test cases/objc/1 simple/meson.build
-test cases/objc/1 simple/prog.m
-test cases/objc/2 nsstring/meson.build
-test cases/objc/2 nsstring/stringprog.m
-test cases/objc/3 objc args/meson.build
-test cases/objc/3 objc args/prog.m
-test cases/objc/4 c++ project objc subproject/master.cpp
-test cases/objc/4 c++ project objc subproject/meson.build
-test cases/objc/4 c++ project objc subproject/subprojects/foo/foo.m
-test cases/objc/4 c++ project objc subproject/subprojects/foo/meson.build
-test cases/objcpp/1 simple/meson.build
-test cases/objcpp/1 simple/prog.mm
-test cases/objcpp/2 objc++ args/meson.build
-test cases/objcpp/2 objc++ args/prog.mm
-test cases/osx/1 basic/main.c
-test cases/osx/1 basic/meson.build
-test cases/osx/2 library versions/CMakeLists.txt
-test cases/osx/2 library versions/exe.orig.c
-test cases/osx/2 library versions/lib.c
-test cases/osx/2 library versions/meson.build
-test cases/osx/2 library versions/require_pkgconfig.py
-test cases/osx/2 library versions/test.json
-test cases/osx/3 has function xcode8/meson.build
-test cases/osx/4 framework/meson.build
-test cases/osx/4 framework/prog.c
-test cases/osx/4 framework/stat.c
-test cases/osx/4 framework/test.json
-test cases/osx/4 framework/xcode-frameworks.png
-test cases/osx/5 extra frameworks/meson.build
-test cases/osx/5 extra frameworks/prog.c
-test cases/osx/5 extra frameworks/stat.c
-test cases/osx/5 extra frameworks/test.json
-test cases/osx/6 multiframework/main.m
-test cases/osx/6 multiframework/meson.build
-test cases/osx/7 bitcode/libbar.mm
-test cases/osx/7 bitcode/libfile.c
-test cases/osx/7 bitcode/libfoo.m
-test cases/osx/7 bitcode/meson.build
-test cases/osx/7 bitcode/vis.h
-test cases/osx/8 pie/main.c
-test cases/osx/8 pie/meson.build
-test cases/python/1 basic/meson.build
-test cases/python/1 basic/prog.py
-test cases/python/1 basic/gluon/__init__.py
-test cases/python/1 basic/gluon/gluonator.py
-test cases/python/1 basic/subdir/meson.build
-test cases/python/1 basic/subdir/subprog.py
-test cases/python/2 extmodule/blaster.py.in
-test cases/python/2 extmodule/meson.build
-test cases/python/2 extmodule/test.json
-test cases/python/2 extmodule/ext/meson.build
-test cases/python/2 extmodule/ext/tachyon_module.c
-test cases/python/2 extmodule/ext/nested/meson.build
-test cases/python/2 extmodule/ext/wrongdir/meson.build
-test cases/python/3 cython/cytest.py
-test cases/python/3 cython/meson.build
-test cases/python/3 cython/libdir/cstorer.pxd
-test cases/python/3 cython/libdir/meson.build
-test cases/python/3 cython/libdir/storer.c
-test cases/python/3 cython/libdir/storer.h
-test cases/python/3 cython/libdir/storer.pyx
-test cases/python/4 custom target depends extmodule/blaster.py
-test cases/python/4 custom target depends extmodule/meson.build
-test cases/python/4 custom target depends extmodule/ext/meson.build
-test cases/python/4 custom target depends extmodule/ext/tachyon_module.c
-test cases/python/4 custom target depends extmodule/ext/lib/meson-tachyonlib.c
-test cases/python/4 custom target depends extmodule/ext/lib/meson-tachyonlib.h
-test cases/python/4 custom target depends extmodule/ext/lib/meson.build
-test cases/python/5 modules kwarg/meson.build
-test cases/python/6 failing subproject/meson.build
-test cases/python/6 failing subproject/subprojects/bar/meson.build
-test cases/python/7 install path/meson.build
-test cases/python/7 install path/test.json
-test cases/python/7 install path/test.py
-test cases/python/8 different python versions/blaster.py
-test cases/python/8 different python versions/meson.build
-test cases/python/8 different python versions/meson_options.txt
-test cases/python/8 different python versions/test.json
-test cases/python/8 different python versions/ext/meson.build
-test cases/python/8 different python versions/ext/tachyon_module.c
-test cases/python3/1 basic/meson.build
-test cases/python3/1 basic/prog.py
-test cases/python3/1 basic/gluon/__init__.py
-test cases/python3/1 basic/gluon/gluonator.py
-test cases/python3/1 basic/subdir/meson.build
-test cases/python3/1 basic/subdir/subprog.py
-test cases/python3/2 extmodule/blaster.py
-test cases/python3/2 extmodule/meson.build
-test cases/python3/2 extmodule/ext/meson.build
-test cases/python3/2 extmodule/ext/tachyon_module.c
-test cases/python3/3 cython/cytest.py
-test cases/python3/3 cython/meson.build
-test cases/python3/3 cython/libdir/cstorer.pxd
-test cases/python3/3 cython/libdir/meson.build
-test cases/python3/3 cython/libdir/storer.c
-test cases/python3/3 cython/libdir/storer.h
-test cases/python3/3 cython/libdir/storer.pyx
-test cases/python3/4 custom target depends extmodule/blaster.py
-test cases/python3/4 custom target depends extmodule/meson.build
-test cases/python3/4 custom target depends extmodule/ext/meson.build
-test cases/python3/4 custom target depends extmodule/ext/tachyon_module.c
-test cases/python3/4 custom target depends extmodule/ext/lib/meson-tachyonlib.c
-test cases/python3/4 custom target depends extmodule/ext/lib/meson-tachyonlib.h
-test cases/python3/4 custom target depends extmodule/ext/lib/meson.build
-test cases/rewrite/1 basic/addSrc.json
-test cases/rewrite/1 basic/addTgt.json
-test cases/rewrite/1 basic/info.json
-test cases/rewrite/1 basic/meson.build
-test cases/rewrite/1 basic/rmSrc.json
-test cases/rewrite/1 basic/rmTgt.json
-test cases/rewrite/2 subdirs/addSrc.json
-test cases/rewrite/2 subdirs/addTgt.json
-test cases/rewrite/2 subdirs/info.json
-test cases/rewrite/2 subdirs/meson.build
-test cases/rewrite/2 subdirs/rmTgt.json
-test cases/rewrite/2 subdirs/sub1/meson.build
-test cases/rewrite/2 subdirs/sub2/meson.build
-test cases/rewrite/3 kwargs/add.json
-test cases/rewrite/3 kwargs/defopts_delete.json
-test cases/rewrite/3 kwargs/defopts_set.json
-test cases/rewrite/3 kwargs/delete.json
-test cases/rewrite/3 kwargs/info.json
-test cases/rewrite/3 kwargs/meson.build
-test cases/rewrite/3 kwargs/remove.json
-test cases/rewrite/3 kwargs/remove_regex.json
-test cases/rewrite/3 kwargs/set.json
-test cases/rewrite/4 same name targets/addSrc.json
-test cases/rewrite/4 same name targets/info.json
-test cases/rewrite/4 same name targets/meson.build
-test cases/rewrite/4 same name targets/sub1/meson.build
-test cases/rewrite/5 sorting/meson.build
-test cases/rewrite/6 extra_files/addExtraFiles.json
-test cases/rewrite/6 extra_files/info.json
-test cases/rewrite/6 extra_files/meson.build
-test cases/rewrite/6 extra_files/rmExtraFiles.json
-test cases/rust/1 basic/clippy.toml
-test cases/rust/1 basic/meson.build
-test cases/rust/1 basic/prog.rs
-test cases/rust/1 basic/test.json
-test cases/rust/1 basic/subdir/meson.build
-test cases/rust/1 basic/subdir/prog.rs
-test cases/rust/10 language stds/2015.rs
-test cases/rust/10 language stds/2018.rs
-test cases/rust/10 language stds/meson.build
-test cases/rust/11 generated main/gen.py
-test cases/rust/11 generated main/generated_lib_main.rs
-test cases/rust/11 generated main/meson.build
-test cases/rust/11 generated main/sub/meson.build
-test cases/rust/12 bindgen/meson.build
-test cases/rust/12 bindgen/include/other.h
-test cases/rust/12 bindgen/src/gen_header.py
-test cases/rust/12 bindgen/src/header.h
-test cases/rust/12 bindgen/src/main.rs
-test cases/rust/12 bindgen/src/main2.rs
-test cases/rust/12 bindgen/src/source.c
-test cases/rust/12 bindgen/sub/meson.build
-test cases/rust/13 external c dependencies/c_accessing_zlib.c
-test cases/rust/13 external c dependencies/meson.build
-test cases/rust/13 external c dependencies/meson_options.txt
-test cases/rust/13 external c dependencies/prog.rs
-test cases/rust/13 external c dependencies/test.json
-test cases/rust/14 external libm/meson.build
-test cases/rust/14 external libm/meson_options.txt
-test cases/rust/14 external libm/prog.rs
-test cases/rust/14 external libm/rs_math.rs
-test cases/rust/14 external libm/test.json
-test cases/rust/15 polyglot sharedlib/adder.c
-test cases/rust/15 polyglot sharedlib/adder.h
-test cases/rust/15 polyglot sharedlib/adder.rs
-test cases/rust/15 polyglot sharedlib/addertest.c
-test cases/rust/15 polyglot sharedlib/meson.build
-test cases/rust/16 internal c dependencies/lib.c
-test cases/rust/16 internal c dependencies/lib.h
-test cases/rust/16 internal c dependencies/main.rs
-test cases/rust/16 internal c dependencies/meson.build
-test cases/rust/16 internal c dependencies/test.py
-test cases/rust/17 staticlib link staticlib/branch.rs
-test cases/rust/17 staticlib link staticlib/leaf.rs
-test cases/rust/17 staticlib link staticlib/meson.build
-test cases/rust/17 staticlib link staticlib/prog.c
-test cases/rust/17 staticlib link staticlib/test.json
-test cases/rust/18 proc-macro/meson.build
-test cases/rust/18 proc-macro/proc.rs
-test cases/rust/18 proc-macro/use.rs
-test cases/rust/19 structured sources/gen.py
-test cases/rust/19 structured sources/main-gen-copy.rs
-test cases/rust/19 structured sources/meson.build
-test cases/rust/19 structured sources/no_copy_test.py
-test cases/rust/19 structured sources/priv.rs
-test cases/rust/19 structured sources/src/foo.rs.in
-test cases/rust/19 structured sources/src/main.rs
-test cases/rust/19 structured sources/src2/main-unique.rs
-test cases/rust/19 structured sources/src2/meson.build
-test cases/rust/19 structured sources/src2/foo/mod.rs
-test cases/rust/2 sharedlib/meson.build
-test cases/rust/2 sharedlib/prog.rs
-test cases/rust/2 sharedlib/stuff.rs
-test cases/rust/2 sharedlib/test.json
-test cases/rust/3 staticlib/meson.build
-test cases/rust/3 staticlib/prog.rs
-test cases/rust/3 staticlib/stuff.rs
-test cases/rust/3 staticlib/test.json
-test cases/rust/4 polyglot/meson.build
-test cases/rust/4 polyglot/prog.c
-test cases/rust/4 polyglot/stuff.rs
-test cases/rust/4 polyglot/test.json
-test cases/rust/5 polyglot static/meson.build
-test cases/rust/5 polyglot static/prog.c
-test cases/rust/5 polyglot static/stuff.rs
-test cases/rust/5 polyglot static/test.json
-test cases/rust/6 named staticlib/meson.build
-test cases/rust/6 named staticlib/prog.rs
-test cases/rust/6 named staticlib/stuff.rs
-test cases/rust/6 named staticlib/test.json
-test cases/rust/7 private crate collision/meson.build
-test cases/rust/7 private crate collision/prog.rs
-test cases/rust/7 private crate collision/rand.rs
-test cases/rust/7 private crate collision/test.json
-test cases/rust/8 many files/foo.rs
-test cases/rust/8 many files/main.rs
-test cases/rust/8 many files/meson.build
-test cases/rust/9 unit tests/meson.build
-test cases/rust/9 unit tests/test.rs
-test cases/rust/9 unit tests/test2.rs
-test cases/swift/1 exe/main.swift
-test cases/swift/1 exe/meson.build
-test cases/swift/2 multifile/libfile.swift
-test cases/swift/2 multifile/main.swift
-test cases/swift/2 multifile/meson.build
-test cases/swift/3 library/meson.build
-test cases/swift/3 library/exe/main.swift
-test cases/swift/3 library/exe/meson.build
-test cases/swift/3 library/lib/datasource.swift
-test cases/swift/3 library/lib/meson.build
-test cases/swift/3 library/lib/othersource.swift
-test cases/swift/4 generate/meson.build
-test cases/swift/4 generate/gen/main.swift
-test cases/swift/4 generate/gen/meson.build
-test cases/swift/4 generate/user/main.swift
-test cases/swift/4 generate/user/meson.build
-test cases/swift/5 mixed/main.swift
-test cases/swift/5 mixed/meson.build
-test cases/swift/5 mixed/mylib.c
-test cases/swift/5 mixed/mylib.h
-test cases/swift/6 modulemap/main.swift
-test cases/swift/6 modulemap/meson.build
-test cases/swift/6 modulemap/module.modulemap
-test cases/swift/6 modulemap/mylib.c
-test cases/swift/6 modulemap/mylib.h
-test cases/swift/7 modulemap subdir/main.swift
-test cases/swift/7 modulemap subdir/meson.build
-test cases/swift/7 modulemap subdir/mylib/meson.build
-test cases/swift/7 modulemap subdir/mylib/module.modulemap
-test cases/swift/7 modulemap subdir/mylib/mylib.c
-test cases/swift/7 modulemap subdir/mylib/mylib.h
-test cases/unit/1 soname/CMakeLists.txt
-test cases/unit/1 soname/main.c
-test cases/unit/1 soname/meson.build
-test cases/unit/1 soname/versioned.c
-test cases/unit/10 build_rpath/meson.build
-test cases/unit/10 build_rpath/prog.c
-test cases/unit/10 build_rpath/prog.cc
-test cases/unit/10 build_rpath/sub/meson.build
-test cases/unit/10 build_rpath/sub/stuff.c
-test cases/unit/100 relative find program/foo.py
-test cases/unit/100 relative find program/meson.build
-test cases/unit/100 relative find program/subdir/meson.build
-test cases/unit/101 rlib linkage/lib2.rs
-test cases/unit/101 rlib linkage/main.rs
-test cases/unit/101 rlib linkage/meson.build
-test cases/unit/102 python without pkgconfig/meson.build
-test cases/unit/103 strip/lib.c
-test cases/unit/103 strip/meson.build
-test cases/unit/104 debug function/meson.build
-test cases/unit/105 pkgconfig relocatable with absolute path/meson.build
-test cases/unit/106 subproject symlink/cp.py
-test cases/unit/106 subproject symlink/main.c
-test cases/unit/106 subproject symlink/meson.build
-test cases/unit/106 subproject symlink/symlinked_subproject/meson.build
-test cases/unit/106 subproject symlink/symlinked_subproject/src.c
-test cases/unit/106 subproject symlink/symlinked_subproject/datadir/datafile
-test cases/unit/106 subproject symlink/symlinked_subproject/datadir/meson.build
-test cases/unit/107 new subproject on reconfigure/meson.build
-test cases/unit/107 new subproject on reconfigure/meson_options.txt
-test cases/unit/107 new subproject on reconfigure/subprojects/foo/foo.c
-test cases/unit/107 new subproject on reconfigure/subprojects/foo/meson.build
-test cases/unit/11 cross prog/meson.build
-test cases/unit/11 cross prog/some_cross_tool.py
-test cases/unit/11 cross prog/sometool.py
-test cases/unit/12 promote/meson.build
-test cases/unit/12 promote/subprojects/s1/meson.build
-test cases/unit/12 promote/subprojects/s1/s1.c
-test cases/unit/12 promote/subprojects/s1/subprojects/s3/meson.build
-test cases/unit/12 promote/subprojects/s1/subprojects/s3/s3.c
-test cases/unit/12 promote/subprojects/s1/subprojects/scommon/meson.build
-test cases/unit/12 promote/subprojects/s1/subprojects/scommon/scommon_broken.c
-test cases/unit/12 promote/subprojects/s2/meson.build
-test cases/unit/12 promote/subprojects/s2/s2.c
-test cases/unit/12 promote/subprojects/s2/subprojects/athing.wrap
-test cases/unit/12 promote/subprojects/s2/subprojects/scommon/meson.build
-test cases/unit/12 promote/subprojects/s2/subprojects/scommon/scommon_ok.c
-test cases/unit/13 reconfigure/meson.build
-test cases/unit/14 testsetup selection/main.c
-test cases/unit/14 testsetup selection/meson.build
-test cases/unit/14 testsetup selection/subprojects/bar/bar.c
-test cases/unit/14 testsetup selection/subprojects/bar/meson.build
-test cases/unit/14 testsetup selection/subprojects/foo/foo.c
-test cases/unit/14 testsetup selection/subprojects/foo/meson.build
-test cases/unit/15 prebuilt object/main.c
-test cases/unit/15 prebuilt object/meson.build
-test cases/unit/15 prebuilt object/source.c
-test cases/unit/16 prebuilt static/main.c
-test cases/unit/16 prebuilt static/meson.build
-test cases/unit/16 prebuilt static/libdir/best.c
-test cases/unit/16 prebuilt static/libdir/best.h
-test cases/unit/16 prebuilt static/libdir/meson.build
-test cases/unit/17 prebuilt shared/alexandria.c
-test cases/unit/17 prebuilt shared/alexandria.h
-test cases/unit/17 prebuilt shared/another_visitor.c
-test cases/unit/17 prebuilt shared/meson.build
-test cases/unit/17 prebuilt shared/meson_options.txt
-test cases/unit/17 prebuilt shared/patron.c
-test cases/unit/17 prebuilt shared/rejected.c
-test cases/unit/17 prebuilt shared/rejected.h
-test cases/unit/17 prebuilt shared/rejected_main.c
-test cases/unit/18 pkgconfig static/foo.c
-test cases/unit/18 pkgconfig static/foo.pc.in
-test cases/unit/18 pkgconfig static/main.c
-test cases/unit/18 pkgconfig static/meson.build
-test cases/unit/18 pkgconfig static/include/foo.h
-test cases/unit/19 array option/meson.build
-test cases/unit/19 array option/meson_options.txt
-test cases/unit/2 testsetups/buggy.c
-test cases/unit/2 testsetups/envcheck.py
-test cases/unit/2 testsetups/impl.c
-test cases/unit/2 testsetups/impl.h
-test cases/unit/2 testsetups/meson.build
-test cases/unit/20 subproj dep variables/meson.build
-test cases/unit/20 subproj dep variables/subprojects/failingsubproj/meson.build
-test cases/unit/20 subproj dep variables/subprojects/nestedsubproj/meson.build
-test cases/unit/20 subproj dep variables/subprojects/nestedsubproj/subprojects/subsubproject.wrap
-test cases/unit/20 subproj dep variables/subprojects/somesubproj/meson.build
-test cases/unit/21 exit status/meson.build
-test cases/unit/22 warning location/a.c
-test cases/unit/22 warning location/b.c
-test cases/unit/22 warning location/conf.in
-test cases/unit/22 warning location/main.c
-test cases/unit/22 warning location/meson.build
-test cases/unit/22 warning location/sub/c.c
-test cases/unit/22 warning location/sub/d.c
-test cases/unit/22 warning location/sub/meson.build
-test cases/unit/22 warning location/sub/sub.c
-test cases/unit/23 unfound pkgconfig/meson.build
-test cases/unit/23 unfound pkgconfig/some.c
-test cases/unit/24 compiler run_command/meson.build
-test cases/unit/25 non-permitted kwargs/meson.build
-test cases/unit/26 install umask/datafile.cat
-test cases/unit/26 install umask/meson.build
-test cases/unit/26 install umask/myinstall.py
-test cases/unit/26 install umask/prog.1
-test cases/unit/26 install umask/prog.c
-test cases/unit/26 install umask/sample.h
-test cases/unit/26 install umask/subdir/datafile.dog
-test cases/unit/26 install umask/subdir/sayhello
-test cases/unit/27 pkgconfig usage/dependee/meson.build
-test cases/unit/27 pkgconfig usage/dependee/pkguser.c
-test cases/unit/27 pkgconfig usage/dependency/meson.build
-test cases/unit/27 pkgconfig usage/dependency/pkgdep.c
-test cases/unit/27 pkgconfig usage/dependency/pkgdep.h
-test cases/unit/27 pkgconfig usage/dependency/privatelib.c
-test cases/unit/28 ndebug if-release/main.c
-test cases/unit/28 ndebug if-release/meson.build
-test cases/unit/29 guessed linker dependencies/exe/app.c
-test cases/unit/29 guessed linker dependencies/exe/meson.build
-test cases/unit/29 guessed linker dependencies/lib/lib.c
-test cases/unit/29 guessed linker dependencies/lib/meson.build
-test cases/unit/29 guessed linker dependencies/lib/meson_options.txt
-test cases/unit/3 subproject defaults/meson.build
-test cases/unit/3 subproject defaults/meson_options.txt
-test cases/unit/3 subproject defaults/subprojects/foob/meson.build
-test cases/unit/3 subproject defaults/subprojects/foob/meson_options.txt
-test cases/unit/30 shared_mod linking/libfile.c
-test cases/unit/30 shared_mod linking/main.c
-test cases/unit/30 shared_mod linking/meson.build
-test cases/unit/31 forcefallback/meson.build
-test cases/unit/31 forcefallback/test_not_zlib.c
-test cases/unit/31 forcefallback/subprojects/notzlib/meson.build
-test cases/unit/31 forcefallback/subprojects/notzlib/notzlib.c
-test cases/unit/31 forcefallback/subprojects/notzlib/notzlib.h
-test cases/unit/32 pkgconfig use libraries/app/app.c
-test cases/unit/32 pkgconfig use libraries/app/meson.build
-test cases/unit/32 pkgconfig use libraries/lib/liba.c
-test cases/unit/32 pkgconfig use libraries/lib/libb.c
-test cases/unit/32 pkgconfig use libraries/lib/meson.build
-test cases/unit/33 cross file overrides always args/meson.build
-test cases/unit/33 cross file overrides always args/test.c
-test cases/unit/33 cross file overrides always args/ubuntu-armhf-overrides.txt
-test cases/unit/34 command line/meson.build
-test cases/unit/34 command line/meson_options.txt
-test cases/unit/34 command line/subprojects/subp/meson.build
-test cases/unit/34 command line/subprojects/subp/meson_options.txt
-test cases/unit/35 dist script/meson.build
-test cases/unit/35 dist script/prog.c
-test cases/unit/35 dist script/replacer.py
-test cases/unit/35 dist script/subprojects/sub/dist-script.py
-test cases/unit/35 dist script/subprojects/sub/meson.build
-test cases/unit/35 dist script/subprojects/sub/meson_options.txt
-test cases/unit/35 dist script/subprojects/sub/prog.c
-test cases/unit/36 exe_wrapper behaviour/broken-cross.txt
-test cases/unit/36 exe_wrapper behaviour/meson.build
-test cases/unit/36 exe_wrapper behaviour/meson_options.txt
-test cases/unit/36 exe_wrapper behaviour/prog.c
-test cases/unit/37 mixed command line args/meson.build
-test cases/unit/37 mixed command line args/meson_options.txt
-test cases/unit/38 pkgconfig format/meson.build
-test cases/unit/38 pkgconfig format/somelib.c
-test cases/unit/38 pkgconfig format/someret.c
-test cases/unit/39 external, internal library rpath/built library/bar.c
-test cases/unit/39 external, internal library rpath/built library/meson.build
-test cases/unit/39 external, internal library rpath/built library/meson_options.txt
-test cases/unit/39 external, internal library rpath/built library/prog.c
-test cases/unit/39 external, internal library rpath/external library/bar.c
-test cases/unit/39 external, internal library rpath/external library/faa.c
-test cases/unit/39 external, internal library rpath/external library/foo.c
-test cases/unit/39 external, internal library rpath/external library/meson.build
-test cases/unit/4 suite selection/failing_test.c
-test cases/unit/4 suite selection/meson.build
-test cases/unit/4 suite selection/successful_test.c
-test cases/unit/4 suite selection/subprojects/subprjfail/failing_test.c
-test cases/unit/4 suite selection/subprojects/subprjfail/meson.build
-test cases/unit/4 suite selection/subprojects/subprjmix/failing_test.c
-test cases/unit/4 suite selection/subprojects/subprjmix/meson.build
-test cases/unit/4 suite selection/subprojects/subprjmix/successful_test.c
-test cases/unit/4 suite selection/subprojects/subprjsucc/meson.build
-test cases/unit/4 suite selection/subprojects/subprjsucc/successful_test.c
-test cases/unit/40 featurenew subprojects/meson.build
-test cases/unit/40 featurenew subprojects/subprojects/bar/meson.build
-test cases/unit/40 featurenew subprojects/subprojects/baz/meson.build
-test cases/unit/40 featurenew subprojects/subprojects/foo/meson.build
-test cases/unit/41 rpath order/meson.build
-test cases/unit/41 rpath order/myexe.c
-test cases/unit/41 rpath order/subprojects/sub1/lib.c
-test cases/unit/41 rpath order/subprojects/sub1/meson.build
-test cases/unit/41 rpath order/subprojects/sub2/lib.c
-test cases/unit/41 rpath order/subprojects/sub2/meson.build
-test cases/unit/42 dep order/lib1.c
-test cases/unit/42 dep order/lib2.c
-test cases/unit/42 dep order/meson.build
-test cases/unit/42 dep order/myexe.c
-test cases/unit/43 promote wrap/meson.build
-test cases/unit/43 promote wrap/subprojects/s1/meson.build
-test cases/unit/43 promote wrap/subprojects/s1/subprojects/ambiguous/meson.build
-test cases/unit/43 promote wrap/subprojects/s2/meson.build
-test cases/unit/43 promote wrap/subprojects/s2/subprojects/ambiguous.wrap
-test cases/unit/44 vscpp17/main.cpp
-test cases/unit/44 vscpp17/meson.build
-test cases/unit/45 native dep pkgconfig var/cross_pkgconfig.py
-test cases/unit/45 native dep pkgconfig var/meson.build
-test cases/unit/45 native dep pkgconfig var/meson_options.txt
-test cases/unit/45 native dep pkgconfig var/cross_pkgconfig/dep_tester.pc
-test cases/unit/45 native dep pkgconfig var/native_pkgconfig/dep_tester.pc
-test cases/unit/46 native file binary/meson.build
-test cases/unit/46 native file binary/meson_options.txt
-test cases/unit/47 reconfigure/main.c
-test cases/unit/47 reconfigure/meson.build
-test cases/unit/47 reconfigure/meson_options.txt
-test cases/unit/47 reconfigure/subprojects/sub1/meson.build
-test cases/unit/48 testsetup default/envcheck.py
-test cases/unit/48 testsetup default/meson.build
-test cases/unit/49 pkgconfig csharp library/meson.build
-test cases/unit/49 pkgconfig csharp library/somelib.cs
-test cases/unit/5 compiler detection/compiler wrapper.py
-test cases/unit/5 compiler detection/meson.build
-test cases/unit/5 compiler detection/trivial.c
-test cases/unit/5 compiler detection/trivial.cc
-test cases/unit/5 compiler detection/trivial.m
-test cases/unit/5 compiler detection/trivial.mm
-test cases/unit/50 noncross options/meson.build
-test cases/unit/50 noncross options/prog.c
-test cases/unit/50 noncross options/ylib.pc
-test cases/unit/51 ldflagdedup/bob.c
-test cases/unit/51 ldflagdedup/meson.build
-test cases/unit/51 ldflagdedup/prog.c
-test cases/unit/52 pkgconfig static link order/meson.build
-test cases/unit/53 clang-format/.clang-format
-test cases/unit/53 clang-format/header_expected_h
-test cases/unit/53 clang-format/header_orig_h
-test cases/unit/53 clang-format/meson.build
-test cases/unit/53 clang-format/prog_expected_c
-test cases/unit/53 clang-format/prog_orig_c
-test cases/unit/53 clang-format/dummydir.h/dummy.dat
-test cases/unit/54 introspect buildoptions/subprojects/projectBad/meson.build
-test cases/unit/54 introspect buildoptions/subprojects/projectBad/meson_options.txt
-test cases/unit/55 dedup compiler libs/meson.build
-test cases/unit/55 dedup compiler libs/app/app.c
-test cases/unit/55 dedup compiler libs/app/meson.build
-test cases/unit/55 dedup compiler libs/liba/liba.c
-test cases/unit/55 dedup compiler libs/liba/liba.h
-test cases/unit/55 dedup compiler libs/liba/meson.build
-test cases/unit/55 dedup compiler libs/libb/libb.c
-test cases/unit/55 dedup compiler libs/libb/libb.h
-test cases/unit/55 dedup compiler libs/libb/meson.build
-test cases/unit/56 introspection/cp.py
-test cases/unit/56 introspection/meson.build
-test cases/unit/56 introspection/meson_options.txt
-test cases/unit/56 introspection/t1.cpp
-test cases/unit/56 introspection/t2.cpp
-test cases/unit/56 introspection/t3.cpp
-test cases/unit/56 introspection/sharedlib/meson.build
-test cases/unit/56 introspection/sharedlib/shared.cpp
-test cases/unit/56 introspection/sharedlib/shared.hpp
-test cases/unit/56 introspection/staticlib/meson.build
-test cases/unit/56 introspection/staticlib/static.c
-test cases/unit/56 introspection/staticlib/static.h
-test cases/unit/57 pkg_config_path option/meson.build
-test cases/unit/57 pkg_config_path option/build_extra_path/totally_made_up_dep.pc
-test cases/unit/57 pkg_config_path option/host_extra_path/totally_made_up_dep.pc
-test cases/unit/58 introspect buildoptions/c_compiler.py
-test cases/unit/58 introspect buildoptions/main.c
-test cases/unit/58 introspect buildoptions/meson.build
-test cases/unit/58 introspect buildoptions/meson_options.txt
-test cases/unit/58 introspect buildoptions/subprojects/evilFile.txt
-test cases/unit/58 introspect buildoptions/subprojects/projectA/meson.build
-test cases/unit/58 introspect buildoptions/subprojects/projectA/meson_options.txt
-test cases/unit/58 introspect buildoptions/subprojects/projectBad/meson.build
-test cases/unit/58 introspect buildoptions/subprojects/projectBad/meson_options.txt
-test cases/unit/59 native file override/crossfile
-test cases/unit/59 native file override/crossfile2
-test cases/unit/59 native file override/meson.build
-test cases/unit/59 native file override/meson_options.txt
-test cases/unit/59 native file override/nativefile
-test cases/unit/6 std override/meson.build
-test cases/unit/6 std override/prog11.cpp
-test cases/unit/6 std override/prog98.cpp
-test cases/unit/6 std override/progp.cpp
-test cases/unit/60 identity cross/build_wrapper.py
-test cases/unit/60 identity cross/host_wrapper.py
-test cases/unit/60 identity cross/meson.build
-test cases/unit/60 identity cross/stuff.h
-test cases/unit/61 pkgconfig relative paths/pkgconfig/librelativepath.pc
-test cases/unit/62 cmake_prefix_path/meson.build
-test cases/unit/62 cmake_prefix_path/prefix/lib/cmake/mesontest/mesontest-config.cmake
-test cases/unit/63 cmake parser/meson.build
-test cases/unit/63 cmake parser/prefix/lib/cmake/mesontest/mesontest-config.cmake
-test cases/unit/64 alias target/main.c
-test cases/unit/64 alias target/meson.build
-test cases/unit/64 alias target/subdir/meson.build
-test cases/unit/65 static archive stripping/app/appA.c
-test cases/unit/65 static archive stripping/app/appB.c
-test cases/unit/65 static archive stripping/app/meson.build
-test cases/unit/65 static archive stripping/lib/libA.c
-test cases/unit/65 static archive stripping/lib/libA.h
-test cases/unit/65 static archive stripping/lib/libB.c
-test cases/unit/65 static archive stripping/lib/libB.h
-test cases/unit/65 static archive stripping/lib/meson.build
-test cases/unit/66 static link/meson.build
-test cases/unit/66 static link/test1.c
-test cases/unit/66 static link/test2.c
-test cases/unit/66 static link/test3.c
-test cases/unit/66 static link/test4.c
-test cases/unit/66 static link/test5.c
-test cases/unit/66 static link/lib/func1.c
-test cases/unit/66 static link/lib/func10.c
-test cases/unit/66 static link/lib/func11.c
-test cases/unit/66 static link/lib/func12.c
-test cases/unit/66 static link/lib/func14.c
-test cases/unit/66 static link/lib/func15.c
-test cases/unit/66 static link/lib/func16.c
-test cases/unit/66 static link/lib/func17.c
-test cases/unit/66 static link/lib/func18.c
-test cases/unit/66 static link/lib/func19.c
-test cases/unit/66 static link/lib/func2.c
-test cases/unit/66 static link/lib/func3.c
-test cases/unit/66 static link/lib/func4.c
-test cases/unit/66 static link/lib/func5.c
-test cases/unit/66 static link/lib/func6.c
-test cases/unit/66 static link/lib/func7.c
-test cases/unit/66 static link/lib/func8.c
-test cases/unit/66 static link/lib/func9.c
-test cases/unit/66 static link/lib/meson.build
-test cases/unit/67 test env value/meson.build
-test cases/unit/67 test env value/test.py
-test cases/unit/68 clang-tidy/.clang-tidy
-test cases/unit/68 clang-tidy/cttest.cpp
-test cases/unit/68 clang-tidy/meson.build
-test cases/unit/68 clang-tidy/dummydir.h/dummy.dat
-test cases/unit/69 cross/crossfile.in
-test cases/unit/69 cross/meson.build
-test cases/unit/69 cross/meson_options.txt
-test cases/unit/7 run installed/meson.build
-test cases/unit/7 run installed/prog.c
-test cases/unit/7 run installed/foo/foo.c
-test cases/unit/7 run installed/foo/meson.build
-test cases/unit/70 cross test passed/exewrapper.py
-test cases/unit/70 cross test passed/meson.build
-test cases/unit/70 cross test passed/meson_options.txt
-test cases/unit/70 cross test passed/script.py
-test cases/unit/70 cross test passed/src/main.c
-test cases/unit/71 summary/meson.build
-test cases/unit/71 summary/meson_options.txt
-test cases/unit/71 summary/subprojects/sub/meson.build
-test cases/unit/71 summary/subprojects/sub2/meson.build
-test cases/unit/71 summary/subprojects/sub2/subprojects/subsub/meson.build
-test cases/unit/72 wrap file url/meson.build
-test cases/unit/72 wrap file url/subprojects/foo-patch.tar.xz
-test cases/unit/72 wrap file url/subprojects/foo.tar.xz
-test cases/unit/73 dep files/foo.c
-test cases/unit/73 dep files/meson.build
-test cases/unit/74 pkgconfig prefixes/client/client.c
-test cases/unit/74 pkgconfig prefixes/client/meson.build
-test cases/unit/74 pkgconfig prefixes/val1/meson.build
-test cases/unit/74 pkgconfig prefixes/val1/val1.c
-test cases/unit/74 pkgconfig prefixes/val1/val1.h
-test cases/unit/74 pkgconfig prefixes/val2/meson.build
-test cases/unit/74 pkgconfig prefixes/val2/val2.c
-test cases/unit/74 pkgconfig prefixes/val2/val2.h
-test cases/unit/75 subdir libdir/meson.build
-test cases/unit/75 subdir libdir/subprojects/flub/meson.build
-test cases/unit/76 as link whole/bar.c
-test cases/unit/76 as link whole/foo.c
-test cases/unit/76 as link whole/meson.build
-test cases/unit/77 nostdlib/meson.build
-test cases/unit/77 nostdlib/prog.c
-test cases/unit/77 nostdlib/subprojects/mylibc/libc.c
-test cases/unit/77 nostdlib/subprojects/mylibc/meson.build
-test cases/unit/77 nostdlib/subprojects/mylibc/stdio.h
-test cases/unit/77 nostdlib/subprojects/mylibc/stubstart.s
-test cases/unit/78 user options for subproject/.gitignore
-test cases/unit/78 user options for subproject/75 user options for subproject/.gitignore
-test cases/unit/78 user options for subproject/75 user options for subproject/meson.build
-test cases/unit/79 global-rpath/meson.build
-test cases/unit/79 global-rpath/rpathified.cpp
-test cases/unit/79 global-rpath/yonder/meson.build
-test cases/unit/79 global-rpath/yonder/yonder.cpp
-test cases/unit/79 global-rpath/yonder/yonder.h
-test cases/unit/8 -L -l order/first.pc
-test cases/unit/8 -L -l order/meson.build
-test cases/unit/8 -L -l order/prog.c
-test cases/unit/8 -L -l order/second.pc
-test cases/unit/80 wrap-git/meson.build
-test cases/unit/80 wrap-git/subprojects/packagefiles/wrap_git_builddef/meson.build
-test cases/unit/80 wrap-git/subprojects/wrap_git_upstream/main.c
-test cases/unit/81 meson version compare/meson.build
-test cases/unit/81 meson version compare/subprojects/foo/meson.build
-test cases/unit/82 cross only introspect/meson.build
-test cases/unit/83 change option choices/meson.build
-test cases/unit/83 change option choices/meson_options.1.txt
-test cases/unit/83 change option choices/meson_options.2.txt
-test cases/unit/84 nested subproject regenerate depends/main.c
-test cases/unit/84 nested subproject regenerate depends/meson.build
-test cases/unit/84 nested subproject regenerate depends/subprojects/sub1/meson.build
-test cases/unit/84 nested subproject regenerate depends/subprojects/sub2/CMakeLists.txt
-test cases/unit/85 cpp modules/meson.build
-test cases/unit/85 cpp modules/gcc/main.cpp
-test cases/unit/85 cpp modules/gcc/meson.build
-test cases/unit/85 cpp modules/gcc/src0.cxx
-test cases/unit/85 cpp modules/gcc/src1.cxx
-test cases/unit/85 cpp modules/gcc/src2.cxx
-test cases/unit/85 cpp modules/gcc/src3.cxx
-test cases/unit/85 cpp modules/gcc/src4.cxx
-test cases/unit/85 cpp modules/gcc/src5.cxx
-test cases/unit/85 cpp modules/gcc/src6.cxx
-test cases/unit/85 cpp modules/gcc/src7.cxx
-test cases/unit/85 cpp modules/gcc/src8.cxx
-test cases/unit/85 cpp modules/gcc/src9.cxx
-test cases/unit/85 cpp modules/vs/main.cpp
-test cases/unit/85 cpp modules/vs/meson.build
-test cases/unit/85 cpp modules/vs/src0.ixx
-test cases/unit/85 cpp modules/vs/src1.ixx
-test cases/unit/85 cpp modules/vs/src2.ixx
-test cases/unit/85 cpp modules/vs/src3.ixx
-test cases/unit/85 cpp modules/vs/src4.ixx
-test cases/unit/85 cpp modules/vs/src5.ixx
-test cases/unit/85 cpp modules/vs/src6.ixx
-test cases/unit/85 cpp modules/vs/src7.ixx
-test cases/unit/85 cpp modules/vs/src8.ixx
-test cases/unit/85 cpp modules/vs/src9.ixx
-test cases/unit/86 prelinking/file1.c
-test cases/unit/86 prelinking/file2.c
-test cases/unit/86 prelinking/file3.c
-test cases/unit/86 prelinking/file4.c
-test cases/unit/86 prelinking/main.c
-test cases/unit/86 prelinking/meson.build
-test cases/unit/86 prelinking/private_header.h
-test cases/unit/86 prelinking/public_header.h
-test cases/unit/87 run native test/main.c
-test cases/unit/87 run native test/meson.build
-test cases/unit/88 multiple envvars/meson.build
-test cases/unit/88 multiple envvars/prog.c
-test cases/unit/88 multiple envvars/prog.cpp
-test cases/unit/89 pkgconfig build rpath order/dummy.pc
-test cases/unit/89 pkgconfig build rpath order/meson.build
-test cases/unit/89 pkgconfig build rpath order/prog.c
-test cases/unit/89 pkgconfig build rpath order/prog.cc
-test cases/unit/89 pkgconfig build rpath order/sub/meson.build
-test cases/unit/89 pkgconfig build rpath order/sub/stuff.c
-test cases/unit/9 d dedup/meson.build
-test cases/unit/9 d dedup/prog.c
-test cases/unit/90 devenv/main.c
-test cases/unit/90 devenv/meson.build
-test cases/unit/90 devenv/test-devenv.py
-test cases/unit/90 devenv/subprojects/sub/foo.c
-test cases/unit/90 devenv/subprojects/sub/meson.build
-test cases/unit/91 install skip subprojects/foo.c
-test cases/unit/91 install skip subprojects/foo.dat
-test cases/unit/91 install skip subprojects/foo.h
-test cases/unit/91 install skip subprojects/meson.build
-test cases/unit/91 install skip subprojects/foo/foofile
-test cases/unit/91 install skip subprojects/subprojects/bar/bar.c
-test cases/unit/91 install skip subprojects/subprojects/bar/bar.dat
-test cases/unit/91 install skip subprojects/subprojects/bar/bar.h
-test cases/unit/91 install skip subprojects/subprojects/bar/meson.build
-test cases/unit/91 install skip subprojects/subprojects/bar/bar/barfile
-test cases/unit/92 new subproject in configured project/meson.build
-test cases/unit/92 new subproject in configured project/meson_options.txt
-test cases/unit/92 new subproject in configured project/subprojects/sub/foo.c
-test cases/unit/92 new subproject in configured project/subprojects/sub/meson.build
-test cases/unit/93 clangformat/.clang-format
-test cases/unit/93 clangformat/.clang-format-ignore
-test cases/unit/93 clangformat/.clang-format-include
-test cases/unit/93 clangformat/meson.build
-test cases/unit/93 clangformat/not-included/badformat.cpp
-test cases/unit/93 clangformat/src/badformat.c
-test cases/unit/93 clangformat/src/badformat.cpp
-test cases/unit/94 custominc/helper.c
-test cases/unit/94 custominc/meson.build
-test cases/unit/94 custominc/prog.c
-test cases/unit/94 custominc/prog2.c
-test cases/unit/94 custominc/easytogrepfor/genh.py
-test cases/unit/94 custominc/easytogrepfor/meson.build
-test cases/unit/95 implicit force fallback/meson.build
-test cases/unit/95 implicit force fallback/subprojects/something/meson.build
-test cases/unit/96 compiler.links file arg/meson.build
-test cases/unit/96 compiler.links file arg/test.c
-test cases/unit/97 link full name/.gitignore
-test cases/unit/97 link full name/libtestprovider/meson.build
-test cases/unit/97 link full name/libtestprovider/provider.c
-test cases/unit/97 link full name/proguser/meson.build
-test cases/unit/97 link full name/proguser/receiver.c
-test cases/unit/98 install all targets/bar-custom.txt
-test cases/unit/98 install all targets/bar-devel.h
-test cases/unit/98 install all targets/bar-notag.txt
-test cases/unit/98 install all targets/foo.in
-test cases/unit/98 install all targets/foo1-devel.h
-test cases/unit/98 install all targets/lib.c
-test cases/unit/98 install all targets/main.c
-test cases/unit/98 install all targets/meson.build
-test cases/unit/98 install all targets/script.py
-test cases/unit/98 install all targets/custom_files/data.txt
-test cases/unit/98 install all targets/subdir/bar2-devel.h
-test cases/unit/98 install all targets/subdir/foo2.in
-test cases/unit/98 install all targets/subdir/foo3-devel.h
-test cases/unit/98 install all targets/subdir/lib.c
-test cases/unit/98 install all targets/subdir/main.c
-test cases/unit/98 install all targets/subdir/meson.build
-test cases/unit/98 install all targets/subdir/script.py
-test cases/unit/99 custom target name/file.txt.in
-test cases/unit/99 custom target name/meson.build
-test cases/unit/99 custom target name/subdir/meson.build
-test cases/vala/1 basic/meson.build
-test cases/vala/1 basic/prog.vala
-test cases/vala/10 mixed sources/meson.build
-test cases/vala/10 mixed sources/c/foo.c
-test cases/vala/10 mixed sources/c/meson.build
-test cases/vala/10 mixed sources/c/writec.py
-test cases/vala/10 mixed sources/vala/bar.vala
-test cases/vala/11 generated vapi/main.vala
-test cases/vala/11 generated vapi/meson.build
-test cases/vala/11 generated vapi/test.json
-test cases/vala/11 generated vapi/libbar/bar.c
-test cases/vala/11 generated vapi/libbar/bar.h
-test cases/vala/11 generated vapi/libbar/meson.build
-test cases/vala/11 generated vapi/libfoo/foo.c
-test cases/vala/11 generated vapi/libfoo/foo.h
-test cases/vala/11 generated vapi/libfoo/foo.metadata
-test cases/vala/11 generated vapi/libfoo/meson.build
-test cases/vala/12 custom output/bar.vala
-test cases/vala/12 custom output/foo.vala
-test cases/vala/12 custom output/meson.build
-test cases/vala/13 find library/meson.build
-test cases/vala/13 find library/test.vala
-test cases/vala/14 target glib version and gresources/meson.build
-test cases/vala/14 target glib version and gresources/test.vala
-test cases/vala/14 target glib version and gresources/gres/meson.build
-test cases/vala/14 target glib version and gresources/gres/test-resources.xml
-test cases/vala/14 target glib version and gresources/gres/test.ui
-test cases/vala/15 static vapi in source tree/meson.build
-test cases/vala/15 static vapi in source tree/test.vala
-test cases/vala/15 static vapi in source tree/vapi/config.vapi
-test cases/vala/16 mixed dependence/app.vala
-test cases/vala/16 mixed dependence/meson.build
-test cases/vala/16 mixed dependence/mixer-glue.c
-test cases/vala/16 mixed dependence/mixer.vala
-test cases/vala/17 plain consumer/app.c
-test cases/vala/17 plain consumer/badger.vala
-test cases/vala/17 plain consumer/meson.build
-test cases/vala/18 vapi consumed twice/app.vala
-test cases/vala/18 vapi consumed twice/beer.vala
-test cases/vala/18 vapi consumed twice/meson.build
-test cases/vala/18 vapi consumed twice/person.vala
-test cases/vala/19 genie/meson.build
-test cases/vala/19 genie/prog.gs
-test cases/vala/2 multiple files/class1.vala
-test cases/vala/2 multiple files/class2.vala
-test cases/vala/2 multiple files/main.vala
-test cases/vala/2 multiple files/meson.build
-test cases/vala/20 genie multiple mixed sources/c_test_one.c
-test cases/vala/20 genie multiple mixed sources/c_test_two.c
-test cases/vala/20 genie multiple mixed sources/init.gs
-test cases/vala/20 genie multiple mixed sources/meson.build
-test cases/vala/20 genie multiple mixed sources/test_one.gs
-test cases/vala/20 genie multiple mixed sources/test_two.gs
-test cases/vala/20 genie multiple mixed sources/vala_test_one.vala
-test cases/vala/20 genie multiple mixed sources/vala_test_two.vala
-test cases/vala/21 type module/foo.vala
-test cases/vala/21 type module/meson.build
-test cases/vala/21 type module/plugin-bar.vala
-test cases/vala/21 type module/plugin-module.vala
-test cases/vala/21 type module/plugin.vala
-test cases/vala/22 same target in directories/Test.vala
-test cases/vala/22 same target in directories/meson.build
-test cases/vala/22 same target in directories/prog.vala
-test cases/vala/22 same target in directories/Subdir/Test.vala
-test cases/vala/22 same target in directories/Subdir/Subdir2/Test.vala
-test cases/vala/22 same target in directories/Subdir2/Test.vala
-test cases/vala/23 thread flags/meson.build
-test cases/vala/23 thread flags/prog.vala
-test cases/vala/24 export dynamic shared module/app.vala
-test cases/vala/24 export dynamic shared module/meson.build
-test cases/vala/24 export dynamic shared module/module.vala
-test cases/vala/25 extract_all_objects/meson.build
-test cases/vala/25 extract_all_objects/prog.vala
-test cases/vala/26 vala and asm/meson.build
-test cases/vala/26 vala and asm/prog.vala
-test cases/vala/26 vala and asm/retval-arm.S
-test cases/vala/26 vala and asm/retval-x86.S
-test cases/vala/26 vala and asm/retval-x86_64.S
-test cases/vala/26 vala and asm/symbol-underscore.h
-test cases/vala/3 dep/gioprog.vala
-test cases/vala/3 dep/meson.build
-test cases/vala/4 config/config.vapi
-test cases/vala/4 config/meson-something-else.vapi
-test cases/vala/4 config/meson.build
-test cases/vala/4 config/prog.vala
-test cases/vala/5 target glib/GLib.Thread.vala
-test cases/vala/5 target glib/meson.build
-test cases/vala/5 target glib/retcode.c
-test cases/vala/6 static library/meson.build
-test cases/vala/6 static library/mylib.vala
-test cases/vala/6 static library/prog.vala
-test cases/vala/6 static library/test.json
-test cases/vala/7 shared library/meson.build
-test cases/vala/7 shared library/test.json
-test cases/vala/7 shared library/lib/meson.build
-test cases/vala/7 shared library/lib/mylib.vala
-test cases/vala/7 shared library/prog/meson.build
-test cases/vala/7 shared library/prog/prog.vala
-test cases/vala/8 generated sources/meson.build
-test cases/vala/8 generated sources/test.json
-test cases/vala/8 generated sources/dependency-generated/enum-types.c.template
-test cases/vala/8 generated sources/dependency-generated/enum-types.h.template
-test cases/vala/8 generated sources/dependency-generated/enums.h
-test cases/vala/8 generated sources/dependency-generated/lib.vala
-test cases/vala/8 generated sources/dependency-generated/main.vala
-test cases/vala/8 generated sources/dependency-generated/meson.build
-test cases/vala/8 generated sources/dependency-generated/null.c
-test cases/vala/8 generated sources/onlygen/maingen.in
-test cases/vala/8 generated sources/onlygen/meson.build
-test cases/vala/8 generated sources/src/config.vala.in
-test cases/vala/8 generated sources/src/copy_file.py
-test cases/vala/8 generated sources/src/meson.build
-test cases/vala/8 generated sources/src/returncode.in
-test cases/vala/8 generated sources/src/test.vala
-test cases/vala/8 generated sources/src/write_wrapper.py
-test cases/vala/8 generated sources/tools/meson.build
-test cases/vala/9 gir/foo.vala
-test cases/vala/9 gir/meson.build
-test cases/vala/9 gir/test.json
-test cases/warning/1 version for string div/meson.build
-test cases/warning/1 version for string div/test.json
-test cases/warning/1 version for string div/a/b.c
-test cases/warning/2 languages missing native/meson.build
-test cases/warning/2 languages missing native/test.json
-test cases/warning/3 fallback consistency/meson.build
-test cases/warning/3 fallback consistency/test.json
-test cases/warning/3 fallback consistency/subprojects/sub/meson.build
-test cases/warning/4 fallback consistency/meson.build
-test cases/warning/4 fallback consistency/test.json
-test cases/warning/4 fallback consistency/subprojects/sub/meson.build
-test cases/warning/5 fallback consistency/meson.build
-test cases/warning/5 fallback consistency/test.json
-test cases/warning/5 fallback consistency/subprojects/foo.wrap
-test cases/warning/5 fallback consistency/subprojects/foo/meson.build
-test cases/warning/6 list add/meson.build
-test cases/warning/6 list add/test.json
-test cases/wasm/1 basic/hello.c
-test cases/wasm/1 basic/hello.cpp
-test cases/wasm/1 basic/hello.html
-test cases/wasm/1 basic/meson.build
-test cases/wasm/2 threads/meson.build
-test cases/wasm/2 threads/threads.c
-test cases/wasm/2 threads/threads.cpp
-test cases/wasm/3 jslib/meson.build
-test cases/wasm/3 jslib/prog.c
-test cases/wasm/3 jslib/somefuncs.js
-test cases/wayland/1 client/both.c
-test cases/wayland/1 client/client.c
-test cases/wayland/1 client/local.c
-test cases/wayland/1 client/meson.build
-test cases/wayland/1 client/server.c
-test cases/wayland/1 client/test.xml
-test cases/windows/1 basic/meson.build
-test cases/windows/1 basic/prog.c
-test cases/windows/1 basic/test.json
-test cases/windows/10 vs module defs generated custom target/meson.build
-test cases/windows/10 vs module defs generated custom target/prog.c
-test cases/windows/10 vs module defs generated custom target/subdir/make_def.py
-test cases/windows/10 vs module defs generated custom target/subdir/meson.build
-test cases/windows/10 vs module defs generated custom target/subdir/somedll.c
-test cases/windows/11 exe implib/meson.build
-test cases/windows/11 exe implib/prog.c
-test cases/windows/11 exe implib/test.json
-test cases/windows/12 resources with custom targets/meson.build
-test cases/windows/12 resources with custom targets/prog.c
-test cases/windows/12 resources with custom targets/res/gen-res.py
-test cases/windows/12 resources with custom targets/res/meson.build
-test cases/windows/12 resources with custom targets/res/myres.rc.in
-test cases/windows/12 resources with custom targets/res/myres_static.rc
-test cases/windows/12 resources with custom targets/res/resource.h
-test cases/windows/12 resources with custom targets/res/sample.ico
-test cases/windows/13 test argument extra paths/meson.build
-test cases/windows/13 test argument extra paths/exe/main.c
-test cases/windows/13 test argument extra paths/exe/meson.build
-test cases/windows/13 test argument extra paths/lib/foo.c
-test cases/windows/13 test argument extra paths/lib/foo.h
-test cases/windows/13 test argument extra paths/lib/meson.build
-test cases/windows/13 test argument extra paths/test/meson.build
-test cases/windows/13 test argument extra paths/test/test_run_exe.py
-test cases/windows/14 resources with custom target depend_files/meson.build
-test cases/windows/14 resources with custom target depend_files/prog.c
-test cases/windows/14 resources with custom target depend_files/ico/gen-ico.py
-test cases/windows/14 resources with custom target depend_files/ico/meson.build
-test cases/windows/14 resources with custom target depend_files/ico/sample.ico.in
-test cases/windows/14 resources with custom target depend_files/res/meson.build
-test cases/windows/14 resources with custom target depend_files/res/myres.rc
-test cases/windows/15 resource scripts with duplicate filenames/meson.build
-test cases/windows/15 resource scripts with duplicate filenames/rsrc.rc
-test cases/windows/15 resource scripts with duplicate filenames/verify.c
-test cases/windows/15 resource scripts with duplicate filenames/a/meson.build
-test cases/windows/15 resource scripts with duplicate filenames/a/rsrc.rc
-test cases/windows/15 resource scripts with duplicate filenames/b/meson.build
-test cases/windows/15 resource scripts with duplicate filenames/b/rsrc.rc
-test cases/windows/15 resource scripts with duplicate filenames/c/meson.build
-test cases/windows/15 resource scripts with duplicate filenames/c/rsrc.rc
-test cases/windows/15 resource scripts with duplicate filenames/exe3/meson.build
-test cases/windows/15 resource scripts with duplicate filenames/exe3/src_dll/main.c
-test cases/windows/15 resource scripts with duplicate filenames/exe3/src_dll/version.rc
-test cases/windows/15 resource scripts with duplicate filenames/exe3/src_exe/main.c
-test cases/windows/15 resource scripts with duplicate filenames/exe3/src_exe/version.rc
-test cases/windows/15 resource scripts with duplicate filenames/exe4/meson.build
-test cases/windows/15 resource scripts with duplicate filenames/exe4/src_dll/main.c
-test cases/windows/15 resource scripts with duplicate filenames/exe4/src_dll/version.rc
-test cases/windows/15 resource scripts with duplicate filenames/exe4/src_exe/main.c
-test cases/windows/15 resource scripts with duplicate filenames/exe4/src_exe/version.rc
-test cases/windows/16 gui app/console_prog.c
-test cases/windows/16 gui app/dummy.c
-test cases/windows/16 gui app/gui_app_tester.py
-test cases/windows/16 gui app/gui_prog.c
-test cases/windows/16 gui app/meson.build
-test cases/windows/17 msvc ndebug/main.cpp
-test cases/windows/17 msvc ndebug/meson.build
-test cases/windows/18 msvc charset/iso-8859-1.c
-test cases/windows/18 msvc charset/meson.build
-test cases/windows/18 msvc charset/meson_options.txt
-test cases/windows/18 msvc charset/utf8.c
-test cases/windows/18 msvc cplusplus define/main.cpp
-test cases/windows/18 msvc cplusplus define/meson.build
-test cases/windows/19 vs install static lib with generated obj deps/both_lib_source.c
-test cases/windows/19 vs install static lib with generated obj deps/copyfile.py
-test cases/windows/19 vs install static lib with generated obj deps/generated_source.c
-test cases/windows/19 vs install static lib with generated obj deps/meson.build
-test cases/windows/19 vs install static lib with generated obj deps/static_lib_source.c
-test cases/windows/19 vs install static lib with generated obj deps/test.json
-test cases/windows/2 winmain/meson.build
-test cases/windows/2 winmain/prog.c
-test cases/windows/3 cpp/meson.build
-test cases/windows/3 cpp/prog.cpp
-test cases/windows/4 winmaincpp/meson.build
-test cases/windows/4 winmaincpp/prog.cpp
-test cases/windows/5 resources/meson.build
-test cases/windows/5 resources/prog.c
-test cases/windows/5 resources/inc/meson.build
-test cases/windows/5 resources/inc/resource/resource.h
-test cases/windows/5 resources/res/dummy.c
-test cases/windows/5 resources/res/meson.build
-test cases/windows/5 resources/res/myres.rc
-test cases/windows/5 resources/res/sample.ico
-test cases/windows/6 vs module defs/meson.build
-test cases/windows/6 vs module defs/prog.c
-test cases/windows/6 vs module defs/subdir/meson.build
-test cases/windows/6 vs module defs/subdir/somedll.c
-test cases/windows/6 vs module defs/subdir/somedll.def
-test cases/windows/7 dll versioning/copyfile.py
-test cases/windows/7 dll versioning/exe.orig.c
-test cases/windows/7 dll versioning/lib.c
-test cases/windows/7 dll versioning/meson.build
-test cases/windows/7 dll versioning/test.json
-test cases/windows/8 find program/meson.build
-test cases/windows/8 find program/test-script
-test cases/windows/8 find program/test-script-ext.py
-test cases/windows/9 vs module defs generated/meson.build
-test cases/windows/9 vs module defs generated/prog.c
-test cases/windows/9 vs module defs generated/subdir/meson.build
-test cases/windows/9 vs module defs generated/subdir/somedll.c
-test cases/windows/9 vs module defs generated/subdir/somedll.def.in
-tools/ac_converter.py
-tools/boost_names.py
-tools/build_website.py
-tools/cmake2meson.py
-tools/copy_files.py
-tools/dircondenser.py
-tools/regenerate_docs.py
-tools/run_with_cov.py
-unittests/allplatformstests.py
-unittests/baseplatformtests.py
-unittests/darwintests.py
-unittests/datatests.py
-unittests/failuretests.py
-unittests/helpers.py
-unittests/internaltests.py
-unittests/linuxcrosstests.py
-unittests/linuxliketests.py
-unittests/machinefiletests.py
-unittests/platformagnostictests.py
-unittests/pythontests.py
-unittests/rewritetests.py
-unittests/subprojectscommandtests.py
-unittests/taptests.py
-unittests/windowstests.py
\ No newline at end of file

_service:tar_scm:meson-0.63.2.tar.gz/meson.egg-info/dependency_links.txt Deleted

_service:tar_scm:meson-0.63.2.tar.gz/meson.egg-info/entry_points.txt Deleted

_service:tar_scm:meson-0.63.2.tar.gz/meson.egg-info/requires.txt Deleted

_service:tar_scm:meson-0.63.2.tar.gz/meson.egg-info/top_level.txt Deleted

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/mesonlib Deleted

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/mesonlib/__init__.py Deleted

@@ -1,32 +0,0 @@
-# SPDX-license-identifier: Apache-2.0
-# Copyright 2012-2021 The Meson development team
-# Copyright © 2021 Intel Corporation
-
-# 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.
-
-
-"""Helper functions and classes."""
-
-import os
-
-from .universal import *
-from .vsenv import setup_vsenv
-
-# Here we import either the posix implementations, the windows implementations,
-# or a generic no-op implementation
-if os.name == 'posix':
-    from .posix import *
-elif os.name == 'nt':
-    from .win32 import *
-else:
-    from .platform import *

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/mesonlib/platform.py Deleted

@@ -1,37 +0,0 @@
-# SPDX-license-identifier: Apache-2.0
-# Copyright 2012-2021 The Meson development team
-# Copyright © 2021 Intel Corporation
-
-# 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.
-
-"""base classes providing no-op functionality.."""
-
-import os
-import typing as T
-
-from .. import mlog
-
-__all__ = 'BuildDirLock'
-
-# This needs to be inherited by the specific implementations to make type
-# checking happy
-class BuildDirLock:
-
-    def __init__(self, builddir: str) -> None:
-        self.lockfilename = os.path.join(builddir, 'meson-private/meson.lock')
-
-    def __enter__(self) -> None:
-        mlog.debug('Calling the no-op version of BuildDirLock')
-
-    def __exit__(self, *args: T.Any) -> None:
-        pass

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/mesonlib/posix.py Deleted

@@ -1,39 +0,0 @@
-# SPDX-license-identifier: Apache-2.0
-# Copyright 2012-2021 The Meson development team
-# Copyright © 2021 Intel Corporation
-
-# 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.
-
-"""Posix specific implementations of mesonlib functionality."""
-
-import fcntl
-import typing as T
-
-from .universal import MesonException
-from .platform import BuildDirLock as BuildDirLockBase
-
-__all__ = 'BuildDirLock'
-
-class BuildDirLock(BuildDirLockBase):
-
-    def __enter__(self) -> None:
-        self.lockfile = open(self.lockfilename, 'w', encoding='utf-8')
-        try:
-            fcntl.flock(self.lockfile, fcntl.LOCK_EX | fcntl.LOCK_NB)
-        except (BlockingIOError, PermissionError):
-            self.lockfile.close()
-            raise MesonException('Some other Meson process is already using this build directory. Exiting.')
-
-    def __exit__(self, *args: T.Any) -> None:
-        fcntl.flock(self.lockfile, fcntl.LOCK_UN)
-        self.lockfile.close()

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/mesonlib/universal.py Deleted

@@ -1,2294 +0,0 @@
-# Copyright 2012-2020 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.
-
-"""A library of random helper functionality."""
-
-from __future__ import annotations
-from pathlib import Path
-import argparse
-import enum
-import sys
-import stat
-import time
-import abc
-import platform, subprocess, operator, os, shlex, shutil, re
-import collections
-from functools import lru_cache, wraps, total_ordering
-from itertools import tee, filterfalse
-from tempfile import TemporaryDirectory, NamedTemporaryFile
-import typing as T
-import textwrap
-import copy
-import pickle
-
-from mesonbuild import mlog
-
-if T.TYPE_CHECKING:
-    from typing_extensions import Literal
-
-    from .._typing import ImmutableListProtocol
-    from ..build import ConfigurationData
-    from ..coredata import KeyedOptionDictType, UserOption
-    from ..compilers.compilers import Compiler
-    from ..mparser import BaseNode
-
-FileOrString = T.Union'File', str
-
-_T = T.TypeVar('_T')
-_U = T.TypeVar('_U')
-
-__all__ = 
-    'GIT',
-    'python_command',
-    'project_meson_versions',
-    'HoldableObject',
-    'SecondLevelHolder',
-    'File',
-    'FileMode',
-    'GitException',
-    'LibType',
-    'MachineChoice',
-    'MesonException',
-    'MesonBugException',
-    'EnvironmentException',
-    'FileOrString',
-    'GitException',
-    'OptionKey',
-    'dump_conf_header',
-    'OptionOverrideProxy',
-    'OptionType',
-    'OrderedSet',
-    'PerMachine',
-    'PerMachineDefaultable',
-    'PerThreeMachine',
-    'PerThreeMachineDefaultable',
-    'ProgressBar',
-    'RealPathAction',
-    'TemporaryDirectoryWinProof',
-    'Version',
-    'check_direntry_issues',
-    'classify_unity_sources',
-    'current_vs_supports_modules',
-    'darwin_get_object_archs',
-    'default_libdir',
-    'default_libexecdir',
-    'default_prefix',
-    'detect_subprojects',
-    'detect_vcs',
-    'do_conf_file',
-    'do_conf_str',
-    'do_replacement',
-    'exe_exists',
-    'expand_arguments',
-    'extract_as_list',
-    'generate_list',
-    'get_compiler_for_source',
-    'get_filenames_templates_dict',
-    'get_library_dirs',
-    'get_variable_regex',
-    'get_wine_shortpath',
-    'git',
-    'has_path_sep',
-    'is_aix',
-    'is_android',
-    'is_ascii_string',
-    'is_cygwin',
-    'is_debianlike',
-    'is_dragonflybsd',
-    'is_freebsd',
-    'is_haiku',
-    'is_hurd',
-    'is_irix',
-    'is_linux',
-    'is_netbsd',
-    'is_openbsd',
-    'is_osx',
-    'is_qnx',
-    'is_sunos',
-    'is_windows',
-    'is_wsl',
-    'iter_regexin_iter',
-    'join_args',
-    'listify',
-    'partition',
-    'path_is_in_root',
-    'pickle_load',
-    'Popen_safe',
-    'quiet_git',
-    'quote_arg',
-    'relative_to_if_possible',
-    'relpath',
-    'replace_if_different',
-    'run_once',
-    'get_meson_command',
-    'set_meson_command',
-    'split_args',
-    'stringlistify',
-    'substitute_values',
-    'substring_is_in_list',
-    'typeslistify',
-    'verbose_git',
-    'version_compare',
-    'version_compare_condition_with_min',
-    'version_compare_many',
-    'search_version',
-    'windows_proof_rm',
-    'windows_proof_rmtree',
-
-
-
-# TODO: this is such a hack, this really should be either in coredata or in the
-# interpreter
-# {subproject: project_meson_version}
-project_meson_versions = collections.defaultdict(str)  # type: T.DefaultDictstr, str
-
-
-from glob import glob
-
-if os.path.basename(sys.executable) == 'meson.exe':
-    # In Windows and using the MSI installed executable.
-    python_command = sys.executable, 'runpython'
-else:
-    python_command = sys.executable
-_meson_command: T.Optional'ImmutableListProtocolstr' = None
-
-class MesonException(Exception):
-    '''Exceptions thrown by Meson'''
-
-    def __init__(self, *args: object, file: T.Optionalstr = None,
-                 lineno: T.Optionalint = None, colno: T.Optionalint = None):
-        super().__init__(*args)
-        self.file = file
-        self.lineno = lineno
-        self.colno = colno
-
-    @classmethod
-    def from_node(cls, *args: object, node: BaseNode) -> MesonException:
-        """Create a MesonException with location data from a BaseNode
-
-        :param node: A BaseNode to set location data from
-        :return: A Meson Exception instance
-        """
-        return cls(*args, file=node.filename, lineno=node.lineno, colno=node.colno)
-
-
-class MesonBugException(MesonException):
-    '''Exceptions thrown when there is a clear Meson bug that should be reported'''
-
-    def __init__(self, msg: str, file: T.Optionalstr = None,
-                 lineno: T.Optionalint = None, colno: T.Optionalint = None):
-        super().__init__(msg + '\n\n    This is a Meson bug and should be reported!',
-                         file=file, lineno=lineno, colno=colno)
-
-class EnvironmentException(MesonException):
-    '''Exceptions thrown while processing and creating the build environment'''
-
-class GitException(MesonException):
-    def __init__(self, msg: str, output: T.Optionalstr = None):
-        super().__init__(msg)
-        self.output = output.strip() if output else ''
-
-GIT = shutil.which('git')
-def git(cmd: T.Liststr, workingdir: T.Unionstr, bytes, os.PathLike, check: bool = False, **kwargs: T.Any) -> T.Tuplesubprocess.Popen, str, str:
-    cmd = GIT + cmd
-    p, o, e = Popen_safe(cmd, cwd=workingdir, **kwargs)
-    if check and p.returncode != 0:
-        raise GitException('Git command failed: ' + str(cmd), e)
-    return p, o, e
-
-def quiet_git(cmd: T.Liststr, workingdir: T.Unionstr, bytes, os.PathLike, check: bool = False) -> T.Tuplebool, str:
-    if not GIT:
-        m = 'Git program not found.'
-        if check:
-            raise GitException(m)
-        return False, m
-    p, o, e = git(cmd, workingdir, check)
-    if p.returncode != 0:
-        return False, e
-    return True, o
-
-def verbose_git(cmd: T.Liststr, workingdir: T.Unionstr, bytes, os.PathLike, check: bool = False) -> bool:
-    if not GIT:
-        m = 'Git program not found.'
-        if check:
-            raise GitException(m)
-        return False
-    p, _, _ = git(cmd, workingdir, check, stdout=None, stderr=None)
-    return p.returncode == 0
-
-def set_meson_command(mainfile: str) -> None:
-    global python_command
-    global _meson_command
-    # On UNIX-like systems `meson` is a Python script
-    # On Windows `meson` and `meson.exe` are wrapper exes
-    if not mainfile.endswith('.py'):
-        _meson_command = mainfile
-    elif os.path.isabs(mainfile) and mainfile.endswith('mesonmain.py'):
-        # Can't actually run meson with an absolute path to mesonmain.py, it must be run as -m mesonbuild.mesonmain
-        _meson_command = python_command + '-m', 'mesonbuild.mesonmain'
-    else:
-        # Either run uninstalled, or full path to meson-script.py
-        _meson_command = python_command + mainfile
-    # We print this value for unit tests.
-    if 'MESON_COMMAND_TESTS' in os.environ:
-        mlog.log(f'meson_command is {_meson_command!r}')
-
-
-def get_meson_command() -> T.Optional'ImmutableListProtocolstr':
-    return _meson_command
-
-
-def is_ascii_string(astring: T.Unionstr, bytes) -> bool:
-    try:
-        if isinstance(astring, str):
-            astring.encode('ascii')
-        elif isinstance(astring, bytes):
-            astring.decode('ascii')
-    except UnicodeDecodeError:
-        return False
-    return True
-
-
-def check_direntry_issues(direntry_array: T.UnionT.IterableT.Unionstr, bytes, str, bytes) -> None:
-    import locale
-    # Warn if the locale is not UTF-8. This can cause various unfixable issues
-    # such as os.stat not being able to decode filenames with unicode in them.
-    # There is no way to reset both the preferred encoding and the filesystem
-    # encoding, so we can just warn about it.
-    e = locale.getpreferredencoding()
-    if e.upper() != 'UTF-8' and not is_windows():
-        if isinstance(direntry_array, (str, bytes)):
-            direntry_array = direntry_array
-        for de in direntry_array:
-            if is_ascii_string(de):
-                continue
-            mlog.warning(textwrap.dedent(f'''
-                You are using {e!r} which is not a Unicode-compatible
-                locale but you are trying to access a file system entry called {de!r} which is
-                not pure ASCII. This may cause problems.
-                '''), file=sys.stderr)
-
-class HoldableObject(metaclass=abc.ABCMeta):
-    ''' Dummy base class for all objects that can be
-        held by an interpreter.baseobjects.ObjectHolder '''
-
-class SecondLevelHolder(HoldableObject, metaclass=abc.ABCMeta):
-    ''' A second level object holder. The primary purpose
-        of such objects is to hold multiple objects with one
-        default option. '''
-
-    @abc.abstractmethod
-    def get_default_object(self) -> HoldableObject: ...
-
-class FileMode:
-    # The first triad is for owner permissions, the second for group permissions,
-    # and the third for others (everyone else).
-    # For the 1st character:
-    #  'r' means can read
-    #  '-' means not allowed
-    # For the 2nd character:
-    #  'w' means can write
-    #  '-' means not allowed
-    # For the 3rd character:
-    #  'x' means can execute
-    #  's' means can execute and setuid/setgid is set (owner/group triads only)
-    #  'S' means cannot execute and setuid/setgid is set (owner/group triads only)
-    #  't' means can execute and sticky bit is set ("others" triads only)
-    #  'T' means cannot execute and sticky bit is set ("others" triads only)
-    #  '-' means none of these are allowed
-    #
-    # The meanings of 'rwx' perms is not obvious for directories; see:
-    # https://www.hackinglinuxexposed.com/articles/20030424.html
-    #
-    # For information on this notation such as setuid/setgid/sticky bits, see:
-    # https://en.wikipedia.org/wiki/File_system_permissions#Symbolic_notation
-    symbolic_perms_regex = re.compile('r-w-xsS-' # Owner perms
-                                      'r-w-xsS-' # Group perms
-                                      'r-w-xtT-') # Others perms
-
-    def __init__(self, perms: T.Optionalstr = None, owner: T.Unionstr, int, None = None,
-                 group: T.Unionstr, int, None = None):
-        self.perms_s = perms
-        self.perms = self.perms_s_to_bits(perms)
-        self.owner = owner
-        self.group = group
-
-    def __repr__(self) -> str:
-        ret = '<FileMode: {!r} owner={} group={}'
-        return ret.format(self.perms_s, self.owner, self.group)
-
-    @classmethod
-    def perms_s_to_bits(cls, perms_s: T.Optionalstr) -> int:
-        '''
-        Does the opposite of stat.filemode(), converts strings of the form
-        'rwxr-xr-x' to st_mode enums which can be passed to os.chmod()
-        '''
-        if perms_s is None:
-            # No perms specified, we will not touch the permissions
-            return -1
-        eg = 'rwxr-xr-x'
-        if not isinstance(perms_s, str):
-            raise MesonException(f'Install perms must be a string. For example, {eg!r}')
-        if len(perms_s) != 9 or not cls.symbolic_perms_regex.match(perms_s):
-            raise MesonException(f'File perms {perms_s!r} must be exactly 9 chars. For example, {eg!r}')
-        perms = 0
-        # Owner perms
-        if perms_s0 == 'r':
-            perms |= stat.S_IRUSR
-        if perms_s1 == 'w':
-            perms |= stat.S_IWUSR
-        if perms_s2 == 'x':
-            perms |= stat.S_IXUSR
-        elif perms_s2 == 'S':
-            perms |= stat.S_ISUID
-        elif perms_s2 == 's':
-            perms |= stat.S_IXUSR
-            perms |= stat.S_ISUID
-        # Group perms
-        if perms_s3 == 'r':
-            perms |= stat.S_IRGRP
-        if perms_s4 == 'w':
-            perms |= stat.S_IWGRP
-        if perms_s5 == 'x':
-            perms |= stat.S_IXGRP
-        elif perms_s5 == 'S':
-            perms |= stat.S_ISGID
-        elif perms_s5 == 's':
-            perms |= stat.S_IXGRP
-            perms |= stat.S_ISGID
-        # Others perms
-        if perms_s6 == 'r':
-            perms |= stat.S_IROTH
-        if perms_s7 == 'w':
-            perms |= stat.S_IWOTH
-        if perms_s8 == 'x':
-            perms |= stat.S_IXOTH
-        elif perms_s8 == 'T':
-            perms |= stat.S_ISVTX
-        elif perms_s8 == 't':
-            perms |= stat.S_IXOTH
-            perms |= stat.S_ISVTX
-        return perms
-
-dot_C_dot_H_warning = """You are using .C or .H files in your project. This is deprecated.
-         Currently, Meson treats this as C++ code, but they
-            used to be treated as C code.
-         Note that the situation is a bit more complex if you are using the
-         Visual Studio compiler, as it treats .C files as C code, unless you add
-         the /TP compiler flag, but this is unreliable.
-         See https://github.com/mesonbuild/meson/pull/8747 for the discussions."""
-class File(HoldableObject):
-    def __init__(self, is_built: bool, subdir: str, fname: str):
-        if fname.endswith(".C") or fname.endswith(".H"):
-            mlog.warning(dot_C_dot_H_warning, once=True)
-        self.is_built = is_built
-        self.subdir = subdir
-        self.fname = fname
-        self.hash = hash((is_built, subdir, fname))
-
-    def __str__(self) -> str:
-        return self.relative_name()
-
-    def __repr__(self) -> str:
-        ret = '<File: {0}'
-        if not self.is_built:
-            ret += ' (not built)'
-        ret += '>'
-        return ret.format(self.relative_name())
-
-    @staticmethod
-    @lru_cache(maxsize=None)
-    def from_source_file(source_root: str, subdir: str, fname: str) -> 'File':
-        if not os.path.isfile(os.path.join(source_root, subdir, fname)):
-            raise MesonException(f'File {fname} does not exist.')
-        return File(False, subdir, fname)
-
-    @staticmethod
-    def from_built_file(subdir: str, fname: str) -> 'File':
-        return File(True, subdir, fname)
-
-    @staticmethod
-    def from_absolute_file(fname: str) -> 'File':
-        return File(False, '', fname)
-
-    @lru_cache(maxsize=None)
-    def rel_to_builddir(self, build_to_src: str) -> str:
-        if self.is_built:
-            return self.relative_name()
-        else:
-            return os.path.join(build_to_src, self.subdir, self.fname)
-
-    @lru_cache(maxsize=None)
-    def absolute_path(self, srcdir: str, builddir: str) -> str:
-        absdir = srcdir
-        if self.is_built:
-            absdir = builddir
-        return os.path.join(absdir, self.relative_name())
-
-    @property
-    def suffix(self) -> str:
-        return os.path.splitext(self.fname)11:.lower()
-
-    def endswith(self, ending: T.Unionstr, T.Tuplestr, ...) -> bool:
-        return self.fname.endswith(ending)
-
-    def split(self, s: str, maxsplit: int = -1) -> T.Liststr:
-        return self.fname.split(s, maxsplit=maxsplit)
-
-    def rsplit(self, s: str, maxsplit: int = -1) -> T.Liststr:
-        return self.fname.rsplit(s, maxsplit=maxsplit)
-
-    def __eq__(self, other: object) -> bool:
-        if not isinstance(other, File):
-            return NotImplemented
-        if self.hash != other.hash:
-            return False
-        return (self.fname, self.subdir, self.is_built) == (other.fname, other.subdir, other.is_built)
-
-    def __hash__(self) -> int:
-        return self.hash
-
-    @lru_cache(maxsize=None)
-    def relative_name(self) -> str:
-        return os.path.join(self.subdir, self.fname)
-
-
-def get_compiler_for_source(compilers: T.Iterable'Compiler', src: 'FileOrString') -> 'Compiler':
-    """Given a set of compilers and a source, find the compiler for that source type."""
-    for comp in compilers:
-        if comp.can_compile(src):
-            return comp
-    raise MesonException(f'No specified compiler can handle file {src!s}')
-
-
-def classify_unity_sources(compilers: T.Iterable'Compiler', sources: T.Sequence'FileOrString') -> T.Dict'Compiler', T.List'FileOrString':
-    compsrclist: T.Dict'Compiler', T.List'FileOrString' = {}
-    for src in sources:
-        comp = get_compiler_for_source(compilers, src)
-        if comp not in compsrclist:
-            compsrclistcomp = src
-        else:
-            compsrclistcomp.append(src)
-    return compsrclist
-
-
-class MachineChoice(enum.IntEnum):
-
-    """Enum class representing one of the two abstract machine names used in
-    most places: the build, and host, machines.
-    """
-
-    BUILD = 0
-    HOST = 1
-
-    def get_lower_case_name(self) -> str:
-        return PerMachine('build', 'host')self
-
-    def get_prefix(self) -> str:
-        return PerMachine('build.', '')self
-
-
-class PerMachine(T.Generic_T):
-    def __init__(self, build: _T, host: _T) -> None:
-        self.build = build
-        self.host = host
-
-    def __getitem__(self, machine: MachineChoice) -> _T:
-        return {
-            MachineChoice.BUILD:  self.build,
-            MachineChoice.HOST:   self.host,
-        }machine
-
-    def __setitem__(self, machine: MachineChoice, val: _T) -> None:
-        setattr(self, machine.get_lower_case_name(), val)
-
-    def miss_defaulting(self) -> "PerMachineDefaultableT.Optional_T":
-        """Unset definition duplicated from their previous to None
-
-        This is the inverse of ''default_missing''. By removing defaulted
-        machines, we can elaborate the original and then redefault them and thus
-        avoid repeating the elaboration explicitly.
-        """
-        unfreeze = PerMachineDefaultable() # type: PerMachineDefaultableT.Optional_T
-        unfreeze.build = self.build
-        unfreeze.host = self.host
-        if unfreeze.host == unfreeze.build:
-            unfreeze.host = None
-        return unfreeze
-
-    def __repr__(self) -> str:
-        return f'PerMachine({self.build!r}, {self.host!r})'
-
-
-class PerThreeMachine(PerMachine_T):
-    """Like `PerMachine` but includes `target` too.
-
-    It turns out just one thing do we need track the target machine. There's no
-    need to computer the `target` field so we don't bother overriding the
-    `__getitem__`/`__setitem__` methods.
-    """
-    def __init__(self, build: _T, host: _T, target: _T) -> None:
-        super().__init__(build, host)
-        self.target = target
-
-    def miss_defaulting(self) -> "PerThreeMachineDefaultableT.Optional_T":
-        """Unset definition duplicated from their previous to None
-
-        This is the inverse of ''default_missing''. By removing defaulted
-        machines, we can elaborate the original and then redefault them and thus
-        avoid repeating the elaboration explicitly.
-        """
-        unfreeze = PerThreeMachineDefaultable() # type: PerThreeMachineDefaultableT.Optional_T
-        unfreeze.build = self.build
-        unfreeze.host = self.host
-        unfreeze.target = self.target
-        if unfreeze.target == unfreeze.host:
-            unfreeze.target = None
-        if unfreeze.host == unfreeze.build:
-            unfreeze.host = None
-        return unfreeze
-
-    def matches_build_machine(self, machine: MachineChoice) -> bool:
-        return self.build == selfmachine
-
-    def __repr__(self) -> str:
-        return f'PerThreeMachine({self.build!r}, {self.host!r}, {self.target!r})'
-
-
-class PerMachineDefaultable(PerMachineT.Optional_T):
-    """Extends `PerMachine` with the ability to default from `None`s.
-    """
-    def __init__(self, build: T.Optional_T = None, host: T.Optional_T = None) -> None:
-        super().__init__(build, host)
-
-    def default_missing(self) -> "PerMachine_T":
-        """Default host to build
-
-        This allows just specifying nothing in the native case, and just host in the
-        cross non-compiler case.
-        """
-        freeze = PerMachine(self.build, self.host)
-        if freeze.host is None:
-            freeze.host = freeze.build
-        return freeze
-
-    def __repr__(self) -> str:
-        return f'PerMachineDefaultable({self.build!r}, {self.host!r})'
-
-    @classmethod
-    def default(cls, is_cross: bool, build: _T, host: _T) -> PerMachine_T:
-        """Easy way to get a defaulted value
-
-        This allows simplifying the case where you can control whether host and
-        build are separate or not with a boolean. If the is_cross value is set
-        to true then the optional host value will be used, otherwise the host
-        will be set to the build value.
-        """
-        m = cls(build)
-        if is_cross:
-            m.host = host
-        return m.default_missing()
-
-
-class PerThreeMachineDefaultable(PerMachineDefaultable, PerThreeMachineT.Optional_T):
-    """Extends `PerThreeMachine` with the ability to default from `None`s.
-    """
-    def __init__(self) -> None:
-        PerThreeMachine.__init__(self, None, None, None)
-
-    def default_missing(self) -> "PerThreeMachineT.Optional_T":
-        """Default host to build and target to host.
-
-        This allows just specifying nothing in the native case, just host in the
-        cross non-compiler case, and just target in the native-built
-        cross-compiler case.
-        """
-        freeze = PerThreeMachine(self.build, self.host, self.target)
-        if freeze.host is None:
-            freeze.host = freeze.build
-        if freeze.target is None:
-            freeze.target = freeze.host
-        return freeze
-
-    def __repr__(self) -> str:
-        return f'PerThreeMachineDefaultable({self.build!r}, {self.host!r}, {self.target!r})'
-
-
-def is_sunos() -> bool:
-    return platform.system().lower() == 'sunos'
-
-
-def is_osx() -> bool:
-    return platform.system().lower() == 'darwin'
-
-
-def is_linux() -> bool:
-    return platform.system().lower() == 'linux'
-
-
-def is_android() -> bool:
-    return platform.system().lower() == 'android'
-
-
-def is_haiku() -> bool:
-    return platform.system().lower() == 'haiku'
-
-
-def is_openbsd() -> bool:
-    return platform.system().lower() == 'openbsd'
-
-
-def is_windows() -> bool:
-    platname = platform.system().lower()
-    return platname == 'windows'
-
-def is_wsl() -> bool:
-    return is_linux() and 'microsoft' in platform.release().lower()
-
-def is_cygwin() -> bool:
-    return sys.platform == 'cygwin'
-
-
-def is_debianlike() -> bool:
-    return os.path.isfile('/etc/debian_version')
-
-
-def is_dragonflybsd() -> bool:
-    return platform.system().lower() == 'dragonfly'
-
-
-def is_netbsd() -> bool:
-    return platform.system().lower() == 'netbsd'
-
-
-def is_freebsd() -> bool:
-    return platform.system().lower() == 'freebsd'
-
-def is_irix() -> bool:
-    return platform.system().startswith('irix')
-
-def is_hurd() -> bool:
-    return platform.system().lower() == 'gnu'
-
-def is_qnx() -> bool:
-    return platform.system().lower() == 'qnx'
-
-def is_aix() -> bool:
-    return platform.system().lower() == 'aix'
-
-def exe_exists(arglist: T.Liststr) -> bool:
-    try:
-        if subprocess.run(arglist, timeout=10).returncode == 0:
-            return True
-    except (FileNotFoundError, subprocess.TimeoutExpired):
-        pass
-    return False
-
-
-@lru_cache(maxsize=None)
-def darwin_get_object_archs(objpath: str) -> 'ImmutableListProtocolstr':
-    '''
-    For a specific object (executable, static library, dylib, etc), run `lipo`
-    to fetch the list of archs supported by it. Supports both thin objects and
-    'fat' objects.
-    '''
-    _, stdo, stderr = Popen_safe('lipo', '-info', objpath)
-    if not stdo:
-        mlog.debug(f'lipo {objpath}: {stderr}')
-        return None
-    stdo = stdo.rsplit(': ', 1)1
-    # Convert from lipo-style archs to meson-style CPUs
-    stdo = stdo.replace('i386', 'x86')
-    stdo = stdo.replace('arm64', 'aarch64')
-    stdo = stdo.replace('ppc7400', 'ppc')
-    stdo = stdo.replace('ppc970', 'ppc')
-    # Add generic name for armv7 and armv7s
-    if 'armv7' in stdo:
-        stdo += ' arm'
-    return stdo.split()
-
-
-def detect_vcs(source_dir: T.Unionstr, Path) -> T.OptionalT.Dictstr, str:
-    vcs_systems = 
-        dict(name = 'git',        cmd = 'git', repo_dir = '.git', get_rev = 'git describe --dirty=+', rev_regex = '(.*)', dep = '.git/logs/HEAD'),
-        dict(name = 'mercurial',  cmd = 'hg',  repo_dir = '.hg',  get_rev = 'hg id -i',               rev_regex = '(.*)', dep = '.hg/dirstate'),
-        dict(name = 'subversion', cmd = 'svn', repo_dir = '.svn', get_rev = 'svn info',               rev_regex = 'Revision: (.*)', dep = '.svn/wc.db'),
-        dict(name = 'bazaar',     cmd = 'bzr', repo_dir = '.bzr', get_rev = 'bzr revno',              rev_regex = '(.*)', dep = '.bzr'),
-    
-    if isinstance(source_dir, str):
-        source_dir = Path(source_dir)
-
-    parent_paths_and_self = collections.deque(source_dir.parents)
-    # Prepend the source directory to the front so we can check it;
-    # source_dir.parents doesn't include source_dir
-    parent_paths_and_self.appendleft(source_dir)
-    for curdir in parent_paths_and_self:
-        for vcs in vcs_systems:
-            if Path.is_dir(curdir.joinpath(vcs'repo_dir')) and shutil.which(vcs'cmd'):
-                vcs'wc_dir' = str(curdir)
-                return vcs
-    return None
-
-def current_vs_supports_modules() -> bool:
-    vsver = os.environ.get('VSCMD_VER', '')
-    nums = vsver.split('.', 2)
-    major = int(nums0)
-    if major >= 17:
-        return True
-    if major == 16 and int(nums1) >= 10:
-        return True
-    return vsver.startswith('16.9.0') and '-pre.' in vsver
-
-# a helper class which implements the same version ordering as RPM
-class Version:
-    def __init__(self, s: str) -> None:
-        self._s = s
-
-        # split into numeric, alphabetic and non-alphanumeric sequences
-        sequences1 = re.finditer(r'(\d+|a-zA-Z+|^a-zA-Z\d+)', s)
-
-        # non-alphanumeric separators are discarded
-        sequences2 = m for m in sequences1 if not re.match(r'^a-zA-Z\d+', m.group(1))
-
-        # numeric sequences are converted from strings to ints
-        sequences3 = int(m.group(1)) if m.group(1).isdigit() else m.group(1) for m in sequences2
-
-        self._v = sequences3
-
-    def __str__(self) -> str:
-        return '{} (V={})'.format(self._s, str(self._v))
-
-    def __repr__(self) -> str:
-        return f'<Version: {self._s}>'
-
-    def __lt__(self, other: object) -> bool:
-        if isinstance(other, Version):
-            return self.__cmp(other, operator.lt)
-        return NotImplemented
-
-    def __gt__(self, other: object) -> bool:
-        if isinstance(other, Version):
-            return self.__cmp(other, operator.gt)
-        return NotImplemented
-
-    def __le__(self, other: object) -> bool:
-        if isinstance(other, Version):
-            return self.__cmp(other, operator.le)
-        return NotImplemented
-
-    def __ge__(self, other: object) -> bool:
-        if isinstance(other, Version):
-            return self.__cmp(other, operator.ge)
-        return NotImplemented
-
-    def __eq__(self, other: object) -> bool:
-        if isinstance(other, Version):
-            return self._v == other._v
-        return NotImplemented
-
-    def __ne__(self, other: object) -> bool:
-        if isinstance(other, Version):
-            return self._v != other._v
-        return NotImplemented
-
-    def __cmp(self, other: 'Version', comparator: T.CallableT.Any, T.Any, bool) -> bool:
-        # compare each sequence in order
-        for ours, theirs in zip(self._v, other._v):
-            # sort a non-digit sequence before a digit sequence
-            ours_is_int = isinstance(ours, int)
-            theirs_is_int = isinstance(theirs, int)
-            if ours_is_int != theirs_is_int:
-                return comparator(ours_is_int, theirs_is_int)
-
-            if ours != theirs:
-                return comparator(ours, theirs)
-
-        # if equal length, all components have matched, so equal
-        # otherwise, the version with a suffix remaining is greater
-        return comparator(len(self._v), len(other._v))
-
-
-def _version_extract_cmpop(vstr2: str) -> T.TupleT.CallableT.Any, T.Any, bool, str:
-    if vstr2.startswith('>='):
-        cmpop = operator.ge
-        vstr2 = vstr22:
-    elif vstr2.startswith('<='):
-        cmpop = operator.le
-        vstr2 = vstr22:
-    elif vstr2.startswith('!='):
-        cmpop = operator.ne
-        vstr2 = vstr22:
-    elif vstr2.startswith('=='):
-        cmpop = operator.eq
-        vstr2 = vstr22:
-    elif vstr2.startswith('='):
-        cmpop = operator.eq
-        vstr2 = vstr21:
-    elif vstr2.startswith('>'):
-        cmpop = operator.gt
-        vstr2 = vstr21:
-    elif vstr2.startswith('<'):
-        cmpop = operator.lt
-        vstr2 = vstr21:
-    else:
-        cmpop = operator.eq
-
-    return (cmpop, vstr2)
-
-
-def version_compare(vstr1: str, vstr2: str) -> bool:
-    (cmpop, vstr2) = _version_extract_cmpop(vstr2)
-    return cmpop(Version(vstr1), Version(vstr2))
-
-
-def version_compare_many(vstr1: str, conditions: T.Unionstr, T.Iterablestr) -> T.Tuplebool, T.Liststr, T.Liststr:
-    if isinstance(conditions, str):
-        conditions = conditions
-    found = 
-    not_found = 
-    for req in conditions:
-        if not version_compare(vstr1, req):
-            not_found.append(req)
-        else:
-            found.append(req)
-    return not_found == , not_found, found
-
-
-# determine if the minimum version satisfying the condition |condition| exceeds
-# the minimum version for a feature |minimum|
-def version_compare_condition_with_min(condition: str, minimum: str) -> bool:
-    if condition.startswith('>='):
-        cmpop = operator.le
-        condition = condition2:
-    elif condition.startswith('<='):
-        return False
-    elif condition.startswith('!='):
-        return False
-    elif condition.startswith('=='):
-        cmpop = operator.le
-        condition = condition2:
-    elif condition.startswith('='):
-        cmpop = operator.le
-        condition = condition1:
-    elif condition.startswith('>'):
-        cmpop = operator.lt
-        condition = condition1:
-    elif condition.startswith('<'):
-        return False
-    else:
-        cmpop = operator.le
-
-    # Declaring a project(meson_version: '>=0.46') and then using features in
-    # 0.46.0 is valid, because (knowing the meson versioning scheme) '0.46.0' is
-    # the lowest version which satisfies the constraint '>=0.46'.
-    #
-    # But this will fail here, because the minimum version required by the
-    # version constraint ('0.46') is strictly less (in our version comparison)
-    # than the minimum version needed for the feature ('0.46.0').
-    #
-    # Map versions in the constraint of the form '0.46' to '0.46.0', to embed
-    # this knowledge of the meson versioning scheme.
-    condition = condition.strip()
-    if re.match(r'^\d+.\d+$', condition):
-        condition += '.0'
-
-    return T.cast('bool', cmpop(Version(minimum), Version(condition)))
-
-def search_version(text: str) -> str:
-    # Usually of the type 4.1.4 but compiler output may contain
-    # stuff like this:
-    # (Sourcery CodeBench Lite 2014.05-29) 4.8.3 20140320 (prerelease)
-    # Limiting major version number to two digits seems to work
-    # thus far. When we get to GCC 100, this will break, but
-    # if we are still relevant when that happens, it can be
-    # considered an achievement in itself.
-    #
-    # This regex is reaching magic levels. If it ever needs
-    # to be updated, do not complexify but convert to something
-    # saner instead.
-    # We'll demystify it a bit with a verbose definition.
-    version_regex = re.compile(r"""
-    (?<!                # Zero-width negative lookbehind assertion
-        (
-            \d          # One digit
-            | \.        # Or one period
-        )               # One occurrence
-    )
-    # Following pattern must not follow a digit or period
-    (
-        \d{1,2}         # One or two digits
-        (
-            \.\d+       # Period and one or more digits
-        )+              # One or more occurrences
-        (
-            -a-zA-Z0-9+   # Hyphen and one or more alphanumeric
-        )?              # Zero or one occurrence
-    )                   # One occurrence
-    """, re.VERBOSE)
-    match = version_regex.search(text)
-    if match:
-        return match.group(0)
-
-    # try a simpler regex that has like "blah 2020.01.100 foo" or "blah 2020.01 foo"
-    version_regex = re.compile(r"(\d{1,4}\.\d{1,4}\.?\d{0,4})")
-    match = version_regex.search(text)
-    if match:
-        return match.group(0)
-
-    return 'unknown version'
-
-
-def default_libdir() -> str:
-    if is_debianlike():
-        try:
-            pc = subprocess.Popen('dpkg-architecture', '-qDEB_HOST_MULTIARCH',
-                                  stdout=subprocess.PIPE,
-                                  stderr=subprocess.DEVNULL)
-            (stdo, _) = pc.communicate()
-            if pc.returncode == 0:
-                archpath = stdo.decode().strip()
-                return 'lib/' + archpath
-        except Exception:
-            pass
-    if is_freebsd() or is_irix():
-        return 'lib'
-    if os.path.isdir('/usr/lib64') and not os.path.islink('/usr/lib64'):
-        return 'lib64'
-    return 'lib'
-
-
-def default_libexecdir() -> str:
-    # There is no way to auto-detect this, so it must be set at build time
-    return 'libexec'
-
-
-def default_prefix() -> str:
-    return 'c:/' if is_windows() else '/usr/local'
-
-
-def get_library_dirs() -> T.Liststr:
-    if is_windows():
-        return 'C:/mingw/lib' # TODO: get programmatically
-    if is_osx():
-        return '/usr/lib' # TODO: get programmatically
-    # The following is probably Debian/Ubuntu specific.
-    # /usr/local/lib is first because it contains stuff
-    # installed by the sysadmin and is probably more up-to-date
-    # than /usr/lib. If you feel that this search order is
-    # problematic, please raise the issue on the mailing list.
-    unixdirs = '/usr/local/lib', '/usr/lib', '/lib'
-
-    if is_freebsd():
-        return unixdirs
-    # FIXME: this needs to be further genericized for aarch64 etc.
-    machine = platform.machine()
-    if machine in ('i386', 'i486', 'i586', 'i686'):
-        plat = 'i386'
-    elif machine.startswith('arm'):
-        plat = 'arm'
-    else:
-        plat = ''
-
-    # Solaris puts 32-bit libraries in the main /lib & /usr/lib directories
-    # and 64-bit libraries in platform specific subdirectories.
-    if is_sunos():
-        if machine == 'i86pc':
-            plat = 'amd64'
-        elif machine.startswith('sun4'):
-            plat = 'sparcv9'
-
-    usr_platdir = Path('/usr/lib/') / plat
-    if usr_platdir.is_dir():
-        unixdirs += str(x) for x in (usr_platdir).iterdir() if x.is_dir()
-    if os.path.exists('/usr/lib64'):
-        unixdirs.append('/usr/lib64')
-
-    lib_platdir = Path('/lib/') / plat
-    if lib_platdir.is_dir():
-        unixdirs += str(x) for x in (lib_platdir).iterdir() if x.is_dir()
-    if os.path.exists('/lib64'):
-        unixdirs.append('/lib64')
-
-    return unixdirs
-
-
-def has_path_sep(name: str, sep: str = '/\\') -> bool:
-    'Checks if any of the specified @sep path separators are in @name'
-    for each in sep:
-        if each in name:
-            return True
-    return False
-
-
-if is_windows():
-    # shlex.split is not suitable for splitting command line on Window (https://bugs.python.org/issue1724822);
-    # shlex.quote is similarly problematic. Below are "proper" implementations of these functions according to
-    # https://docs.microsoft.com/en-us/cpp/c-language/parsing-c-command-line-arguments and
-    # https://blogs.msdn.microsoft.com/twistylittlepassagesallalike/2011/04/23/everyone-quotes-command-line-arguments-the-wrong-way/
-
-    _whitespace = ' \t\n\r'
-    _find_unsafe_char = re.compile(fr'{_whitespace}"').search
-
-    def quote_arg(arg: str) -> str:
-        if arg and not _find_unsafe_char(arg):
-            return arg
-
-        result = '"'
-        num_backslashes = 0
-        for c in arg:
-            if c == '\\':
-                num_backslashes += 1
-            else:
-                if c == '"':
-                    # Escape all backslashes and the following double quotation mark
-                    num_backslashes = num_backslashes * 2 + 1
-
-                result += num_backslashes * '\\' + c
-                num_backslashes = 0
-
-        # Escape all backslashes, but let the terminating double quotation
-        # mark we add below be interpreted as a metacharacter
-        result += (num_backslashes * 2) * '\\' + '"'
-        return result
-
-    def split_args(cmd: str) -> T.Liststr:
-        result = 
-        arg = ''
-        num_backslashes = 0
-        num_quotes = 0
-        in_quotes = False
-        for c in cmd:
-            if c == '\\':
-                num_backslashes += 1
-            else:
-                if c == '"' and not num_backslashes % 2:
-                    # unescaped quote, eat it
-                    arg += (num_backslashes // 2) * '\\'
-                    num_quotes += 1
-                    in_quotes = not in_quotes
-                elif c in _whitespace and not in_quotes:
-                    if arg or num_quotes:
-                        # reached the end of the argument
-                        result.append(arg)
-                        arg = ''
-                        num_quotes = 0
-                else:
-                    if c == '"':
-                        # escaped quote
-                        num_backslashes = (num_backslashes - 1) // 2
-
-                    arg += num_backslashes * '\\' + c
-
-                num_backslashes = 0
-
-        if arg or num_quotes:
-            result.append(arg)
-
-        return result
-else:
-    def quote_arg(arg: str) -> str:
-        return shlex.quote(arg)
-
-    def split_args(cmd: str) -> T.Liststr:
-        return shlex.split(cmd)
-
-
-def join_args(args: T.Iterablestr) -> str:
-    return ' '.join(quote_arg(x) for x in args)
-
-
-def do_replacement(regex: T.Patternstr, line: str,
-                   variable_format: Literal'meson', 'cmake', 'cmake@',
-                   confdata: T.UnionT.Dictstr, T.Tuplestr, T.Optionalstr, 'ConfigurationData') -> T.Tuplestr, T.Setstr:
-    missing_variables = set()  # type: T.Setstr
-    if variable_format == 'cmake':
-        start_tag = '${'
-        backslash_tag = '\\${'
-    else:
-        start_tag = '@'
-        backslash_tag = '\\@'
-
-    def variable_replace(match: T.Matchstr) -> str:
-        # Pairs of escape characters before '@' or '\@'
-        if match.group(0).endswith('\\'):
-            num_escapes = match.end(0) - match.start(0)
-            return '\\' * (num_escapes // 2)
-        # Single escape character and '@'
-        elif match.group(0) == backslash_tag:
-            return start_tag
-        # Template variable to be replaced
-        else:
-            varname = match.group(1)
-            var_str = ''
-            if varname in confdata:
-                var, _ = confdata.get(varname)
-                if isinstance(var, str):
-                    var_str = var
-                elif isinstance(var, int):
-                    var_str = str(var)
-                else:
-                    msg = f'Tried to replace variable {varname!r} value with ' \
-                          f'something other than a string or int: {var!r}'
-                    raise MesonException(msg)
-            else:
-                missing_variables.add(varname)
-            return var_str
-    return re.sub(regex, variable_replace, line), missing_variables
-
-def do_define(regex: T.Patternstr, line: str, confdata: 'ConfigurationData',
-              variable_format: Literal'meson', 'cmake', 'cmake@') -> str:
-    def get_cmake_define(line: str, confdata: 'ConfigurationData') -> str:
-        arr = line.split()
-        define_value = 
-        for token in arr2::
-            try:
-                (v, desc) = confdata.get(token)
-                define_value += str(v)
-            except KeyError:
-                define_value += token
-        return ' '.join(define_value)
-
-    arr = line.split()
-    if variable_format == 'meson' and len(arr) != 2:
-        raise MesonException('#mesondefine does not contain exactly two tokens: %s' % line.strip())
-
-    varname = arr1
-    try:
-        (v, desc) = confdata.get(varname)
-    except KeyError:
-        return '/* #undef %s */\n' % varname
-    if isinstance(v, bool):
-        if v:
-            return '#define %s\n' % varname
-        else:
-            return '#undef %s\n' % varname
-    elif isinstance(v, int):
-        return '#define %s %d\n' % (varname, v)
-    elif isinstance(v, str):
-        if variable_format == 'meson':
-            result = v
-        else:
-            result = get_cmake_define(line, confdata)
-        result = f'#define {varname} {result}\n'
-        (result, missing_variable) = do_replacement(regex, result, variable_format, confdata)
-        return result
-    else:
-        raise MesonException('#mesondefine argument "%s" is of unknown type.' % varname)
-
-def get_variable_regex(variable_format: Literal'meson', 'cmake', 'cmake@' = 'meson') -> T.Patternstr:
-    # Only allow (a-z, A-Z, 0-9, _, -) as valid characters for a define
-    # Also allow escaping '@' with '\@'
-    if variable_format in {'meson', 'cmake@'}:
-        regex = re.compile(r'(?:\\\\)+(?=\\?@)|\\@|@(-a-zA-Z0-9_+)@')
-    else:
-        regex = re.compile(r'(?:\\\\)+(?=\\?\$)|\\\${|\${(-a-zA-Z0-9_+)}')
-    return regex
-
-def do_conf_str(src: str, data: list, confdata: 'ConfigurationData',
-                variable_format: Literal'meson', 'cmake', 'cmake@',
-                encoding: str = 'utf-8') -> T.TupleT.Liststr, T.Setstr, bool:
-    def line_is_valid(line: str, variable_format: str) -> bool:
-        if variable_format == 'meson':
-            if '#cmakedefine' in line:
-                return False
-        else: # cmake format
-            if '#mesondefine' in line:
-                return False
-        return True
-
-    regex = get_variable_regex(variable_format)
-
-    search_token = '#mesondefine'
-    if variable_format != 'meson':
-        search_token = '#cmakedefine'
-
-    result = 
-    missing_variables = set()
-    # Detect when the configuration data is empty and no tokens were found
-    # during substitution so we can warn the user to use the `copy:` kwarg.
-    confdata_useless = not confdata.keys()
-    for line in data:
-        if line.startswith(search_token):
-            confdata_useless = False
-            line = do_define(regex, line, confdata, variable_format)
-        else:
-            if not line_is_valid(line, variable_format):
-                raise MesonException(f'Format error in {src}: saw "{line.strip()}" when format set to "{variable_format}"')
-            line, missing = do_replacement(regex, line, variable_format, confdata)
-            missing_variables.update(missing)
-            if missing:
-                confdata_useless = False
-        result.append(line)
-
-    return result, missing_variables, confdata_useless
-
-def do_conf_file(src: str, dst: str, confdata: 'ConfigurationData',
-                 variable_format: Literal'meson', 'cmake', 'cmake@',
-                 encoding: str = 'utf-8') -> T.TupleT.Setstr, bool:
-    try:
-        with open(src, encoding=encoding, newline='') as f:
-            data = f.readlines()
-    except Exception as e:
-        raise MesonException(f'Could not read input file {src}: {e!s}')
-
-    (result, missing_variables, confdata_useless) = do_conf_str(src, data, confdata, variable_format, encoding)
-    dst_tmp = dst + '~'
-    try:
-        with open(dst_tmp, 'w', encoding=encoding, newline='') as f:
-            f.writelines(result)
-    except Exception as e:
-        raise MesonException(f'Could not write output file {dst}: {e!s}')
-    shutil.copymode(src, dst_tmp)
-    replace_if_different(dst, dst_tmp)
-    return missing_variables, confdata_useless
-
-CONF_C_PRELUDE = '''/*
- * Autogenerated by the Meson build system.
- * Do not edit, your changes will be lost.
- */
-
-#pragma once
-
-'''
-
-CONF_NASM_PRELUDE = '''; Autogenerated by the Meson build system.
-; Do not edit, your changes will be lost.
-
-'''
-
-def dump_conf_header(ofilename: str, cdata: 'ConfigurationData', output_format: T.Literal'c', 'nasm') -> None:
-    if output_format == 'c':
-        prelude = CONF_C_PRELUDE
-        prefix = '#'
-    else:
-        prelude = CONF_NASM_PRELUDE
-        prefix = '%'
-
-    ofilename_tmp = ofilename + '~'
-    with open(ofilename_tmp, 'w', encoding='utf-8') as ofile:
-        ofile.write(prelude)
-        for k in sorted(cdata.keys()):
-            (v, desc) = cdata.get(k)
-            if desc:
-                if output_format == 'c':
-                    ofile.write('/* %s */\n' % desc)
-                elif output_format == 'nasm':
-                    for line in desc.split('\n'):
-                        ofile.write('; %s\n' % line)
-            if isinstance(v, bool):
-                if v:
-                    ofile.write(f'{prefix}define {k}\n\n')
-                else:
-                    ofile.write(f'{prefix}undef {k}\n\n')
-            elif isinstance(v, (int, str)):
-                ofile.write(f'{prefix}define {k} {v}\n\n')
-            else:
-                raise MesonException('Unknown data type in configuration file entry: ' + k)
-    replace_if_different(ofilename, ofilename_tmp)
-
-
-def replace_if_different(dst: str, dst_tmp: str) -> None:
-    # If contents are identical, don't touch the file to prevent
-    # unnecessary rebuilds.
-    different = True
-    try:
-        with open(dst, 'rb') as f1, open(dst_tmp, 'rb') as f2:
-            if f1.read() == f2.read():
-                different = False
-    except FileNotFoundError:
-        pass
-    if different:
-        os.replace(dst_tmp, dst)
-    else:
-        os.unlink(dst_tmp)
-
-
-def listify(item: T.Any, flatten: bool = True) -> T.ListT.Any:
-    '''
-    Returns a list with all args embedded in a list if they are not a list.
-    This function preserves order.
-    @flatten: Convert lists of lists to a flat list
-    '''
-    if not isinstance(item, list):
-        return item
-    result =   # type: T.ListT.Any
-    for i in item:
-        if flatten and isinstance(i, list):
-            result += listify(i, flatten=True)
-        else:
-            result.append(i)
-    return result
-
-
-def extract_as_list(dict_object: T.Dict_T, _U, key: _T, pop: bool = False) -> T.List_U:
-    '''
-    Extracts all values from given dict_object and listifies them.
-    '''
-    fetch: T.Callable_T, _U = dict_object.get
-    if pop:
-        fetch = dict_object.pop
-    # If there's only one key, we don't return a list with one element
-    return listify(fetch(key) or , flatten=True)
-
-
-def typeslistify(item: 'T.Union_T, T.Sequence_T',
-                 types: 'T.UnionT.Type_T, T.TupleT.Type_T') -> T.List_T:
-    '''
-    Ensure that type(@item) is one of @types or a
-    list of items all of which are of type @types
-    '''
-    if isinstance(item, types):
-        item = T.cast('T.List_T', item)
-    if not isinstance(item, list):
-        raise MesonException('Item must be a list or one of {!r}, not {!r}'.format(types, type(item)))
-    for i in item:
-        if i is not None and not isinstance(i, types):
-            raise MesonException('List item must be one of {!r}, not {!r}'.format(types, type(i)))
-    return item
-
-
-def stringlistify(item: T.UnionT.Any, T.SequenceT.Any) -> T.Liststr:
-    return typeslistify(item, str)
-
-
-def expand_arguments(args: T.Iterablestr) -> T.OptionalT.Liststr:
-    expended_args =   # type: T.Liststr
-    for arg in args:
-        if not arg.startswith('@'):
-            expended_args.append(arg)
-            continue
-
-        args_file = arg1:
-        try:
-            with open(args_file, encoding='utf-8') as f:
-                extended_args = f.read().split()
-            expended_args += extended_args
-        except Exception as e:
-            mlog.error('Expanding command line arguments:',  args_file, 'not found')
-            mlog.exception(e)
-            return None
-    return expended_args
-
-
-def partition(pred: T.Callable_T, object, iterable: T.Iterable_T) -> T.TupleT.Iterator_T, T.Iterator_T:
-    """Use a predicate to partition entries into false entries and true
-    entries.
-
-    >>> x, y = partition(is_odd, range(10))
-    >>> (list(x), list(y))
-    (0, 2, 4, 6, 8, 1, 3, 5, 7, 9)
-    """
-    t1, t2 = tee(iterable)
-    return filterfalse(pred, t1), filter(pred, t2)
-
-
-def Popen_safe(args: T.Liststr, write: T.Optionalstr = None,
-               stdin: T.UnionT.TextIO, T.BinaryIO, int = subprocess.DEVNULL,
-               stdout: T.UnionT.TextIO, T.BinaryIO, int = subprocess.PIPE,
-               stderr: T.UnionT.TextIO, T.BinaryIO, int = subprocess.PIPE,
-               **kwargs: T.Any) -> T.Tuple'subprocess.Popenstr', str, str:
-    import locale
-    encoding = locale.getpreferredencoding()
-    # Stdin defaults to DEVNULL otherwise the command run by us here might mess
-    # up the console and ANSI colors will stop working on Windows.
-    # If write is not None, set stdin to PIPE so data can be sent.
-    if write is not None:
-        stdin = subprocess.PIPE
-    if not sys.stdout.encoding or encoding.upper() != 'UTF-8':
-        p, o, e = Popen_safe_legacy(args, write=write, stdin=stdin, stdout=stdout, stderr=stderr, **kwargs)
-    else:
-        p = subprocess.Popen(args, universal_newlines=True, close_fds=False,
-                             stdin=stdin, stdout=stdout, stderr=stderr, **kwargs)
-        o, e = p.communicate(write)
-    # Sometimes the command that we run will call another command which will be
-    # without the above stdin workaround, so set the console mode again just in
-    # case.
-    mlog.setup_console()
-    return p, o, e
-
-
-def Popen_safe_legacy(args: T.Liststr, write: T.Optionalstr = None,
-                      stdin: T.UnionT.TextIO, T.BinaryIO, int = subprocess.DEVNULL,
-                      stdout: T.UnionT.TextIO, T.BinaryIO, int = subprocess.PIPE,
-                      stderr: T.UnionT.TextIO, T.BinaryIO, int = subprocess.PIPE,
-                      **kwargs: T.Any) -> T.Tuple'subprocess.Popenstr', str, str:
-    p = subprocess.Popen(args, universal_newlines=False, close_fds=False,
-                         stdin=stdin, stdout=stdout, stderr=stderr, **kwargs)
-    input_ = None  # type: T.Optionalbytes
-    if write is not None:
-        input_ = write.encode('utf-8')
-    o, e = p.communicate(input_)
-    if o is not None:
-        if sys.stdout.encoding:
-            o = o.decode(encoding=sys.stdout.encoding, errors='replace').replace('\r\n', '\n')
-        else:
-            o = o.decode(errors='replace').replace('\r\n', '\n')
-    if e is not None:
-        if sys.stderr is not None and sys.stderr.encoding:
-            e = e.decode(encoding=sys.stderr.encoding, errors='replace').replace('\r\n', '\n')
-        else:
-            e = e.decode(errors='replace').replace('\r\n', '\n')
-    return p, o, e
-
-
-def iter_regexin_iter(regexiter: T.Iterablestr, initer: T.Iterablestr) -> T.Optionalstr:
-    '''
-    Takes each regular expression in @regexiter and tries to search for it in
-    every item in @initer. If there is a match, returns that match.
-    Else returns False.
-    '''
-    for regex in regexiter:
-        for ii in initer:
-            if not isinstance(ii, str):
-                continue
-            match = re.search(regex, ii)
-            if match:
-                return match.group()
-    return None
-
-
-def _substitute_values_check_errors(command: T.Liststr, values: T.Dictstr, T.Unionstr, T.Liststr) -> None:
-    # Error checking
-    inregex = '@INPUT(0-9+)?@', '@PLAINNAME@', '@BASENAME@'  # type: T.Liststr
-    outregex = '@OUTPUT(0-9+)?@', '@OUTDIR@'                 # type: T.Liststr
-    if '@INPUT@' not in values:
-        # Error out if any input-derived templates are present in the command
-        match = iter_regexin_iter(inregex, command)
-        if match:
-            raise MesonException(f'Command cannot have {match!r}, since no input files were specified')
-    else:
-        if len(values'@INPUT@') > 1:
-            # Error out if @PLAINNAME@ or @BASENAME@ is present in the command
-            match = iter_regexin_iter(inregex1:, command)
-            if match:
-                raise MesonException(f'Command cannot have {match!r} when there is '
-                                     'more than one input file')
-        # Error out if an invalid @INPUTnn@ template was specified
-        for each in command:
-            if not isinstance(each, str):
-                continue
-            match2 = re.search(inregex0, each)
-            if match2 and match2.group() not in values:
-                m = 'Command cannot have {!r} since there are only {!r} inputs'
-                raise MesonException(m.format(match2.group(), len(values'@INPUT@')))
-    if '@OUTPUT@' not in values:
-        # Error out if any output-derived templates are present in the command
-        match = iter_regexin_iter(outregex, command)
-        if match:
-            raise MesonException(f'Command cannot have {match!r} since there are no outputs')
-    else:
-        # Error out if an invalid @OUTPUTnn@ template was specified
-        for each in command:
-            if not isinstance(each, str):
-                continue
-            match2 = re.search(outregex0, each)
-            if match2 and match2.group() not in values:
-                m = 'Command cannot have {!r} since there are only {!r} outputs'
-                raise MesonException(m.format(match2.group(), len(values'@OUTPUT@')))
-
-
-def substitute_values(command: T.Liststr, values: T.Dictstr, T.Unionstr, T.Liststr) -> T.Liststr:
-    '''
-    Substitute the template strings in the @values dict into the list of
-    strings @command and return a new list. For a full list of the templates,
-    see get_filenames_templates_dict()
-
-    If multiple inputs/outputs are given in the @values dictionary, we
-    substitute @INPUT@ and @OUTPUT@ only if they are the entire string, not
-    just a part of it, and in that case we substitute *all* of them.
-
-    The typing of this function is difficult, as only @OUTPUT@ and @INPUT@ can
-    be lists, everything else is a string. However, TypeDict cannot represent
-    this, as you can have optional keys, but not extra keys. We end up just
-    having to us asserts to convince type checkers that this is okay.
-
-    https://github.com/python/mypy/issues/4617
-    '''
-
-    def replace(m: T.Matchstr) -> str:
-        v = valuesm.group(0)
-        assert isinstance(v, str), 'for mypy'
-        return v
-
-    # Error checking
-    _substitute_values_check_errors(command, values)
-
-    # Substitution
-    outcmd =   # type: T.Liststr
-    rx_keys = re.escape(key) for key in values if key not in ('@INPUT@', '@OUTPUT@')
-    value_rx = re.compile('|'.join(rx_keys)) if rx_keys else None
-    for vv in command:
-        more: T.Optionalstr = None
-        if not isinstance(vv, str):
-            outcmd.append(vv)
-        elif '@INPUT@' in vv:
-            inputs = values'@INPUT@'
-            if vv == '@INPUT@':
-                outcmd += inputs
-            elif len(inputs) == 1:
-                outcmd.append(vv.replace('@INPUT@', inputs0))
-            else:
-                raise MesonException("Command has '@INPUT@' as part of a "
-                                     "string and more than one input file")
-        elif '@OUTPUT@' in vv:
-            outputs = values'@OUTPUT@'
-            if vv == '@OUTPUT@':
-                outcmd += outputs
-            elif len(outputs) == 1:
-                outcmd.append(vv.replace('@OUTPUT@', outputs0))
-            else:
-                raise MesonException("Command has '@OUTPUT@' as part of a "
-                                     "string and more than one output file")
-
-        # Append values that are exactly a template string.
-        # This is faster than a string replace.
-        elif vv in values:
-            o = valuesvv
-            assert isinstance(o, str), 'for mypy'
-            more = o
-        # Substitute everything else with replacement
-        elif value_rx:
-            more = value_rx.sub(replace, vv)
-        else:
-            more = vv
-
-        if more is not None:
-            outcmd.append(more)
-
-    return outcmd
-
-
-def get_filenames_templates_dict(inputs: T.Liststr, outputs: T.Liststr) -> T.Dictstr, T.Unionstr, T.Liststr:
-    '''
-    Create a dictionary with template strings as keys and values as values for
-    the following templates:
-
-    @INPUT@  - the full path to one or more input files, from @inputs
-    @OUTPUT@ - the full path to one or more output files, from @outputs
-    @OUTDIR@ - the full path to the directory containing the output files
-
-    If there is only one input file, the following keys are also created:
-
-    @PLAINNAME@ - the filename of the input file
-    @BASENAME@ - the filename of the input file with the extension removed
-
-    If there is more than one input file, the following keys are also created:
-
-    @INPUT0@, @INPUT1@, ... one for each input file
-
-    If there is more than one output file, the following keys are also created:
-
-    @OUTPUT0@, @OUTPUT1@, ... one for each output file
-    '''
-    values = {}  # type: T.Dictstr, T.Unionstr, T.Liststr
-    # Gather values derived from the input
-    if inputs:
-        # We want to substitute all the inputs.
-        values'@INPUT@' = inputs
-        for (ii, vv) in enumerate(inputs):
-            # Write out @INPUT0@, @INPUT1@, ...
-            valuesf'@INPUT{ii}@' = vv
-        if len(inputs) == 1:
-            # Just one value, substitute @PLAINNAME@ and @BASENAME@
-            values'@PLAINNAME@' = plain = os.path.basename(inputs0)
-            values'@BASENAME@' = os.path.splitext(plain)0
-    if outputs:
-        # Gather values derived from the outputs, similar to above.
-        values'@OUTPUT@' = outputs
-        for (ii, vv) in enumerate(outputs):
-            valuesf'@OUTPUT{ii}@' = vv
-        # Outdir should be the same for all outputs
-        values'@OUTDIR@' = os.path.dirname(outputs0)
-        # Many external programs fail on empty arguments.
-        if values'@OUTDIR@' == '':
-            values'@OUTDIR@' = '.'
-    return values
-
-
-def _make_tree_writable(topdir: str) -> None:
-    # Ensure all files and directories under topdir are writable
-    # (and readable) by owner.
-    for d, _, files in os.walk(topdir):
-        os.chmod(d, os.stat(d).st_mode | stat.S_IWRITE | stat.S_IREAD)
-        for fname in files:
-            fpath = os.path.join(d, fname)
-            if os.path.isfile(fpath):
-                os.chmod(fpath, os.stat(fpath).st_mode | stat.S_IWRITE | stat.S_IREAD)
-
-
-def windows_proof_rmtree(f: str) -> None:
-    # On Windows if anyone is holding a file open you can't
-    # delete it. As an example an anti virus scanner might
-    # be scanning files you are trying to delete. The only
-    # way to fix this is to try again and again.
-    delays = 0.1, 0.1, 0.2, 0.2, 0.2, 0.5, 0.5, 1, 1, 1, 1, 2
-    writable = False
-    for d in delays:
-        try:
-            # Start by making the tree writable.
-            if not writable:
-                _make_tree_writable(f)
-                writable = True
-        except PermissionError:
-            time.sleep(d)
-            continue
-        try:
-            shutil.rmtree(f)
-            return
-        except FileNotFoundError:
-            return
-        except OSError:
-            time.sleep(d)
-    # Try one last time and throw if it fails.
-    shutil.rmtree(f)
-
-
-def windows_proof_rm(fpath: str) -> None:
-    """Like windows_proof_rmtree, but for a single file."""
-    if os.path.isfile(fpath):
-        os.chmod(fpath, os.stat(fpath).st_mode | stat.S_IWRITE | stat.S_IREAD)
-    delays = 0.1, 0.1, 0.2, 0.2, 0.2, 0.5, 0.5, 1, 1, 1, 1, 2
-    for d in delays:
-        try:
-            os.unlink(fpath)
-            return
-        except FileNotFoundError:
-            return
-        except OSError:
-            time.sleep(d)
-    os.unlink(fpath)
-
-
-class TemporaryDirectoryWinProof(TemporaryDirectory):
-    """
-    Like TemporaryDirectory, but cleans things up using
-    windows_proof_rmtree()
-    """
-
-    def __exit__(self, exc: T.Any, value: T.Any, tb: T.Any) -> None:
-        try:
-            super().__exit__(exc, value, tb)
-        except OSError:
-            windows_proof_rmtree(self.name)
-
-    def cleanup(self) -> None:
-        try:
-            super().cleanup()
-        except OSError:
-            windows_proof_rmtree(self.name)
-
-
-def detect_subprojects(spdir_name: str, current_dir: str = '',
-                       result: T.OptionalT.Dictstr, T.Liststr = None) -> T.Dictstr, T.Liststr:
-    if result is None:
-        result = {}
-    spdir = os.path.join(current_dir, spdir_name)
-    if not os.path.exists(spdir):
-        return result
-    for trial in glob(os.path.join(spdir, '*')):
-        basename = os.path.basename(trial)
-        if trial == 'packagecache':
-            continue
-        append_this = True
-        if os.path.isdir(trial):
-            detect_subprojects(spdir_name, trial, result)
-        elif trial.endswith('.wrap') and os.path.isfile(trial):
-            basename = os.path.splitext(basename)0
-        else:
-            append_this = False
-        if append_this:
-            if basename in result:
-                resultbasename.append(trial)
-            else:
-                resultbasename = trial
-    return result
-
-
-def substring_is_in_list(substr: str, strlist: T.Liststr) -> bool:
-    for s in strlist:
-        if substr in s:
-            return True
-    return False
-
-
-class OrderedSet(T.MutableSet_T):
-    """A set that preserves the order in which items are added, by first
-    insertion.
-    """
-    def __init__(self, iterable: T.OptionalT.Iterable_T = None):
-        self.__container: T.OrderedDict_T, None = collections.OrderedDict()
-        if iterable:
-            self.update(iterable)
-
-    def __contains__(self, value: object) -> bool:
-        return value in self.__container
-
-    def __iter__(self) -> T.Iterator_T:
-        return iter(self.__container.keys())
-
-    def __len__(self) -> int:
-        return len(self.__container)
-
-    def __repr__(self) -> str:
-        # Don't print 'OrderedSet("")' for an empty set.
-        if self.__container:
-            return 'OrderedSet("{}")'.format(
-                '", "'.join(repr(e) for e in self.__container.keys()))
-        return 'OrderedSet()'
-
-    def __reversed__(self) -> T.Iterator_T:
-        return reversed(self.__container.keys())
-
-    def add(self, value: _T) -> None:
-        self.__containervalue = None
-
-    def discard(self, value: _T) -> None:
-        if value in self.__container:
-            del self.__containervalue
-
-    def move_to_end(self, value: _T, last: bool = True) -> None:
-        self.__container.move_to_end(value, last)
-
-    def pop(self, last: bool = True) -> _T:
-        item, _ = self.__container.popitem(last)
-        return item
-
-    def update(self, iterable: T.Iterable_T) -> None:
-        for item in iterable:
-            self.__containeritem = None
-
-    def difference(self, set_: T.Iterable_T) -> 'OrderedSet_T':
-        return type(self)(e for e in self if e not in set_)
-
-    def difference_update(self, iterable: T.Iterable_T) -> None:
-        for item in iterable:
-            self.discard(item)
-
-def relpath(path: str, start: str) -> str:
-    # On Windows a relative path can't be evaluated for paths on two different
-    # drives (i.e. c:\foo and f:\bar).  The only thing left to do is to use the
-    # original absolute path.
-    try:
-        return os.path.relpath(path, start)
-    except (TypeError, ValueError):
-        return path
-
-def path_is_in_root(path: Path, root: Path, resolve: bool = False) -> bool:
-    # Check whether a path is within the root directory root
-    try:
-        if resolve:
-            path.resolve().relative_to(root.resolve())
-        else:
-            path.relative_to(root)
-    except ValueError:
-        return False
-    return True
-
-def relative_to_if_possible(path: Path, root: Path, resolve: bool = False) -> Path:
-    try:
-        if resolve:
-            return path.resolve().relative_to(root.resolve())
-        else:
-            return path.relative_to(root)
-    except ValueError:
-        return path
-
-class LibType(enum.IntEnum):
-
-    """Enumeration for library types."""
-
-    SHARED = 0
-    STATIC = 1
-    PREFER_SHARED = 2
-    PREFER_STATIC = 3
-
-
-class ProgressBarFallback:  # lgtm py/iter-returns-non-self
-    '''
-    Fallback progress bar implementation when tqdm is not found
-
-    Since this class is not an actual iterator, but only provides a minimal
-    fallback, it is safe to ignore the 'Iterator does not return self from
-    __iter__ method' warning.
-    '''
-    def __init__(self, iterable: T.OptionalT.Iterablestr = None, total: T.Optionalint = None,
-                 bar_type: T.Optionalstr = None, desc: T.Optionalstr = None):
-        if iterable is not None:
-            self.iterable = iter(iterable)
-            return
-        self.total = total
-        self.done = 0
-        self.printed_dots = 0
-        if self.total and bar_type == 'download':
-            print('Download size:', self.total)
-        if desc:
-            print(f'{desc}: ', end='')
-
-    # Pretend to be an iterator when called as one and don't print any
-    # progress
-    def __iter__(self) -> T.Iteratorstr:
-        return self.iterable
-
-    def __next__(self) -> str:
-        return next(self.iterable)
-
-    def print_dot(self) -> None:
-        print('.', end='')
-        sys.stdout.flush()
-        self.printed_dots += 1
-
-    def update(self, progress: int) -> None:
-        self.done += progress
-        if not self.total:
-            # Just print one dot per call if we don't have a total length
-            self.print_dot()
-            return
-        ratio = int(self.done / self.total * 10)
-        while self.printed_dots < ratio:
-            self.print_dot()
-
-    def close(self) -> None:
-        print('')
-
-try:
-    from tqdm import tqdm
-except ImportError:
-    # ideally we would use a typing.Protocol here, but it's part of typing_extensions until 3.8
-    ProgressBar = ProgressBarFallback  # type: T.UnionT.TypeProgressBarFallback, T.TypeProgressBarTqdm
-else:
-    class ProgressBarTqdm(tqdm):
-        def __init__(self, *args: T.Any, bar_type: T.Optionalstr = None, **kwargs: T.Any) -> None:
-            if bar_type == 'download':
-                kwargs.update({'unit': 'bytes', 'leave': True})
-            else:
-                kwargs.update({'leave': False})
-            kwargs'ncols' = 100
-            super().__init__(*args, **kwargs)
-
-    ProgressBar = ProgressBarTqdm
-
-
-class RealPathAction(argparse.Action):
-    def __init__(self, option_strings: T.Liststr, dest: str, default: str = '.', **kwargs: T.Any):
-        default = os.path.abspath(os.path.realpath(default))
-        super().__init__(option_strings, dest, nargs=None, default=default, **kwargs)
-
-    def __call__(self, parser: argparse.ArgumentParser, namespace: argparse.Namespace,
-                 values: T.Unionstr, T.SequenceT.Any, None, option_string: str = None) -> None:
-        assert isinstance(values, str)
-        setattr(namespace, self.dest, os.path.abspath(os.path.realpath(values)))
-
-
-def get_wine_shortpath(winecmd: T.Liststr, wine_paths: T.Sequencestr,
-                       workdir: T.Optionalstr = None) -> str:
-    '''
-    WINEPATH size is limited to 1024 bytes which can easily be exceeded when
-    adding the path to every dll inside build directory. See
-    https://bugs.winehq.org/show_bug.cgi?id=45810.
-
-    To shorten it as much as possible we use path relative to `workdir`
-    where possible and convert absolute paths to Windows shortpath (e.g.
-    "/usr/x86_64-w64-mingw32/lib" to "Z:\\usr\\X86_~FWL\\lib").
-
-    This limitation reportedly has been fixed with wine >= 6.4
-    '''
-
-    # Remove duplicates
-    wine_paths = list(OrderedSet(wine_paths))
-
-    # Check if it's already short enough
-    wine_path = ';'.join(wine_paths)
-    if len(wine_path) <= 1024:
-        return wine_path
-
-    # Check if we have wine >= 6.4
-    from ..programs import ExternalProgram
-    wine = ExternalProgram('wine', winecmd, silent=True)
-    if version_compare(wine.get_version(), '>=6.4'):
-        return wine_path
-
-    # Check paths that can be reduced by making them relative to workdir.
-    rel_paths = 
-    if workdir:
-        abs_paths = 
-        for p in wine_paths:
-            try:
-                rel = Path(p).relative_to(workdir)
-                rel_paths.append(str(rel))
-            except ValueError:
-                abs_paths.append(p)
-        wine_paths = abs_paths
-
-    if wine_paths:
-        # BAT script that takes a list of paths in argv and prints semi-colon separated shortpaths
-        with NamedTemporaryFile('w', suffix='.bat', encoding='utf-8', delete=False) as bat_file:
-            bat_file.write('''
-            @ECHO OFF
-            for %%x in (%*) do (
-                echo|set /p=;%~sx
-            )
-            ''')
-        try:
-            stdout = subprocess.check_output(winecmd + 'cmd', '/C', bat_file.name + wine_paths,
-                                             encoding='utf-8', stderr=subprocess.DEVNULL)
-            stdout = stdout.strip(';')
-            if stdout:
-                wine_paths = stdout.split(';')
-            else:
-                mlog.warning('Could not shorten WINEPATH: empty stdout')
-        except subprocess.CalledProcessError as e:
-            mlog.warning(f'Could not shorten WINEPATH: {str(e)}')
-        finally:
-            os.unlink(bat_file.name)
-    wine_path = ';'.join(rel_paths + wine_paths)
-    if len(wine_path) > 1024:
-        mlog.warning('WINEPATH exceeds 1024 characters which could cause issues')
-    return wine_path
-
-
-def run_once(func: T.Callable..., _T) -> T.Callable..., _T:
-    ret =   # type: T.List_T
-
-    @wraps(func)
-    def wrapper(*args: T.Any, **kwargs: T.Any) -> _T:
-        if ret:
-            return ret0
-
-        val = func(*args, **kwargs)
-        ret.append(val)
-        return val
-
-    return wrapper
-
-
-def generate_list(func: T.Callable..., T.Generator_T, None, None) -> T.Callable..., T.List_T:
-    @wraps(func)
-    def wrapper(*args: T.Any, **kwargs: T.Any) -> T.List_T:
-        return list(func(*args, **kwargs))
-
-    return wrapper
-
-
-class OptionOverrideProxy(collections.abc.Mapping):
-    '''Mimic an option list but transparently override selected option
-    values.
-    '''
-
-    # TODO: the typing here could be made more explicit using a TypeDict from
-    # python 3.8 or typing_extensions
-
-    def __init__(self, overrides: T.Dict'OptionKey', T.Any, options: 'KeyedOptionDictType',
-                 subproject: T.Optionalstr = None):
-        self.overrides = overrides
-        self.options = options
-        self.subproject = subproject
-
-    def __getitem__(self, key: 'OptionKey') -> 'UserOption':
-        # FIXME: This is fundamentally the same algorithm than interpreter.get_option_internal().
-        # We should try to share the code somehow.
-        key = key.evolve(subproject=self.subproject)
-        if not key.is_project():
-            opt = self.options.get(key)
-            if opt is None or opt.yielding:
-                opt = self.optionskey.as_root()
-        else:
-            opt = self.optionskey
-            if opt.yielding:
-                opt = self.options.get(key.as_root(), opt)
-        override_value = self.overrides.get(key.as_root())
-        if override_value is not None:
-            opt = copy.copy(opt)
-            opt.set_value(override_value)
-        return opt
-
-    def __iter__(self) -> T.Iterator'OptionKey':
-        return iter(self.options)
-
-    def __len__(self) -> int:
-        return len(self.options)
-
-    def __eq__(self, other: object) -> bool:
-        if not isinstance(other, OptionOverrideProxy):
-            return NotImplemented
-        t1 = (self.overrides, self.subproject, self.options)
-        t2 = (other.overrides, other.subproject, other.options)
-        return t1 == t2
-
-
-class OptionType(enum.IntEnum):
-
-    """Enum used to specify what kind of argument a thing is."""
-
-    BUILTIN = 0
-    BACKEND = 1
-    BASE = 2
-    COMPILER = 3
-    PROJECT = 4
-
-# This is copied from coredata. There is no way to share this, because this
-# is used in the OptionKey constructor, and the coredata lists are
-# OptionKeys...
-_BUILTIN_NAMES = {
-    'prefix',
-    'bindir',
-    'datadir',
-    'includedir',
-    'infodir',
-    'libdir',
-    'libexecdir',
-    'localedir',
-    'localstatedir',
-    'mandir',
-    'sbindir',
-    'sharedstatedir',
-    'sysconfdir',
-    'auto_features',
-    'backend',
-    'buildtype',
-    'debug',
-    'default_library',
-    'errorlogs',
-    'install_umask',
-    'layout',
-    'optimization',
-    'prefer_static',
-    'stdsplit',
-    'strip',
-    'unity',
-    'unity_size',
-    'warning_level',
-    'werror',
-    'wrap_mode',
-    'force_fallback_for',
-    'pkg_config_path',
-    'cmake_prefix_path',
-}
-
-
-def _classify_argument(key: 'OptionKey') -> OptionType:
-    """Classify arguments into groups so we know which dict to assign them to."""
-
-    if key.name.startswith('b_'):
-        return OptionType.BASE
-    elif key.lang is not None:
-        return OptionType.COMPILER
-    elif key.name in _BUILTIN_NAMES or key.module:
-        return OptionType.BUILTIN
-    elif key.name.startswith('backend_'):
-        assert key.machine is MachineChoice.HOST, str(key)
-        return OptionType.BACKEND
-    else:
-        assert key.machine is MachineChoice.HOST, str(key)
-        return OptionType.PROJECT
-
-
-@total_ordering
-class OptionKey:
-
-    """Represents an option key in the various option dictionaries.
-
-    This provides a flexible, powerful way to map option names from their
-    external form (things like subproject:build.option) to something that
-    internally easier to reason about and produce.
-    """
-
-    __slots__ = 'name', 'subproject', 'machine', 'lang', '_hash', 'type', 'module'
-
-    name: str
-    subproject: str
-    machine: MachineChoice
-    lang: T.Optionalstr
-    _hash: int
-    type: OptionType
-    module: T.Optionalstr
-
-    def __init__(self, name: str, subproject: str = '',
-                 machine: MachineChoice = MachineChoice.HOST,
-                 lang: T.Optionalstr = None,
-                 module: T.Optionalstr = None,
-                 _type: T.OptionalOptionType = None):
-        # the _type option to the constructor is kinda private. We want to be
-        # able tos ave the state and avoid the lookup function when
-        # pickling/unpickling, but we need to be able to calculate it when
-        # constructing a new OptionKey
-        object.__setattr__(self, 'name', name)
-        object.__setattr__(self, 'subproject', subproject)
-        object.__setattr__(self, 'machine', machine)
-        object.__setattr__(self, 'lang', lang)
-        object.__setattr__(self, 'module', module)
-        object.__setattr__(self, '_hash', hash((name, subproject, machine, lang, module)))
-        if _type is None:
-            _type = _classify_argument(self)
-        object.__setattr__(self, 'type', _type)
-
-    def __setattr__(self, key: str, value: T.Any) -> None:
-        raise AttributeError('OptionKey instances do not support mutation.')
-
-    def __getstate__(self) -> T.Dictstr, T.Any:
-        return {
-            'name': self.name,
-            'subproject': self.subproject,
-            'machine': self.machine,
-            'lang': self.lang,
-            '_type': self.type,
-            'module': self.module,
-        }
-
-    def __setstate__(self, state: T.Dictstr, T.Any) -> None:
-        """De-serialize the state of a pickle.
-
-        This is very clever. __init__ is not a constructor, it's an
-        initializer, therefore it's safe to call more than once. We create a
-        state in the custom __getstate__ method, which is valid to pass
-        splatted to the initializer.
-        """
-        # Mypy doesn't like this, because it's so clever.
-        self.__init__(**state)  # type: ignore
-
-    def __hash__(self) -> int:
-        return self._hash
-
-    def _to_tuple(self) -> T.Tuplestr, OptionType, str, str, MachineChoice, str:
-        return (self.subproject, self.type, self.lang or '', self.module or '', self.machine, self.name)
-
-    def __eq__(self, other: object) -> bool:
-        if isinstance(other, OptionKey):
-            return self._to_tuple() == other._to_tuple()
-        return NotImplemented
-
-    def __lt__(self, other: object) -> bool:
-        if isinstance(other, OptionKey):
-            return self._to_tuple() < other._to_tuple()
-        return NotImplemented
-
-    def __str__(self) -> str:
-        out = self.name
-        if self.lang:
-            out = f'{self.lang}_{out}'
-        if self.machine is MachineChoice.BUILD:
-            out = f'build.{out}'
-        if self.module:
-            out = f'{self.module}.{out}'
-        if self.subproject:
-            out = f'{self.subproject}:{out}'
-        return out
-
-    def __repr__(self) -> str:
-        return f'OptionKey({self.name!r}, {self.subproject!r}, {self.machine!r}, {self.lang!r}, {self.module!r}, {self.type!r})'
-
-    @classmethod
-    def from_string(cls, raw: str) -> 'OptionKey':
-        """Parse the raw command line format into a three part tuple.
-
-        This takes strings like `mysubproject:build.myoption` and Creates an
-        OptionKey out of them.
-        """
-        try:
-            subproject, raw2 = raw.split(':')
-        except ValueError:
-            subproject, raw2 = '', raw
-
-        module = None
-        for_machine = MachineChoice.HOST
-        try:
-            prefix, raw3 = raw2.split('.')
-            if prefix == 'build':
-                for_machine = MachineChoice.BUILD
-            else:
-                module = prefix
-        except ValueError:
-            raw3 = raw2
-
-        from ..compilers import all_languages
-        if any(raw3.startswith(f'{l}_') for l in all_languages):
-            lang, opt = raw3.split('_', 1)
-        else:
-            lang, opt = None, raw3
-        assert ':' not in opt
-        assert '.' not in opt
-
-        return cls(opt, subproject, for_machine, lang, module)
-
-    def evolve(self, name: T.Optionalstr = None, subproject: T.Optionalstr = None,
-               machine: T.OptionalMachineChoice = None, lang: T.Optionalstr = '',
-               module: T.Optionalstr = '') -> 'OptionKey':
-        """Create a new copy of this key, but with alterted members.
-
-        For example:
-        >>> a = OptionKey('foo', '', MachineChoice.Host)
-        >>> b = OptionKey('foo', 'bar', MachineChoice.Host)
-        >>> b == a.evolve(subproject='bar')
-        True
-        """
-        # We have to be a little clever with lang here, because lang is valid
-        # as None, for non-compiler options
-        return OptionKey(
-            name if name is not None else self.name,
-            subproject if subproject is not None else self.subproject,
-            machine if machine is not None else self.machine,
-            lang if lang != '' else self.lang,
-            module if module != '' else self.module
-        )
-
-    def as_root(self) -> 'OptionKey':
-        """Convenience method for key.evolve(subproject='')."""
-        return self.evolve(subproject='')
-
-    def as_build(self) -> 'OptionKey':
-        """Convenience method for key.evolve(machine=MachinceChoice.BUILD)."""
-        return self.evolve(machine=MachineChoice.BUILD)
-
-    def as_host(self) -> 'OptionKey':
-        """Convenience method for key.evolve(machine=MachinceChoice.HOST)."""
-        return self.evolve(machine=MachineChoice.HOST)
-
-    def is_backend(self) -> bool:
-        """Convenience method to check if this is a backend option."""
-        return self.type is OptionType.BACKEND
-
-    def is_builtin(self) -> bool:
-        """Convenience method to check if this is a builtin option."""
-        return self.type is OptionType.BUILTIN
-
-    def is_compiler(self) -> bool:
-        """Convenience method to check if this is a builtin option."""
-        return self.type is OptionType.COMPILER
-
-    def is_project(self) -> bool:
-        """Convenience method to check if this is a project option."""
-        return self.type is OptionType.PROJECT
-
-    def is_base(self) -> bool:
-        """Convenience method to check if this is a base option."""
-        return self.type is OptionType.BASE
-
-def pickle_load(filename: str, object_name: str, object_type: T.Type) -> T.Any:
-    load_fail_msg = f'{object_name} file {filename!r} is corrupted. Try with a fresh build tree.'
-    try:
-        with open(filename, 'rb') as f:
-            obj = pickle.load(f)
-    except (pickle.UnpicklingError, EOFError):
-        raise MesonException(load_fail_msg)
-    except (TypeError, ModuleNotFoundError, AttributeError):
-        raise MesonException(
-            f"{object_name} file {filename!r} references functions or classes that don't "
-            "exist. This probably means that it was generated with an old "
-            "version of meson.")
-    if not isinstance(obj, object_type):
-        raise MesonException(load_fail_msg)
-    from ..coredata import version as coredata_version
-    from ..coredata import major_versions_differ, MesonVersionMismatchException
-    if major_versions_differ(obj.version, coredata_version):
-        raise MesonVersionMismatchException(obj.version, coredata_version)
-    return obj

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/mesonlib/vsenv.py Deleted

@@ -1,115 +0,0 @@
-import os
-import subprocess
-import json
-import pathlib
-import platform
-import shutil
-import tempfile
-
-from .. import mlog
-from .universal import MesonException, is_windows
-
-
-bat_template = '''@ECHO OFF
-
-call "{}"
-
-ECHO {}
-SET
-'''
-
-# If on Windows and VS is installed but not set up in the environment,
-# set it to be runnable. In this way Meson can be directly invoked
-# from any shell, VS Code etc.
-def _setup_vsenv(force: bool) -> bool:
-    if not is_windows():
-        return False
-    if os.environ.get('OSTYPE') == 'cygwin':
-        return False
-    if 'MESON_FORCE_VSENV_FOR_UNITTEST' not in os.environ:
-        # VSINSTALL is set when running setvars from a Visual Studio installation
-        # Tested with Visual Studio 2012 and 2017
-        if 'VSINSTALLDIR' in os.environ:
-            return False
-        # Check explicitly for cl when on Windows
-        if shutil.which('cl.exe'):
-            return False
-    if not force:
-        if shutil.which('cc'):
-            return False
-        if shutil.which('gcc'):
-            return False
-        if shutil.which('clang'):
-            return False
-        if shutil.which('clang-cl'):
-            return False
-
-    root = os.environ.get("ProgramFiles(x86)") or os.environ.get("ProgramFiles")
-    bat_locator_bin = pathlib.Path(root, 'Microsoft Visual Studio/Installer/vswhere.exe')
-    if not bat_locator_bin.exists():
-        raise MesonException(f'Could not find {bat_locator_bin}')
-    bat_json = subprocess.check_output(
-        
-            str(bat_locator_bin),
-            '-latest',
-            '-prerelease',
-            '-requiresAny',
-            '-requires', 'Microsoft.VisualStudio.Component.VC.Tools.x86.x64',
-            '-requires', 'Microsoft.VisualStudio.Workload.WDExpress',
-            '-products', '*',
-            '-utf8',
-            '-format',
-            'json'
-        
-    )
-    bat_info = json.loads(bat_json)
-    if not bat_info:
-        # VS installer instelled but not VS itself maybe?
-        raise MesonException('Could not parse vswhere.exe output')
-    bat_root = pathlib.Path(bat_info0'installationPath')
-    if platform.machine() == 'ARM64':
-        bat_path = bat_root / 'VC/Auxiliary/Build/vcvarsx86_arm64.bat'
-    else:
-        bat_path = bat_root / 'VC/Auxiliary/Build/vcvars64.bat'
-        # if VS is not found try VS Express
-        if not bat_path.exists():
-            bat_path = bat_root / 'VC/Auxiliary/Build/vcvarsx86_amd64.bat'
-    if not bat_path.exists():
-        raise MesonException(f'Could not find {bat_path}')
-
-    mlog.log('Activating VS', bat_info0'catalog''productDisplayVersion')
-    bat_separator = '---SPLIT---'
-    bat_contents = bat_template.format(bat_path, bat_separator)
-    bat_file = tempfile.NamedTemporaryFile('w', suffix='.bat', encoding='utf-8', delete=False)
-    bat_file.write(bat_contents)
-    bat_file.flush()
-    bat_file.close()
-    bat_output = subprocess.check_output(bat_file.name, universal_newlines=True)
-    os.unlink(bat_file.name)
-    bat_lines = bat_output.split('\n')
-    bat_separator_seen = False
-    for bat_line in bat_lines:
-        if bat_line == bat_separator:
-            bat_separator_seen = True
-            continue
-        if not bat_separator_seen:
-            continue
-        if not bat_line:
-            continue
-        try:
-            k, v = bat_line.split('=', 1)
-        except ValueError:
-            # there is no "=", ignore junk data
-            pass
-        else:
-            os.environk = v
-    return True
-
-def setup_vsenv(force: bool = False) -> bool:
-    try:
-        return _setup_vsenv(force)
-    except MesonException as e:
-        if force:
-            raise
-        mlog.warning('Failed to activate VS environment:', str(e))
-        return False

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/mesonlib/win32.py Deleted

@@ -1,39 +0,0 @@
-# SPDX-license-identifier: Apache-2.0
-# Copyright 2012-2021 The Meson development team
-# Copyright © 2021 Intel Corporation
-
-# 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.
-
-"""Windows specific implementations of mesonlib functionality."""
-
-import msvcrt
-import typing as T
-
-from .universal import MesonException
-from .platform import BuildDirLock as BuildDirLockBase
-
-__all__ = 'BuildDirLock'
-
-class BuildDirLock(BuildDirLockBase):
-
-    def __enter__(self) -> None:
-        self.lockfile = open(self.lockfilename, 'w', encoding='utf-8')
-        try:
-            msvcrt.locking(self.lockfile.fileno(), msvcrt.LK_NBLCK, 1)
-        except (BlockingIOError, PermissionError):
-            self.lockfile.close()
-            raise MesonException('Some other Meson process is already using this build directory. Exiting.')
-
-    def __exit__(self, *args: T.Any) -> None:
-        msvcrt.locking(self.lockfile.fileno(), msvcrt.LK_UNLCK, 1)
-        self.lockfile.close()

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/modules/unstable_cuda.py Deleted

@@ -1,359 +0,0 @@
-# Copyright 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.
-from __future__ import annotations
-
-import typing as T
-import re
-
-from ..mesonlib import version_compare
-from ..compilers import CudaCompiler
-
-from . import NewExtensionModule
-
-from ..interpreterbase import (
-    flatten, permittedKwargs, noKwargs,
-    InvalidArguments, FeatureNew
-)
-
-if T.TYPE_CHECKING:
-    from . import ModuleState
-    from ..compilers import Compiler
-
-class CudaModule(NewExtensionModule):
-
-    @FeatureNew('CUDA module', '0.50.0')
-    def __init__(self, *args, **kwargs):
-        super().__init__()
-        self.methods.update({
-            "min_driver_version": self.min_driver_version,
-            "nvcc_arch_flags":    self.nvcc_arch_flags,
-            "nvcc_arch_readable": self.nvcc_arch_readable,
-        })
-
-    @noKwargs
-    def min_driver_version(self, state: 'ModuleState',
-                                 args: T.Tuplestr,
-                                 kwargs: T.Dictstr, T.Any) -> str:
-        argerror = InvalidArguments('min_driver_version must have exactly one positional argument: ' +
-                                    'a CUDA Toolkit version string. Beware that, since CUDA 11.0, ' +
-                                    'the CUDA Toolkit\'s components (including NVCC) are versioned ' +
-                                    'independently from each other (and the CUDA Toolkit as a whole).')
-
-        if len(args) != 1 or not isinstance(args0, str):
-            raise argerror
-
-        cuda_version = args0
-        driver_version_table = 
-            {'cuda_version': '>=11.7.0',   'windows': '516.01', 'linux': '515.43.04'},
-            {'cuda_version': '>=11.6.1',   'windows': '511.65', 'linux': '510.47.03'},
-            {'cuda_version': '>=11.6.0',   'windows': '511.23', 'linux': '510.39.01'},
-            {'cuda_version': '>=11.5.1',   'windows': '496.13', 'linux': '495.29.05'},
-            {'cuda_version': '>=11.5.0',   'windows': '496.04', 'linux': '495.29.05'},
-            {'cuda_version': '>=11.4.3',   'windows': '472.50', 'linux': '470.82.01'},
-            {'cuda_version': '>=11.4.1',   'windows': '471.41', 'linux': '470.57.02'},
-            {'cuda_version': '>=11.4.0',   'windows': '471.11', 'linux': '470.42.01'},
-            {'cuda_version': '>=11.3.0',   'windows': '465.89', 'linux': '465.19.01'},
-            {'cuda_version': '>=11.2.2',   'windows': '461.33', 'linux': '460.32.03'},
-            {'cuda_version': '>=11.2.1',   'windows': '461.09', 'linux': '460.32.03'},
-            {'cuda_version': '>=11.2.0',   'windows': '460.82', 'linux': '460.27.03'},
-            {'cuda_version': '>=11.1.1',   'windows': '456.81', 'linux': '455.32'},
-            {'cuda_version': '>=11.1.0',   'windows': '456.38', 'linux': '455.23'},
-            {'cuda_version': '>=11.0.3',   'windows': '451.82', 'linux': '450.51.06'},
-            {'cuda_version': '>=11.0.2',   'windows': '451.48', 'linux': '450.51.05'},
-            {'cuda_version': '>=11.0.1',   'windows': '451.22', 'linux': '450.36.06'},
-            {'cuda_version': '>=10.2.89',  'windows': '441.22', 'linux': '440.33'},
-            {'cuda_version': '>=10.1.105', 'windows': '418.96', 'linux': '418.39'},
-            {'cuda_version': '>=10.0.130', 'windows': '411.31', 'linux': '410.48'},
-            {'cuda_version': '>=9.2.148',  'windows': '398.26', 'linux': '396.37'},
-            {'cuda_version': '>=9.2.88',   'windows': '397.44', 'linux': '396.26'},
-            {'cuda_version': '>=9.1.85',   'windows': '391.29', 'linux': '390.46'},
-            {'cuda_version': '>=9.0.76',   'windows': '385.54', 'linux': '384.81'},
-            {'cuda_version': '>=8.0.61',   'windows': '376.51', 'linux': '375.26'},
-            {'cuda_version': '>=8.0.44',   'windows': '369.30', 'linux': '367.48'},
-            {'cuda_version': '>=7.5.16',   'windows': '353.66', 'linux': '352.31'},
-            {'cuda_version': '>=7.0.28',   'windows': '347.62', 'linux': '346.46'},
-        
-
-        driver_version = 'unknown'
-        for d in driver_version_table:
-            if version_compare(cuda_version, d'cuda_version'):
-                driver_version = d.get(state.host_machine.system, d'linux')
-                break
-
-        return driver_version
-
-    @permittedKwargs('detected')
-    def nvcc_arch_flags(self, state: 'ModuleState',
-                              args: T.TupleT.UnionCompiler, CudaCompiler, str,
-                              kwargs: T.Dictstr, T.Any) -> T.Liststr:
-        nvcc_arch_args = self._validate_nvcc_arch_args(args, kwargs)
-        ret = self._nvcc_arch_flags(*nvcc_arch_args)0
-        return ret
-
-    @permittedKwargs('detected')
-    def nvcc_arch_readable(self, state: 'ModuleState',
-                                 args: T.TupleT.UnionCompiler, CudaCompiler, str,
-                                 kwargs: T.Dictstr, T.Any) -> T.Liststr:
-        nvcc_arch_args = self._validate_nvcc_arch_args(args, kwargs)
-        ret = self._nvcc_arch_flags(*nvcc_arch_args)1
-        return ret
-
-    @staticmethod
-    def _break_arch_string(s):
-        s = re.sub(' \t\r\n,;+', ';', s)
-        s = s.strip(';').split(';')
-        return s
-
-    @staticmethod
-    def _detected_cc_from_compiler(c):
-        if isinstance(c, CudaCompiler):
-            return c.detected_cc
-        return ''
-
-    @staticmethod
-    def _version_from_compiler(c):
-        if isinstance(c, CudaCompiler):
-            return c.version
-        if isinstance(c, str):
-            return c
-        return 'unknown'
-
-    def _validate_nvcc_arch_args(self, args, kwargs):
-        argerror = InvalidArguments('The first argument must be an NVCC compiler object, or its version string!')
-
-        if len(args) < 1:
-            raise argerror
-        else:
-            compiler = args0
-            cuda_version = self._version_from_compiler(compiler)
-            if cuda_version == 'unknown':
-                raise argerror
-
-        arch_list =  if len(args) <= 1 else flatten(args1:)
-        arch_list = self._break_arch_string(a) for a in arch_list
-        arch_list = flatten(arch_list)
-        if len(arch_list) > 1 and not set(arch_list).isdisjoint({'All', 'Common', 'Auto'}):
-            raise InvalidArguments('''The special architectures 'All', 'Common' and 'Auto' must appear alone, as a positional argument!''')
-        arch_list = arch_list0 if len(arch_list) == 1 else arch_list
-
-        detected = kwargs.get('detected', self._detected_cc_from_compiler(compiler))
-        detected = flatten(detected)
-        detected = self._break_arch_string(a) for a in detected
-        detected = flatten(detected)
-        if not set(detected).isdisjoint({'All', 'Common', 'Auto'}):
-            raise InvalidArguments('''The special architectures 'All', 'Common' and 'Auto' must appear alone, as a positional argument!''')
-
-        return cuda_version, arch_list, detected
-
-    def _filter_cuda_arch_list(self, cuda_arch_list, lo=None, hi=None, saturate=None):
-        """
-        Filter CUDA arch list (no codenames) for >= low and < hi architecture
-        bounds, and deduplicate.
-        If saturate is provided, architectures >= hi are replaced with saturate.
-        """
-
-        filtered_cuda_arch_list = 
-        for arch in cuda_arch_list:
-            if arch:
-                if lo and version_compare(arch, '<' + lo):
-                    continue
-                if hi and version_compare(arch, '>=' + hi):
-                    if not saturate:
-                        continue
-                    arch = saturate
-                if arch not in filtered_cuda_arch_list:
-                    filtered_cuda_arch_list.append(arch)
-        return filtered_cuda_arch_list
-
-    def _nvcc_arch_flags(self, cuda_version, cuda_arch_list='Auto', detected=''):
-        """
-        Using the CUDA Toolkit version and the target architectures, compute
-        the NVCC architecture flags.
-        """
-
-        # Replicates much of the logic of
-        #     https://github.com/Kitware/CMake/blob/master/Modules/FindCUDA/select_compute_arch.cmake
-        # except that a bug with cuda_arch_list="All" is worked around by
-        # tracking both lower and upper limits on GPU architectures.
-
-        cuda_known_gpu_architectures   = 'Fermi', 'Kepler', 'Maxwell'  # noqa: E221
-        cuda_common_gpu_architectures  = '3.0', '3.5', '5.0'           # noqa: E221
-        cuda_hi_limit_gpu_architecture = None                            # noqa: E221
-        cuda_lo_limit_gpu_architecture = '2.0'                           # noqa: E221
-        cuda_all_gpu_architectures     = '3.0', '3.2', '3.5', '5.0'    # noqa: E221
-
-        if version_compare(cuda_version, '<7.0'):
-            cuda_hi_limit_gpu_architecture = '5.2'
-
-        if version_compare(cuda_version, '>=7.0'):
-            cuda_known_gpu_architectures  += 'Kepler+Tegra', 'Kepler+Tesla', 'Maxwell+Tegra'  # noqa: E221
-            cuda_common_gpu_architectures += '5.2'                                            # noqa: E221
-
-            if version_compare(cuda_version, '<8.0'):
-                cuda_common_gpu_architectures += '5.2+PTX'  # noqa: E221
-                cuda_hi_limit_gpu_architecture = '6.0'        # noqa: E221
-
-        if version_compare(cuda_version, '>=8.0'):
-            cuda_known_gpu_architectures  += 'Pascal', 'Pascal+Tegra'  # noqa: E221
-            cuda_common_gpu_architectures += '6.0', '6.1'              # noqa: E221
-            cuda_all_gpu_architectures    += '6.0', '6.1', '6.2'       # noqa: E221
-
-            if version_compare(cuda_version, '<9.0'):
-                cuda_common_gpu_architectures += '6.1+PTX'  # noqa: E221
-                cuda_hi_limit_gpu_architecture = '7.0'        # noqa: E221
-
-        if version_compare(cuda_version, '>=9.0'):
-            cuda_known_gpu_architectures  += 'Volta', 'Xavier' # noqa: E221
-            cuda_common_gpu_architectures += '7.0'             # noqa: E221
-            cuda_all_gpu_architectures    += '7.0', '7.2'      # noqa: E221
-            # https://docs.nvidia.com/cuda/archive/9.0/cuda-toolkit-release-notes/index.html#unsupported-features
-            cuda_lo_limit_gpu_architecture = '3.0'               # noqa: E221
-
-            if version_compare(cuda_version, '<10.0'):
-                cuda_common_gpu_architectures += '7.2+PTX'  # noqa: E221
-                cuda_hi_limit_gpu_architecture = '8.0'        # noqa: E221
-
-        if version_compare(cuda_version, '>=10.0'):
-            cuda_known_gpu_architectures  += 'Turing' # noqa: E221
-            cuda_common_gpu_architectures += '7.5'    # noqa: E221
-            cuda_all_gpu_architectures    += '7.5'    # noqa: E221
-
-            if version_compare(cuda_version, '<11.0'):
-                cuda_common_gpu_architectures += '7.5+PTX'  # noqa: E221
-                cuda_hi_limit_gpu_architecture = '8.0'        # noqa: E221
-
-        if version_compare(cuda_version, '>=11.0'):
-            cuda_known_gpu_architectures  += 'Ampere' # noqa: E221
-            cuda_common_gpu_architectures += '8.0'    # noqa: E221
-            cuda_all_gpu_architectures    += '8.0'    # noqa: E221
-            # https://docs.nvidia.com/cuda/archive/11.0/cuda-toolkit-release-notes/index.html#deprecated-features
-            cuda_lo_limit_gpu_architecture = '3.5'      # noqa: E221
-
-            if version_compare(cuda_version, '<11.1'):
-                cuda_common_gpu_architectures += '8.0+PTX'  # noqa: E221
-                cuda_hi_limit_gpu_architecture = '8.6'        # noqa: E221
-
-        if version_compare(cuda_version, '>=11.1'):
-            cuda_common_gpu_architectures += '8.6', '8.6+PTX'  # noqa: E221
-            cuda_all_gpu_architectures    += '8.6'             # noqa: E221
-
-            if version_compare(cuda_version, '<12.0'):
-                cuda_hi_limit_gpu_architecture = '9.0'        # noqa: E221
-
-        if not cuda_arch_list:
-            cuda_arch_list = 'Auto'
-
-        if   cuda_arch_list == 'All':     # noqa: E271
-            cuda_arch_list = cuda_known_gpu_architectures
-        elif cuda_arch_list == 'Common':  # noqa: E271
-            cuda_arch_list = cuda_common_gpu_architectures
-        elif cuda_arch_list == 'Auto':    # noqa: E271
-            if detected:
-                if isinstance(detected, list):
-                    cuda_arch_list = detected
-                else:
-                    cuda_arch_list = self._break_arch_string(detected)
-                cuda_arch_list = self._filter_cuda_arch_list(cuda_arch_list,
-                                                             cuda_lo_limit_gpu_architecture,
-                                                             cuda_hi_limit_gpu_architecture,
-                                                             cuda_common_gpu_architectures-1)
-            else:
-                cuda_arch_list = cuda_common_gpu_architectures
-        elif isinstance(cuda_arch_list, str):
-            cuda_arch_list = self._break_arch_string(cuda_arch_list)
-
-        cuda_arch_list = sorted(x for x in set(cuda_arch_list) if x)
-
-        cuda_arch_bin = 
-        cuda_arch_ptx = 
-        for arch_name in cuda_arch_list:
-            arch_bin = 
-            arch_ptx = 
-            add_ptx = arch_name.endswith('+PTX')
-            if add_ptx:
-                arch_name = arch_name:-len('+PTX')
-
-            if re.fullmatch('0-9+\\.0-9(\$0-9+\\.0-9\$)?', arch_name):
-                arch_bin, arch_ptx = arch_name, arch_name
-            else:
-                arch_bin, arch_ptx = {
-                    'Fermi':         ('2.0', '2.1(2.0)', ),
-                    'Kepler+Tegra':  ('3.2',             ),
-                    'Kepler+Tesla':  ('3.7',             ),
-                    'Kepler':        ('3.0', '3.5',      '3.5'),
-                    'Maxwell+Tegra': ('5.3',             ),
-                    'Maxwell':       ('5.0', '5.2',      '5.2'),
-                    'Pascal':        ('6.0', '6.1',      '6.1'),
-                    'Pascal+Tegra':  ('6.2',             ),
-                    'Volta':         ('7.0',             '7.0'),
-                    'Xavier':        ('7.2',             ),
-                    'Turing':        ('7.5',             '7.5'),
-                    'Ampere':        ('8.0',             '8.0'),
-                }.get(arch_name, (None, None))
-
-            if arch_bin is None:
-                raise InvalidArguments(f'Unknown CUDA Architecture Name {arch_name}!')
-
-            cuda_arch_bin += arch_bin
-
-            if add_ptx:
-                if not arch_ptx:
-                    arch_ptx = arch_bin
-                cuda_arch_ptx += arch_ptx
-
-        cuda_arch_bin = sorted(list(set(cuda_arch_bin)))
-        cuda_arch_ptx = sorted(list(set(cuda_arch_ptx)))
-
-        nvcc_flags = 
-        nvcc_archs_readable = 
-
-        for arch in cuda_arch_bin:
-            arch, codev = re.fullmatch(
-                '(0-9+\\.0-9)(?:\$(0-9+\\.0-9)\$)?', arch).groups()
-
-            if version_compare(arch, '<' + cuda_lo_limit_gpu_architecture):
-                continue
-            if version_compare(arch, '>=' + cuda_hi_limit_gpu_architecture):
-                continue
-
-            if codev:
-                arch = arch.replace('.', '')
-                codev = codev.replace('.', '')
-                nvcc_flags += '-gencode', 'arch=compute_' + codev + ',code=sm_' + arch
-                nvcc_archs_readable += 'sm_' + arch
-            else:
-                arch = arch.replace('.', '')
-                nvcc_flags += '-gencode', 'arch=compute_' + arch + ',code=sm_' + arch
-                nvcc_archs_readable += 'sm_' + arch
-
-        for arch in cuda_arch_ptx:
-            arch, codev = re.fullmatch(
-                '(0-9+\\.0-9)(?:\$(0-9+\\.0-9)\$)?', arch).groups()
-
-            if codev:
-                arch = codev
-
-            if version_compare(arch, '<' + cuda_lo_limit_gpu_architecture):
-                continue
-            if version_compare(arch, '>=' + cuda_hi_limit_gpu_architecture):
-                continue
-
-            arch = arch.replace('.', '')
-            nvcc_flags += '-gencode', 'arch=compute_' + arch + ',code=compute_' + arch
-            nvcc_archs_readable += 'compute_' + arch
-
-        return nvcc_flags, nvcc_archs_readable
-
-def initialize(*args, **kwargs):
-    return CudaModule(*args, **kwargs)

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/modules/unstable_external_project.py Deleted

@@ -1,304 +0,0 @@
-# Copyright 2020 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.
-
-from pathlib import Path
-import os
-import shlex
-import subprocess
-import typing as T
-
-from . import ExtensionModule, ModuleReturnValue, NewExtensionModule
-from .. import mlog, build
-from ..compilers.compilers import CFLAGS_MAPPING
-from ..envconfig import ENV_VAR_PROG_MAP
-from ..dependencies import InternalDependency, PkgConfigDependency
-from ..interpreterbase import FeatureNew
-from ..interpreter.type_checking import ENV_KW, DEPENDS_KW
-from ..interpreterbase.decorators import ContainerTypeInfo, KwargInfo, typed_kwargs, typed_pos_args
-from ..mesonlib import (EnvironmentException, MesonException, Popen_safe, MachineChoice,
-                        get_variable_regex, do_replacement, join_args, OptionKey)
-
-if T.TYPE_CHECKING:
-    from typing_extensions import TypedDict
-
-    from . import ModuleState
-    from ..interpreter import Interpreter
-    from ..interpreterbase import TYPE_var
-    from ..build import BuildTarget, CustomTarget
-
-    class Dependency(TypedDict):
-
-        subdir: str
-
-    class AddProject(TypedDict):
-
-        configure_options: T.Liststr
-        cross_configure_options: T.Liststr
-        verbose: bool
-        env: build.EnvironmentVariables
-        depends: T.ListT.UnionBuildTarget, CustomTarget
-
-
-class ExternalProject(NewExtensionModule):
-    def __init__(self,
-                 state: 'ModuleState',
-                 configure_command: str,
-                 configure_options: T.Liststr,
-                 cross_configure_options: T.Liststr,
-                 env: build.EnvironmentVariables,
-                 verbose: bool,
-                 extra_depends: T.ListT.Union'BuildTarget', 'CustomTarget'):
-        super().__init__()
-        self.methods.update({'dependency': self.dependency_method,
-                             })
-
-        self.subdir = Path(state.subdir)
-        self.project_version = state.project_version
-        self.subproject = state.subproject
-        self.env = state.environment
-        self.build_machine = state.build_machine
-        self.host_machine = state.host_machine
-        self.configure_command = configure_command
-        self.configure_options = configure_options
-        self.cross_configure_options = cross_configure_options
-        self.verbose = verbose
-        self.user_env = env
-
-        self.src_dir = Path(self.env.get_source_dir(), self.subdir)
-        self.build_dir = Path(self.env.get_build_dir(), self.subdir, 'build')
-        self.install_dir = Path(self.env.get_build_dir(), self.subdir, 'dist')
-        _p = self.env.coredata.get_option(OptionKey('prefix'))
-        assert isinstance(_p, str), 'for mypy'
-        self.prefix = Path(_p)
-        _l = self.env.coredata.get_option(OptionKey('libdir'))
-        assert isinstance(_l, str), 'for mypy'
-        self.libdir = Path(_l)
-        _i = self.env.coredata.get_option(OptionKey('includedir'))
-        assert isinstance(_i, str), 'for mypy'
-        self.includedir = Path(_i)
-        self.name = self.src_dir.name
-
-        # On Windows if the prefix is "c:/foo" and DESTDIR is "c:/bar", `make`
-        # will install files into "c:/bar/c:/foo" which is an invalid path.
-        # Work around that issue by removing the drive from prefix.
-        if self.prefix.drive:
-            self.prefix = self.prefix.relative_to(self.prefix.drive)
-
-        # self.prefix is an absolute path, so we cannot append it to another path.
-        self.rel_prefix = self.prefix.relative_to(self.prefix.root)
-
-        self._configure(state)
-
-        self.targets = self._create_targets(extra_depends)
-
-    def _configure(self, state: 'ModuleState') -> None:
-        if self.configure_command == 'waf':
-            FeatureNew('Waf external project', '0.60.0').use(self.subproject, state.current_node)
-            waf = state.find_program('waf')
-            configure_cmd = waf.get_command()
-            configure_cmd += 'configure', '-o', str(self.build_dir)
-            workdir = self.src_dir
-            self.make = waf.get_command() + 'build'
-        else:
-            # Assume it's the name of a script in source dir, like 'configure',
-            # 'autogen.sh', etc).
-            configure_path = Path(self.src_dir, self.configure_command)
-            configure_prog = state.find_program(configure_path.as_posix())
-            configure_cmd = configure_prog.get_command()
-            workdir = self.build_dir
-            self.make = state.find_program('make').get_command()
-
-        d = ('PREFIX', '--prefix=@PREFIX@', self.prefix.as_posix()),
-             ('LIBDIR', '--libdir=@PREFIX@/@LIBDIR@', self.libdir.as_posix()),
-             ('INCLUDEDIR', None, self.includedir.as_posix()),
-             
-        self._validate_configure_options(d, state)
-
-        configure_cmd += self._format_options(self.configure_options, d)
-
-        if self.env.is_cross_build():
-            host = '{}-{}-{}'.format(self.host_machine.cpu_family,
-                                     self.build_machine.system,
-                                     self.host_machine.system)
-            d = ('HOST', None, host)
-            configure_cmd += self._format_options(self.cross_configure_options, d)
-
-        # Set common env variables like CFLAGS, CC, etc.
-        link_exelist: T.Liststr = 
-        link_args: T.Liststr = 
-        self.run_env = os.environ.copy()
-        for lang, compiler in self.env.coredata.compilersMachineChoice.HOST.items():
-            if any(lang not in i for i in (ENV_VAR_PROG_MAP, CFLAGS_MAPPING)):
-                continue
-            cargs = self.env.coredata.get_external_args(MachineChoice.HOST, lang)
-            assert isinstance(cargs, list), 'for mypy'
-            self.run_envENV_VAR_PROG_MAPlang = self._quote_and_join(compiler.get_exelist())
-            self.run_envCFLAGS_MAPPINGlang = self._quote_and_join(cargs)
-            if not link_exelist:
-                link_exelist = compiler.get_linker_exelist()
-                _l = self.env.coredata.get_external_link_args(MachineChoice.HOST, lang)
-                assert isinstance(_l, list), 'for mypy'
-                link_args = _l
-        if link_exelist:
-            # FIXME: Do not pass linker because Meson uses CC as linker wrapper,
-            # but autotools often expects the real linker (e.h. GNU ld).
-            # self.run_env'LD' = self._quote_and_join(link_exelist)
-            pass
-        self.run_env'LDFLAGS' = self._quote_and_join(link_args)
-
-        self.run_env = self.user_env.get_env(self.run_env)
-        self.run_env = PkgConfigDependency.setup_env(self.run_env, self.env, MachineChoice.HOST,
-                                                     uninstalled=True)
-
-        self.build_dir.mkdir(parents=True, exist_ok=True)
-        self._run('configure', configure_cmd, workdir)
-
-    def _quote_and_join(self, array: T.Liststr) -> str:
-        return ' '.join(shlex.quote(i) for i in array)
-
-    def _validate_configure_options(self, variables: T.ListT.Tuplestr, str, str, state: 'ModuleState') -> None:
-        # Ensure the user at least try to pass basic info to the build system,
-        # like the prefix, libdir, etc.
-        for key, default, val in variables:
-            if default is None:
-                continue
-            key_format = f'@{key}@'
-            for option in self.configure_options:
-                if key_format in option:
-                    break
-            else:
-                FeatureNew('Default configure_option', '0.57.0').use(self.subproject, state.current_node)
-                self.configure_options.append(default)
-
-    def _format_options(self, options: T.Liststr, variables: T.ListT.Tuplestr, str, str) -> T.Liststr:
-        out: T.Liststr = 
-        missing = set()
-        regex = get_variable_regex('meson')
-        confdata: T.Dictstr, T.Tuplestr, T.Optionalstr = {k: (v, None) for k, _, v in variables}
-        for o in options:
-            arg, missing_vars = do_replacement(regex, o, 'meson', confdata)
-            missing.update(missing_vars)
-            out.append(arg)
-        if missing:
-            var_list = ", ".join(map(repr, sorted(missing)))
-            raise EnvironmentException(
-                f"Variables {var_list} in configure options are missing.")
-        return out
-
-    def _run(self, step: str, command: T.Liststr, workdir: Path) -> None:
-        mlog.log(f'External project {self.name}:', mlog.bold(step))
-        m = 'Running command ' + str(command) + ' in directory ' + str(workdir) + '\n'
-        log_filename = Path(mlog.log_dir, f'{self.name}-{step}.log')
-        output = None
-        if not self.verbose:
-            output = open(log_filename, 'w', encoding='utf-8')
-            output.write(m + '\n')
-            output.flush()
-        else:
-            mlog.log(m)
-        p, *_ = Popen_safe(command, cwd=workdir, env=self.run_env,
-                           stderr=subprocess.STDOUT,
-                           stdout=output)
-        if p.returncode != 0:
-            m = f'{step} step returned error code {p.returncode}.'
-            if not self.verbose:
-                m += '\nSee logs: ' + str(log_filename)
-            raise MesonException(m)
-
-    def _create_targets(self, extra_depends: T.ListT.Union'BuildTarget', 'CustomTarget') -> T.List'TYPE_var':
-        cmd = self.env.get_build_command()
-        cmd += '--internal', 'externalproject',
-                '--name', self.name,
-                '--srcdir', self.src_dir.as_posix(),
-                '--builddir', self.build_dir.as_posix(),
-                '--installdir', self.install_dir.as_posix(),
-                '--logdir', mlog.log_dir,
-                '--make', join_args(self.make),
-                
-        if self.verbose:
-            cmd.append('--verbose')
-
-        self.target = build.CustomTarget(
-            self.name,
-            self.subdir.as_posix(),
-            self.subproject,
-            self.env,
-            cmd + '@OUTPUT@', '@DEPFILE@',
-            ,
-            f'{self.name}.stamp',
-            depfile=f'{self.name}.d',
-            console=True,
-            extra_depends=extra_depends,
-        )
-
-        idir = build.InstallDir(self.subdir.as_posix(),
-                                Path('dist', self.rel_prefix).as_posix(),
-                                install_dir='.',
-                                install_mode=None,
-                                exclude=None,
-                                strip_directory=True,
-                                from_source_dir=False,
-                                subproject=self.subproject)
-
-        return self.target, idir
-
-    @typed_pos_args('external_project.dependency', str)
-    @typed_kwargs('external_project.dependency', KwargInfo('subdir', str, default=''))
-    def dependency_method(self, state: 'ModuleState', args: T.Tuplestr, kwargs: 'Dependency') -> InternalDependency:
-        libname = args0
-
-        abs_includedir = Path(self.install_dir, self.rel_prefix, self.includedir)
-        if kwargs'subdir':
-            abs_includedir = Path(abs_includedir, kwargs'subdir')
-        abs_libdir = Path(self.install_dir, self.rel_prefix, self.libdir)
-
-        version = self.project_version
-        compile_args = f'-I{abs_includedir}'
-        link_args = f'-L{abs_libdir}', f'-l{libname}'
-        sources = self.target
-        dep = InternalDependency(version, , compile_args, link_args, ,
-                                 , sources, , {}, , )
-        return dep
-
-
-class ExternalProjectModule(ExtensionModule):
-    @FeatureNew('External build system Module', '0.56.0')
-    def __init__(self, interpreter: 'Interpreter'):
-        super().__init__(interpreter)
-        self.methods.update({'add_project': self.add_project,
-                             })
-
-    @typed_pos_args('external_project_mod.add_project', str)
-    @typed_kwargs(
-        'external_project.add_project',
-        KwargInfo('configure_options', ContainerTypeInfo(list, str), default=, listify=True),
-        KwargInfo('cross_configure_options', ContainerTypeInfo(list, str), default='--host=@HOST@', listify=True),
-        KwargInfo('verbose', bool, default=False),
-        ENV_KW,
-        DEPENDS_KW.evolve(since='0.63.0'),
-    )
-    def add_project(self, state: 'ModuleState', args: T.Tuplestr, kwargs: 'AddProject') -> ModuleReturnValue:
-        configure_command = args0
-        project = ExternalProject(state,
-                                  configure_command,
-                                  kwargs'configure_options',
-                                  kwargs'cross_configure_options',
-                                  kwargs'env',
-                                  kwargs'verbose',
-                                  kwargs'depends')
-        return ModuleReturnValue(project, project.targets)
-
-
-def initialize(interp: 'Interpreter') -> ExternalProjectModule:
-    return ExternalProjectModule(interp)

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/modules/unstable_icestorm.py Deleted

@@ -1,131 +0,0 @@
-# Copyright 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.
-
-from __future__ import annotations
-import itertools
-import typing as T
-
-from . import ExtensionModule, ModuleReturnValue
-from .. import build
-from .. import mesonlib
-from ..interpreter.type_checking import CT_INPUT_KW
-from ..interpreterbase import FeatureNew
-from ..interpreterbase.decorators import KwargInfo, typed_kwargs, typed_pos_args
-
-if T.TYPE_CHECKING:
-    from typing_extensions import TypedDict
-
-    from . import ModuleState
-    from ..interpreter import Interpreter
-    from ..programs import ExternalProgram
-
-    class ProjectKwargs(TypedDict):
-
-        sources: T.ListT.Unionmesonlib.FileOrString, build.GeneratedTypes
-        constraint_file: T.Unionmesonlib.FileOrString, build.GeneratedTypes
-
-class IceStormModule(ExtensionModule):
-
-    @FeatureNew('FPGA/Icestorm Module', '0.45.0')
-    def __init__(self, interpreter: Interpreter) -> None:
-        super().__init__(interpreter)
-        self.tools: T.Dictstr, ExternalProgram = {}
-        self.methods.update({
-            'project': self.project,
-        })
-
-    def detect_tools(self, state: ModuleState) -> None:
-        self.tools'yosys' = state.find_program('yosys')
-        self.tools'arachne' = state.find_program('arachne-pnr')
-        self.tools'icepack' = state.find_program('icepack')
-        self.tools'iceprog' = state.find_program('iceprog')
-        self.tools'icetime' = state.find_program('icetime')
-
-    @typed_pos_args('icestorm.project', str,
-                    varargs=(str, mesonlib.File, build.CustomTarget, build.CustomTargetIndex,
-                             build.GeneratedList))
-    @typed_kwargs(
-        'icestorm.project',
-        CT_INPUT_KW.evolve(name='sources'),
-        KwargInfo(
-            'constraint_file',
-            (str, mesonlib.File, build.CustomTarget, build.CustomTargetIndex, build.GeneratedList),
-            required=True,
-        )
-    )
-    def project(self, state: ModuleState,
-                args: T.Tuplestr, T.ListT.Unionmesonlib.FileOrString, build.GeneratedTypes,
-                kwargs: ProjectKwargs) -> ModuleReturnValue:
-        if not self.tools:
-            self.detect_tools(state)
-        proj_name, arg_sources = args
-        all_sources = self.interpreter.source_strings_to_files(
-            list(itertools.chain(arg_sources, kwargs'sources')))
-
-        blif_target = build.CustomTarget(
-            f'{proj_name}_blif',
-            state.subdir,
-            state.subproject,
-            state.environment,
-            self.tools'yosys', '-q', '-p', 'synth_ice40 -blif @OUTPUT@', '@INPUT@',
-            all_sources,
-            f'{proj_name}.blif',
-        )
-
-        asc_target = build.CustomTarget(
-            f'{proj_name}_asc',
-            state.subdir,
-            state.subproject,
-            state.environment,
-            self.tools'arachne', '-q', '-d', '1k', '-p', '@INPUT@', '-o', '@OUTPUT@',
-            kwargs'constraint_file', blif_target,
-            f'{proj_name}.asc',
-        )
-
-        bin_target = build.CustomTarget(
-            f'{proj_name}_bin',
-            state.subdir,
-            state.subproject,
-            state.environment,
-            self.tools'icepack', '@INPUT@', '@OUTPUT@',
-            asc_target,
-            f'{proj_name}.bin',
-            build_by_default=True,
-        )
-
-        upload_target = build.RunTarget(
-            f'{proj_name}-upload',
-            self.tools'iceprog', bin_target,
-            ,
-            state.subdir,
-            state.subproject,
-            state.environment,
-        )
-
-        time_target = build.RunTarget(
-            f'{proj_name}-time',
-            self.tools'icetime', bin_target,
-            ,
-            state.subdir,
-            state.subproject,
-            state.environment,
-        )
-
-        return ModuleReturnValue(
-            None,
-            blif_target, asc_target, bin_target, upload_target, time_target)
-
-
-def initialize(interp: Interpreter) -> IceStormModule:
-    return IceStormModule(interp)

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/modules/unstable_rust.py Deleted

@@ -1,234 +0,0 @@
-# Copyright © 2020 Intel Corporation
-
-# 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 os
-import typing as T
-
-from . import ExtensionModule, ModuleReturnValue
-from .. import mlog
-from ..build import BothLibraries, BuildTarget, CustomTargetIndex, Executable, ExtractedObjects, GeneratedList, IncludeDirs, CustomTarget, StructuredSources
-from ..dependencies import Dependency, ExternalLibrary
-from ..interpreter.interpreter import TEST_KWARGS, OUTPUT_KW
-from ..interpreterbase import ContainerTypeInfo, InterpreterException, KwargInfo, FeatureNew, typed_kwargs, typed_pos_args, noPosargs
-from ..mesonlib import File
-
-if T.TYPE_CHECKING:
-    from . import ModuleState
-    from ..interpreter import Interpreter
-    from ..interpreter import kwargs as _kwargs
-    from ..interpreter.interpreter import SourceInputs, SourceOutputs
-    from ..programs import ExternalProgram
-
-    from typing_extensions import TypedDict
-
-    class FuncTest(_kwargs.BaseTest):
-
-        dependencies: T.ListT.UnionDependency, ExternalLibrary
-        is_parallel: bool
-
-    class FuncBindgen(TypedDict):
-
-        args: T.Liststr
-        c_args: T.Liststr
-        include_directories: T.ListIncludeDirs
-        input: T.ListSourceInputs
-        output: str
-
-
-class RustModule(ExtensionModule):
-
-    """A module that holds helper functions for rust."""
-
-    @FeatureNew('rust module', '0.57.0')
-    def __init__(self, interpreter: 'Interpreter') -> None:
-        super().__init__(interpreter)
-        self._bindgen_bin: T.Optional'ExternalProgram' = None
-        self.methods.update({
-            'test': self.test,
-            'bindgen': self.bindgen,
-        })
-
-    @typed_pos_args('rust.test', str, BuildTarget)
-    @typed_kwargs(
-        'rust.test',
-        *TEST_KWARGS,
-        KwargInfo('is_parallel', bool, default=False),
-        KwargInfo(
-            'dependencies',
-            ContainerTypeInfo(list, (Dependency, ExternalLibrary)),
-            listify=True,
-            default=),
-    )
-    def test(self, state: 'ModuleState', args: T.Tuplestr, BuildTarget, kwargs: 'FuncTest') -> ModuleReturnValue:
-        """Generate a rust test target from a given rust target.
-
-        Rust puts it's unitests inside it's main source files, unlike most
-        languages that put them in external files. This means that normally
-        you have to define two separate targets with basically the same
-        arguments to get tests:
-
-        ```meson
-        rust_lib_sources = ...
-        rust_lib = static_library(
-            'rust_lib',
-            rust_lib_sources,
-        )
-
-        rust_lib_test = executable(
-            'rust_lib_test',
-            rust_lib_sources,
-            rust_args : '--test',
-        )
-
-        test(
-            'rust_lib_test',
-            rust_lib_test,
-            protocol : 'rust',
-        )
-        ```
-
-        This is all fine, but not very DRY. This method makes it much easier
-        to define rust tests:
-
-        ```meson
-        rust = import('unstable-rust')
-
-        rust_lib = static_library(
-            'rust_lib',
-            sources,
-        )
-
-        rust.test('rust_lib_test', rust_lib)
-        ```
-        """
-        name = args0
-        base_target: BuildTarget = args1
-        if not base_target.uses_rust():
-            raise InterpreterException('Second positional argument to rustmod.test() must be a rust based target')
-        extra_args = kwargs'args'
-
-        # Delete any arguments we don't want passed
-        if '--test' in extra_args:
-            mlog.warning('Do not add --test to rustmod.test arguments')
-            extra_args.remove('--test')
-        if '--format' in extra_args:
-            mlog.warning('Do not add --format to rustmod.test arguments')
-            i = extra_args.index('--format')
-            # Also delete the argument to --format
-            del extra_argsi + 1
-            del extra_argsi
-        for i, a in enumerate(extra_args):
-            if isinstance(a, str) and a.startswith('--format='):
-                del extra_argsi
-                break
-
-        dependencies = d for d in kwargs'dependencies'
-
-        # We need to cast here, as currently these don't have protocol in them, but test itself does.
-        tkwargs = T.cast('_kwargs.FuncTest', kwargs.copy())
-
-        tkwargs'args' = extra_args + '--test', '--format', 'pretty'
-        tkwargs'protocol' = 'rust'
-
-        new_target_kwargs = base_target.kwargs.copy()
-        # Don't mutate the shallow copied list, instead replace it with a new
-        # one
-        new_target_kwargs'rust_args' = new_target_kwargs.get('rust_args', ) + '--test'
-        new_target_kwargs'install' = False
-        new_target_kwargs'dependencies' = new_target_kwargs.get('dependencies', ) + dependencies
-
-        new_target = Executable(
-            name, base_target.subdir, state.subproject, base_target.for_machine,
-            base_target.sources, base_target.structured_sources,
-            base_target.objects, base_target.environment, base_target.compilers,
-            new_target_kwargs
-        )
-
-        test = self.interpreter.make_test(
-            self.interpreter.current_node, (name, new_target), tkwargs)
-
-        return ModuleReturnValue(None, new_target, test)
-
-    @noPosargs
-    @typed_kwargs(
-        'rust.bindgen',
-        KwargInfo('c_args', ContainerTypeInfo(list, str), default=, listify=True),
-        KwargInfo('args', ContainerTypeInfo(list, str), default=, listify=True),
-        KwargInfo('include_directories', ContainerTypeInfo(list, IncludeDirs), default=, listify=True),
-        KwargInfo(
-            'input',
-            ContainerTypeInfo(list, (File, GeneratedList, BuildTarget, BothLibraries, ExtractedObjects, CustomTargetIndex, CustomTarget, str), allow_empty=False),
-            default=,
-            listify=True,
-            required=True,
-        ),
-        OUTPUT_KW,
-    )
-    def bindgen(self, state: 'ModuleState', args: T.List, kwargs: 'FuncBindgen') -> ModuleReturnValue:
-        """Wrapper around bindgen to simplify it's use.
-
-        The main thing this simplifies is the use of `include_directory`
-        objects, instead of having to pass a plethora of `-I` arguments.
-        """
-        header, *_deps = self.interpreter.source_strings_to_files(kwargs'input')
-
-        # Split File and Target dependencies to add pass to CustomTarget
-        depends: T.List'SourceOutputs' = 
-        depend_files: T.ListFile = 
-        for d in _deps:
-            if isinstance(d, File):
-                depend_files.append(d)
-            else:
-                depends.append(d)
-
-        inc_strs: T.Liststr = 
-        for i in kwargs'include_directories':
-            # bindgen always uses clang, so it's safe to hardcode -I here
-            inc_strs.extend(f'-I{x}' for x in i.to_string_list(
-                state.environment.get_source_dir(), state.environment.get_build_dir()))
-
-        if self._bindgen_bin is None:
-            self._bindgen_bin = state.find_program('bindgen')
-
-        name: str
-        if isinstance(header, File):
-            name = header.fname
-        elif isinstance(header, (BuildTarget, BothLibraries, ExtractedObjects, StructuredSources)):
-            raise InterpreterException('bindgen source file must be a C header, not an object or build target')
-        else:
-            name = header.get_outputs()0
-
-        target = CustomTarget(
-            f'rustmod-bindgen-{name}'.replace('/', '_'),
-            state.subdir,
-            state.subproject,
-            state.environment,
-            self._bindgen_bin.get_command() + 
-                '@INPUT@', '--output',
-                os.path.join(state.environment.build_dir, '@OUTPUT@') +
-                kwargs'args' + '--' + kwargs'c_args' + inc_strs +
-                '-MD', '-MQ', '@INPUT@', '-MF', '@DEPFILE@',
-            header,
-            kwargs'output',
-            depfile='@PLAINNAME@.d',
-            extra_depends=depends,
-            depend_files=depend_files,
-            backend=state.backend,
-        )
-
-        return ModuleReturnValue(target, target)
-
-
-def initialize(interp: 'Interpreter') -> RustModule:
-    return RustModule(interp)

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/modules/unstable_simd.py Deleted

@@ -1,88 +0,0 @@
-# Copyright 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.
-
-from .. import mesonlib, compilers, mlog
-from .. import build
-
-from . import ExtensionModule
-
-from ..interpreterbase import FeatureNew
-
-class SimdModule(ExtensionModule):
-
-    @FeatureNew('SIMD module', '0.42.0')
-    def __init__(self, interpreter):
-        super().__init__(interpreter)
-        # FIXME add Altivec and AVX512.
-        self.isets = ('mmx',
-                      'sse',
-                      'sse2',
-                      'sse3',
-                      'ssse3',
-                      'sse41',
-                      'sse42',
-                      'avx',
-                      'avx2',
-                      'neon',
-                      )
-        self.methods.update({
-            'check': self.check,
-        })
-
-    def check(self, state, args, kwargs):
-        result = 
-        if len(args) != 1:
-            raise mesonlib.MesonException('Check requires one argument, a name prefix for checks.')
-        prefix = args0
-        if not isinstance(prefix, str):
-            raise mesonlib.MesonException('Argument must be a string.')
-        if 'compiler' not in kwargs:
-            raise mesonlib.MesonException('Must specify compiler keyword')
-        if 'sources' in kwargs:
-            raise mesonlib.MesonException('SIMD module does not support the "sources" keyword')
-        basic_kwargs = {}
-        for key, value in kwargs.items():
-            if key not in self.isets and key != 'compiler':
-                basic_kwargskey = value
-        compiler = kwargs'compiler'
-        if not isinstance(compiler, compilers.compilers.Compiler):
-            raise mesonlib.MesonException('Compiler argument must be a compiler object.')
-        conf = build.ConfigurationData()
-        for iset in self.isets:
-            if iset not in kwargs:
-                continue
-            iset_fname = kwargsiset # Might also be an array or Files. static_library will validate.
-            args = compiler.get_instruction_set_args(iset)
-            if args is None:
-                mlog.log('Compiler supports %s:' % iset, mlog.red('NO'))
-                continue
-            if args:
-                if not compiler.has_multi_arguments(args, state.environment)0:
-                    mlog.log('Compiler supports %s:' % iset, mlog.red('NO'))
-                    continue
-            mlog.log('Compiler supports %s:' % iset, mlog.green('YES'))
-            conf.values'HAVE_' + iset.upper() = ('1', 'Compiler supports %s.' % iset)
-            libname = prefix + '_' + iset
-            lib_kwargs = {'sources': iset_fname,
-                          }
-            lib_kwargs.update(basic_kwargs)
-            langarg_key = compiler.get_language() + '_args'
-            old_lang_args = mesonlib.extract_as_list(lib_kwargs, langarg_key)
-            all_lang_args = old_lang_args + args
-            lib_kwargslangarg_key = all_lang_args
-            result.append(self.interpreter.func_static_lib(None, libname, lib_kwargs))
-        return result, conf
-
-def initialize(*args, **kwargs):
-    return SimdModule(*args, **kwargs)

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/modules/unstable_wayland.py Deleted

@@ -1,130 +0,0 @@
-# Copyright 2022 Mark Bolhuis <mark@bolhuis.dev>
-
-# 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 os
-
-from . import ExtensionModule, ModuleReturnValue
-from ..build import CustomTarget
-from ..interpreter.type_checking import NoneType, in_set_validator
-from ..interpreterbase import FeatureNew, typed_pos_args, typed_kwargs, KwargInfo
-from ..mesonlib import File, MesonException
-
-
-class WaylandModule(ExtensionModule):
-
-    @FeatureNew('wayland module', '0.62.0')
-    def __init__(self, interpreter):
-        super().__init__(interpreter)
-
-        self.protocols_dep = None
-        self.pkgdatadir = None
-        self.scanner_bin = None
-
-        self.methods.update({
-            'scan_xml': self.scan_xml,
-            'find_protocol': self.find_protocol,
-        })
-
-    @typed_pos_args('wayland.scan_xml', varargs=(str, File), min_varargs=1)
-    @typed_kwargs(
-        'wayland.scan_xml',
-        KwargInfo('public', bool, default=False),
-        KwargInfo('client', bool, default=True),
-        KwargInfo('server', bool, default=False),
-    )
-    def scan_xml(self, state, args, kwargs):
-        if self.scanner_bin is None:
-            # wayland-scanner from BUILD machine must have same version as wayland
-            # libraries from HOST machine.
-            dep = state.dependency('wayland-client')
-            self.scanner_bin = state.find_tool('wayland-scanner', 'wayland-scanner', 'wayland_scanner',
-                                               wanted=dep.version)
-
-        scope = 'public' if kwargs'public' else 'private'
-        sides = i for i in 'client', 'server' if kwargsi
-        if not sides:
-            raise MesonException('At least one of client or server keyword argument must be set to true.')
-
-        xml_files = self.interpreter.source_strings_to_files(args0)
-        targets = 
-        for xml_file in xml_files:
-            name = os.path.splitext(os.path.basename(xml_file.fname))0
-
-            code = CustomTarget(
-                f'{name}-protocol',
-                state.subdir,
-                state.subproject,
-                state.environment,
-                self.scanner_bin, f'{scope}-code', '@INPUT@', '@OUTPUT@',
-                xml_file,
-                f'{name}-protocol.c',
-                backend=state.backend,
-            )
-            targets.append(code)
-
-            for side in sides:
-                header = CustomTarget(
-                    f'{name}-{side}-protocol',
-                    state.subdir,
-                    state.subproject,
-                    state.environment,
-                    self.scanner_bin, f'{side}-header', '@INPUT@', '@OUTPUT@',
-                    xml_file,
-                    f'{name}-{side}-protocol.h',
-                    backend=state.backend,
-                )
-                targets.append(header)
-
-        return ModuleReturnValue(targets, targets)
-
-    @typed_pos_args('wayland.find_protocol', str)
-    @typed_kwargs(
-        'wayland.find_protocol',
-        KwargInfo('state', str, default='stable', validator=in_set_validator({'stable', 'staging', 'unstable'})),
-        KwargInfo('version', (int, NoneType)),
-    )
-    def find_protocol(self, state, args, kwargs):
-        base_name = args0
-        xml_state = kwargs'state'
-        version = kwargs'version'
-
-        if xml_state != 'stable' and version is None:
-            raise MesonException(f'{xml_state} protocols require a version number.')
-
-        if xml_state == 'stable' and version is not None:
-            raise MesonException('stable protocols do not require a version number.')
-
-        if self.protocols_dep is None:
-            self.protocols_dep = state.dependency('wayland-protocols')
-
-        if self.pkgdatadir is None:
-            self.pkgdatadir = self.protocols_dep.get_variable(pkgconfig='pkgdatadir', internal='pkgdatadir')
-
-        if xml_state == 'stable':
-            xml_name = f'{base_name}.xml'
-        elif xml_state == 'staging':
-            xml_name = f'{base_name}-v{version}.xml'
-        else:
-            xml_name = f'{base_name}-unstable-v{version}.xml'
-
-        path = os.path.join(self.pkgdatadir, xml_state, base_name, xml_name)
-
-        if not os.path.exists(path):
-            raise MesonException(f'The file {path} does not exist.')
-
-        return File.from_absolute_file(path)
-
-
-def initialize(interpreter):
-    return WaylandModule(interpreter)

_service:tar_scm:meson-0.63.2.tar.gz/test cases/common/153 wrap file should not failed/subprojects/.gitignore Deleted

_service:tar_scm:meson-0.63.2.tar.gz/test cases/common/153 wrap file should not failed/subprojects/bar-1.0 Deleted

_service:tar_scm:meson-0.63.2.tar.gz/test cases/common/153 wrap file should not failed/subprojects/bar-1.0/bar.c Deleted

_service:tar_scm:meson-0.63.2.tar.gz/test cases/common/153 wrap file should not failed/subprojects/bar-1.0/meson.build Deleted

_service:tar_scm:meson-0.63.2.tar.gz/test cases/common/153 wrap file should not failed/subprojects/foo-1.0 Deleted

_service:tar_scm:meson-0.63.2.tar.gz/test cases/common/153 wrap file should not failed/subprojects/foo-1.0-patchdir Deleted

_service:tar_scm:meson-0.63.2.tar.gz/test cases/common/153 wrap file should not failed/subprojects/foo-1.0-patchdir/foo.c Deleted

_service:tar_scm:meson-0.63.2.tar.gz/test cases/common/153 wrap file should not failed/subprojects/foo-1.0-patchdir/meson.build Deleted

_service:tar_scm:meson-0.63.2.tar.gz/test cases/common/153 wrap file should not failed/subprojects/foo-1.0/foo.c Deleted

_service:tar_scm:meson-0.63.2.tar.gz/test cases/common/153 wrap file should not failed/subprojects/foo-1.0/meson.build Deleted

_service:tar_scm:meson-0.63.2.tar.gz/test cases/common/234 get_file_contents/.gitattributes Deleted

_service:tar_scm:meson-0.63.2.tar.gz/test cases/common/251 subproject dependency variables Deleted

_service:tar_scm:meson-0.63.2.tar.gz/test cases/common/251 subproject dependency variables/subprojects Deleted

_service:tar_scm:meson-0.63.2.tar.gz/test cases/common/251 subproject dependency variables/subprojects/subfiles Deleted

_service:tar_scm:meson-0.63.2.tar.gz/test cases/common/251 subproject dependency variables/subprojects/subfiles/foo.c Deleted

_service:tar_scm:meson-0.63.2.tar.gz/test cases/common/251 subproject dependency variables/subprojects/subfiles/subdir Deleted

_service:tar_scm:meson-0.63.2.tar.gz/test cases/common/251 subproject dependency variables/subprojects/subfiles/subdir/foo.c Deleted

_service:tar_scm:meson-0.63.2.tar.gz/test cases/common/251 subproject dependency variables/subprojects/subfiles/subdir2 Deleted

_service:tar_scm:meson-0.63.2.tar.gz/test cases/common/251 subproject dependency variables/subprojects/subfiles/subdir2/foo.c Deleted

_service:tar_scm:meson-0.63.2.tar.gz/test cases/common/253 long output Deleted

_service:tar_scm:meson-0.63.2.tar.gz/test cases/common/253 subproject extracted objects Deleted

_service:tar_scm:meson-0.63.2.tar.gz/test cases/common/253 subproject extracted objects/subprojects Deleted

_service:tar_scm:meson-0.63.2.tar.gz/test cases/common/253 subproject extracted objects/subprojects/myobjects Deleted

_service:tar_scm:meson-0.63.2.tar.gz/test cases/d/11 dub/.gitignore Deleted

_service:tar_scm:meson-0.63.2.tar.gz/test cases/failing/123 subproject sandbox violation Deleted

_service:tar_scm:meson-0.63.2.tar.gz/test cases/failing/123 subproject sandbox violation/subprojects Deleted

_service:tar_scm:meson-0.63.2.tar.gz/test cases/failing/123 subproject sandbox violation/subprojects/subproj1 Deleted

_service:tar_scm:meson-0.63.2.tar.gz/test cases/failing/123 subproject sandbox violation/subprojects/subproj1/file.txt Deleted

_service:tar_scm:meson-0.63.2.tar.gz/test cases/failing/123 subproject sandbox violation/subprojects/subproj1/nested Deleted

_service:tar_scm:meson-0.63.2.tar.gz/test cases/failing/123 subproject sandbox violation/subprojects/subproj2 Deleted

_service:tar_scm:meson-0.63.2.tar.gz/test cases/failing/123 subproject sandbox violation/subprojects/subproj2/file.txt Deleted

_service:tar_scm:meson-0.63.2.tar.gz/test cases/failing/123 subproject sandbox violation/subprojects/subproj2/nested Deleted

_service:tar_scm:meson-0.63.2.tar.gz/test cases/failing/123 subproject sandbox violation/subprojects/subproj2/nested/meson.build Deleted

_service:tar_scm:meson-0.63.2.tar.gz/test cases/failing/123 subproject sandbox violation/subprojects/subproj3 Deleted

_service:tar_scm:meson-0.63.2.tar.gz/test cases/failing/123 subproject sandbox violation/subprojects/subproj3/file.txt Deleted

_service:tar_scm:meson-0.63.2.tar.gz/test cases/failing/123 subproject sandbox violation/test.json Deleted

_service:tar_scm:meson-0.63.2.tar.gz/test cases/failing/124 override and add_project_dependency Deleted

_service:tar_scm:meson-0.63.2.tar.gz/test cases/failing/124 override and add_project_dependency/inc Deleted

_service:tar_scm:meson-0.63.2.tar.gz/test cases/failing/124 override and add_project_dependency/inc/lib.h Deleted

_service:tar_scm:meson-0.63.2.tar.gz/test cases/failing/124 override and add_project_dependency/lib.c Deleted

_service:tar_scm:meson-0.63.2.tar.gz/test cases/failing/124 override and add_project_dependency/subprojects Deleted

_service:tar_scm:meson-0.63.2.tar.gz/test cases/failing/124 override and add_project_dependency/subprojects/a Deleted

_service:tar_scm:meson-0.63.2.tar.gz/test cases/failing/124 override and add_project_dependency/test.json Deleted

_service:tar_scm:meson-0.63.2.tar.gz/test cases/failing/125 targets before add_project_dependency Deleted

_service:tar_scm:meson-0.63.2.tar.gz/test cases/failing/125 targets before add_project_dependency/inc Deleted

_service:tar_scm:meson-0.63.2.tar.gz/test cases/failing/125 targets before add_project_dependency/test.json Deleted

_service:tar_scm:meson-0.63.2.tar.gz/test cases/failing/126 extract from unity Deleted

_service:tar_scm:meson-0.63.2.tar.gz/test cases/failing/126 extract from unity/test.json Deleted

_service:tar_scm:meson-0.63.2.tar.gz/test cases/failing/127 subproject object as a dependency Deleted

_service:tar_scm:meson-0.63.2.tar.gz/test cases/failing/127 subproject object as a dependency/subprojects Deleted

_service:tar_scm:meson-0.63.2.tar.gz/test cases/failing/127 subproject object as a dependency/subprojects/sub Deleted

_service:tar_scm:meson-0.63.2.tar.gz/test cases/failing/127 subproject object as a dependency/test.json Deleted

_service:tar_scm:meson-0.63.2.tar.gz/test cases/frameworks/35 boost symlinks/boost/include/boost/version.hpp Deleted

_service:tar_scm:meson-0.63.2.tar.gz/test cases/unit/78 user options for subproject/.gitignore Deleted

_service:tar_scm:meson-0.63.2.tar.gz/test cases/unit/78 user options for subproject/75 user options for subproject/.gitignore Deleted

_service:tar_scm:meson-0.63.2.tar.gz/test cases/unit/97 link full name/.gitignore Deleted

_service:tar_scm:meson-0.63.2.tar.gz/test cases/windows/18 msvc cplusplus define Deleted

_service:tar_scm:meson-0.63.2.tar.gz/test cases/windows/19 vs install static lib with generated obj deps Deleted

_service:tar_scm:meson-1.0.1.tar.gz/.editorconfig Added

_service:tar_scm:meson-1.0.1.tar.gz/.flake8 Added

_service:tar_scm:meson-1.0.1.tar.gz/.github Added

_service:tar_scm:meson-1.0.1.tar.gz/.github/ISSUE_TEMPLATE Added

_service:tar_scm:meson-1.0.1.tar.gz/.github/ISSUE_TEMPLATE/bug_report.md Added

_service:tar_scm:meson-1.0.1.tar.gz/.github/codecov.yml Added

_service:tar_scm:meson-1.0.1.tar.gz/.github/codeql Added

_service:tar_scm:meson-1.0.1.tar.gz/.github/codeql/codeql-config.yml Added

_service:tar_scm:meson-1.0.1.tar.gz/.github/codeql/lgtm.qls Added

_service:tar_scm:meson-1.0.1.tar.gz/.github/workflows Added

_service:tar_scm:meson-1.0.1.tar.gz/.github/workflows/codeql-analysis.yml Added

_service:tar_scm:meson-1.0.1.tar.gz/.github/workflows/cygwin.yml Added

@@ -0,0 +1,107 @@
+name: cygwin
+
+concurrency:
+  group: cygwin-${{ github.head_ref || github.ref }}
+  cancel-in-progress: true
+
+on:
+  push:
+    paths:
+      - "mesonbuild/**"
+      - "test cases/**"
+      - ".github/workflows/cygwin.yml"
+      - "run*tests.py"
+  pull_request:
+    paths:
+      - "mesonbuild/**"
+      - "test cases/**"
+      - ".github/workflows/cygwin.yml"
+      - "run*tests.py"
+
+permissions:
+  contents: read
+
+jobs:
+  test:
+    runs-on: windows-latest
+    name: ${{ matrix.NAME }}
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - NAME: gccx64ninja
+            ARCH: x86_64
+    env:
+      MESON_CI_JOBNAME: cygwin-${{ matrix.NAME }}
+
+    steps:
+      # cache should be saved on failure, but the action doesn't support that
+      # https://github.com/actions/cache/issues/92
+      - uses: actions/cache@v1
+        with:
+          # should use 'pip3 cache dir' to discover this path
+          path: C:\cygwin\home\runneradmin\.cache\pip
+          key: cygwin-pip-${{ github.run_number }}
+          restore-keys: cygwin-pip-
+
+      - run: git config --global core.autocrlf input
+
+      - uses: actions/checkout@v3
+
+      - uses: cygwin/cygwin-install-action@master
+        with:
+          platform: ${{ matrix.ARCH }}
+          packages: |
+            cmake
+            gcc-fortran
+            gcc-objc++
+            gcc-objc
+            git
+            gobject-introspection
+            gtk-doc
+            libboost-devel
+            libglib2.0-devel
+            libgtk3-devel
+            libxml2-devel
+            libxslt-devel
+            ninja
+            python2-devel
+            python3-devel
+            python3-libxml2
+            python3-libxslt
+            python39-pip
+            python39-wheel
+            vala
+            zlib-devel
+
+      - name: work around gcovr bug https://github.com/gcovr/gcovr/pull/576
+        run: |
+          export PATH=/usr/bin:/usr/local/bin:$(cygpath ${SYSTEMROOT})/system32
+          python3 -m pip --disable-pip-version-check install 'jinja2<3.1.0'
+        shell: C:\cygwin\bin\bash.exe --noprofile --norc -o igncr -eo pipefail '{0}'
+
+      - name: Run pip
+        run: |
+          export PATH=/usr/bin:/usr/local/bin:$(cygpath ${SYSTEMROOT})/system32
+          python3 -m pip --disable-pip-version-check install gcovr jsonschema pefile pytest pytest-subtests pytest-xdist coverage codecov
+        shell: C:\cygwin\bin\bash.exe --noprofile --norc -o igncr -eo pipefail '{0}'
+
+      - name: Run tests
+        run: |
+          export PATH=/usr/bin:/usr/local/bin:$(cygpath ${SYSTEMROOT})/system32
+          python3 ./tools/run_with_cov.py run_tests.py --backend=ninja
+        env:
+          # Cygwin's static boost installation is broken (some static library
+          # variants such as boost_thread are not present)
+          SKIP_STATIC_BOOST: 1
+        shell: C:\cygwin\bin\bash.exe --noprofile --norc -o igncr -eo pipefail '{0}'
+
+      - uses: actions/upload-artifact@v3
+        with:
+          name: ${{ matrix.NAME }}
+          path: meson-test-run.*
+        # test log should be saved on failure
+        if: ${{ !cancelled() }}
+
+      - name: Upload coverage report
+        run: ./ci/upload_cov.sh "${{ matrix.NAME }}"

_service:tar_scm:meson-1.0.1.tar.gz/.github/workflows/file_format.yml Added

_service:tar_scm:meson-1.0.1.tar.gz/.github/workflows/images.yml Added

@@ -0,0 +1,67 @@
+name: CI image builder
+
+concurrency:
+  group: img_builder-${{ github.head_ref || github.ref }}
+  cancel-in-progress: true
+
+on:
+  push:
+    branches:
+      - master
+    paths:
+      - 'ci/ciimage/**'
+      - '.github/workflows/images.yml'
+
+  pull_request:
+    branches:
+      - master
+    paths:
+      - 'ci/ciimage/**'
+      - '.github/workflows/images.yml'
+
+  # Rebuild the images every week (Sunday)
+  schedule:
+    - cron: '0 0 * * 0'
+
+permissions:
+  contents: read
+
+jobs:
+  build:
+    # do not run the weekly scheduled job in a fork
+    if: github.event_name != 'schedule' || github.repository == 'mesonbuild/meson'
+    env:
+      HAS_DOCKER_CREDENTIALS: ${{ secrets.DOCKER_PASSWORD != '' }}
+    name: ${{ matrix.cfg.name }}
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        cfg:
+          - { name: Arch Linux,       id: arch     }
+          - { name: CUDA (on Arch),   id: cuda     }
+          - { name: Fedora,           id: fedora   }
+          - { name: OpenSUSE,         id: opensuse }
+          - { name: Ubuntu Bionic,    id: bionic   }
+          - { name: Ubuntu Rolling,   id: ubuntu-rolling  }
+    steps:
+      - uses: actions/checkout@v3
+
+      # Login to dockerhub
+      - name: Docker login
+        if:   (github.event_name == 'push' || github.event_name == 'schedule') && env.HAS_DOCKER_CREDENTIALS == 'true'
+        uses: azure/docker-login@v1
+        with:
+          username: ${{ secrets.DOCKER_USERNAME }}
+          password: ${{ secrets.DOCKER_PASSWORD }}
+
+      # Build and test
+      - name: Building the ${{ matrix.cfg.id }} image
+        run:  ./ci/ciimage/build.py -t build ${{ matrix.cfg.id }}
+      - name: Testing the ${{ matrix.cfg.id }} image
+        run:  ./ci/ciimage/build.py -t test  ${{ matrix.cfg.id }}
+
+      # Publish
+      - name: Push the ${{ matrix.cfg.id }} image
+        run:  docker push mesonbuild/${{ matrix.cfg.id }}
+        if:   (github.event_name == 'push' || github.event_name == 'schedule') && env.HAS_DOCKER_CREDENTIALS == 'true'

_service:tar_scm:meson-1.0.1.tar.gz/.github/workflows/lint.yml Added

@@ -0,0 +1,50 @@
+name: Lint
+
+concurrency:
+  group: lint-${{ github.head_ref || github.ref }}
+  cancel-in-progress: true
+
+on:
+  push:
+    paths:
+    - "**.py"
+    - ".github/workflows/lint.yml"
+  pull_request:
+    paths:
+    - "**.py"
+    - ".github/workflows/lint.yml"
+
+permissions:
+  contents: read
+
+jobs:
+
+  pylint:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v3
+    - uses: actions/setup-python@v4
+      with:
+        python-version: '3.x'
+    - run: python -m pip install pylint
+    - run: pylint mesonbuild
+
+  flake8:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v3
+      - uses: actions/setup-python@v4
+        with:
+          python-version: '3.x'
+      - run: python -m pip install flake8
+      - run: flake8 mesonbuild/
+
+  mypy:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v3
+    - uses: actions/setup-python@v4
+      with:
+        python-version: '3.x'
+    - run: python -m pip install mypy types-PyYAML
+    - run: python run_mypy.py

_service:tar_scm:meson-1.0.1.tar.gz/.github/workflows/macos.yml Added

@@ -0,0 +1,126 @@
+name: macos
+
+concurrency:
+  group: macos-${{ github.head_ref || github.ref }}
+  cancel-in-progress: true
+
+on:
+  push:
+    paths:
+      - "mesonbuild/**"
+      - "test cases/**"
+      - "unittests/**"
+      - ".github/workflows/macos.yml"
+      - "run_unittests.py"
+  pull_request:
+    paths:
+      - "mesonbuild/**"
+      - "test cases/**"
+      - "unittests/**"
+      - ".github/workflows/macos.yml"
+      - "run_unittests.py"
+
+permissions:
+  contents: read
+
+jobs:
+  unittests-appleclang:
+    runs-on: macos-latest
+    steps:
+    - uses: actions/checkout@v3
+    - uses: actions/setup-python@v4
+      with:
+        python-version: '3.x'
+    - run: |
+        python -m pip install --upgrade pip
+        python -m pip install pytest pytest-xdist pytest-subtests jsonschema coverage codecov
+    - run: brew install pkg-config ninja llvm qt@5
+    - env:
+        CPPFLAGS: "-I/usr/local/include"
+        LDFLAGS: "-L/usr/local/lib"
+        MESON_CI_JOBNAME: unittests-appleclang
+        MESON_UNIT_TEST_BACKEND: ninja
+        # These cannot evaluate anything, so we cannot set PATH or SDKROOT here
+      run: |
+        export SDKROOT="$(xcodebuild -version -sdk macosx Path)"
+        export PATH="$HOME/tools:/usr/local/opt/qt@5/bin:$PATH:$(brew --prefix llvm)/bin"
+        export PKG_CONFIG_PATH="/usr/local/opt/qt@5/lib/pkgconfig:$PKG_CONFIG_PATH"
+        ./tools/run_with_cov.py ./run_unittests.py
+    - name: Upload coverage report
+      run: ./ci/upload_cov.sh "appleclang unit tests"
+
+
+  project-tests-appleclang:
+    runs-on: macos-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+        - NAME: macos-clang
+          unity: off
+        - NAME: macos-clang-unity
+          unity: on
+
+    name: ${{ matrix.NAME }}
+    env:
+      MESON_CI_JOBNAME: ${{ matrix.NAME }}
+
+    steps:
+    - uses: actions/checkout@v3
+    # Avoid picking up an older version of LLVM that does not work.
+    - run: brew update
+    # github actions overwrites brew's python. Force it to reassert itself, by running in a separate step.
+    - name: unbreak python in github actions
+      run: |
+        find /usr/local/bin -lname '*/Library/Frameworks/Python.framework/*' -delete
+        sudo rm -rf /Library/Frameworks/Python.framework/
+        brew install --force python3 && brew unlink python3 && brew unlink python3 && brew link --overwrite python3
+    # use python3 from homebrew because it is a valid framework, unlike the actions one:
+    # https://github.com/actions/setup-python/issues/58
+    - run: brew install pkg-config ninja llvm qt@5 boost ldc hdf5 openmpi lapack scalapack sdl2 boost-python3 gtk-doc
+    - run: |
+        python3 -m pip install --upgrade setuptools
+        python3 -m pip install --upgrade pip
+        python3 -m pip install cython coverage codecov
+    - env:
+        CPPFLAGS: "-I/usr/local/include"
+        LDFLAGS: "-L/usr/local/lib"
+        MESON_ARGS: --unity=${{ matrix.unity }}
+        CI: 1
+        # These cannot evaluate anything, so we cannot set PATH or SDKROOT here
+      run: |
+        export SDKROOT="$(xcodebuild -version -sdk macosx Path)"
+        export PATH="$HOME/tools:/usr/local/opt/qt@5/bin:$PATH:$(brew --prefix llvm)/bin"
+        export PKG_CONFIG_PATH="/usr/local/opt/qt@5/lib/pkgconfig:$PKG_CONFIG_PATH"
+        export XML_CATALOG_FILES="/usr/local/etc/xml/catalog"
+        ./tools/run_with_cov.py ./run_project_tests.py --backend=ninja
+    - name: Upload coverage report
+      run: ./ci/upload_cov.sh "appleclang project tests; unity=${{ matrix.unity }}"
+
+  Qt4macos:
+    runs-on: macos-latest
+    steps:
+    - uses: actions/checkout@v3
+    - uses: actions/setup-python@v4
+      with:
+        python-version: '3.x'
+    - run: python -m pip install -e .
+    - run: brew install pkg-config ninja gcc
+    - run: brew tap cartr/qt4
+    - run: brew install qt@4
+    - run: brew link qt@4
+      # qt4 tap seems to be broken
+    - run: ln -sfn /usr/local/Cellar/qt@4/4.8.7_6.reinstall /usr/local/Cellar/qt@4/4.8.7_6
+    - run: meson setup "test cases/frameworks/4 qt" build -Drequired=qt4
+    - run: meson compile -C build
+    - uses: actions/upload-artifact@v3
+      if: failure()
+      with:
+        name: Qt4_Mac_build
+        path: build/meson-logs/meson-log.txt
+    - run: meson test -C build -v
+    - uses: actions/upload-artifact@v3
+      if: failure()
+      with:
+        name: Qt4_Mac_test
+        path: build/meson-logs/testlog.txt

_service:tar_scm:meson-1.0.1.tar.gz/.github/workflows/msys2.yml Added

@@ -0,0 +1,133 @@
+name: msys2
+
+concurrency:
+  group: msys2-${{ github.head_ref || github.ref }}
+  cancel-in-progress: true
+
+on:
+  push:
+    paths:
+      - "mesonbuild/**"
+      - "test cases/**"
+      - "unittests/**"
+      - ".github/workflows/msys2.yml"
+      - "run_unittests.py"
+  pull_request:
+    paths:
+      - "mesonbuild/**"
+      - "test cases/**"
+      - "unittests/**"
+      - ".github/workflows/msys2.yml"
+      - "run_unittests.py"
+
+permissions:
+  contents: read
+
+jobs:
+  test:
+    runs-on: windows-2019
+    name: ${{ matrix.NAME }}
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - NAME: gccx86ninja
+            MSYSTEM: MINGW32
+            MSYS2_ARCH: i686
+            MSYS2_CURSES: ncurses
+            COMPILER: gcc
+            TOOLCHAIN: toolchain
+          - NAME: gccx64ninja
+            MSYSTEM: MINGW64
+            MSYS2_ARCH: x86_64
+            MSYS2_CURSES: pdcurses
+            COMPILER: gcc
+            TOOLCHAIN: toolchain
+          - NAME: clangx64ninja
+            MSYSTEM: MINGW64
+            MSYS2_ARCH: x86_64
+            MSYS2_CURSES:
+            COMPILER: clang
+            TOOLCHAIN: clang
+    env:
+      MESON_CI_JOBNAME: msys2-${{ matrix.NAME }}
+      # XXX: For some reason enabling jit debugging "fixes" random python crashes
+      # see https://github.com/msys2/MINGW-packages/issues/11864
+      MSYS: "winjitdebug"
+
+    defaults:
+      run:
+        shell: msys2 {0}
+
+    steps:
+      - uses: actions/checkout@v3
+
+      - uses: msys2/setup-msys2@v2
+        with:
+          msystem: ${{ matrix.MSYSTEM }}
+          update: true
+          install: >-
+            base-devel
+            git
+            mercurial
+            lcov
+            wget
+            unzip
+            mingw-w64-${{ matrix.MSYS2_ARCH }}-cmake
+            mingw-w64-${{ matrix.MSYS2_ARCH }}-glib2
+            mingw-w64-${{ matrix.MSYS2_ARCH }}-libxml2
+            mingw-w64-${{ matrix.MSYS2_ARCH }}-ninja
+            mingw-w64-${{ matrix.MSYS2_ARCH }}-pkg-config
+            mingw-w64-${{ matrix.MSYS2_ARCH }}-python2
+            mingw-w64-${{ matrix.MSYS2_ARCH }}-python
+            mingw-w64-${{ matrix.MSYS2_ARCH }}-python-lxml
+            mingw-w64-${{ matrix.MSYS2_ARCH }}-python-setuptools
+            mingw-w64-${{ matrix.MSYS2_ARCH }}-python-pip
+            mingw-w64-${{ matrix.MSYS2_ARCH }}-${{ matrix.TOOLCHAIN }}
+
+      - name: Install dependencies
+        run: |
+          python3 -m pip --disable-pip-version-check install gcovr jsonschema pefile pytest pytest-subtests pytest-xdist coverage codecov
+
+      - name: Install pypy3 on x86_64
+        run: |
+          mkdir pypy3local
+          pushd pypy3local
+          wget -nv https://downloads.python.org/pypy/pypy3.8-v7.3.9-win64.zip
+          unzip pypy3.8-v7.3.9-win64.zip
+          mv pypy3.8-v7.3.9-win64/* ./
+          popd
+        if: ${{ matrix.MSYS2_ARCH == 'x86_64' }}
+
+      - name: Run Tests
+        run: |
+          if  "${{ matrix.MSYS2_ARCH }}" == "x86_64" ; then
+            # There apparently is no clean way to add to the PATH in the 
+            # previous step?
+            # See for instance https://github.com/msys2/setup-msys2/issues/171
+            export PATH=$PATH:$PWD/pypy3local
+            # Make sure it is on the PATH
+            pypy3 -c "import sys; print(sys.version)"
+          fi
+          export PATHEXT="$PATHEXT;.py"
+
+          if  '${{ matrix.COMPILER }}' == 'clang' ; then
+            export CC=clang
+            export CXX=clang++
+            export OBJC=clang
+            export OBJCXX=clang++
+          fi
+
+          if  "${{ matrix.MSYS2_CURSES }}" != "" ; then
+            pacman --noconfirm --needed -S mingw-w64-${{ matrix.MSYS2_ARCH }}-${{ matrix.MSYS2_CURSES }}
+          fi
+
+          MSYSTEM= python3 ./tools/run_with_cov.py run_tests.py --backend=ninja
+
+      - uses: actions/upload-artifact@v3
+        with:
+          name: ${{ matrix.NAME }}
+          path: meson-test-run.*
+
+      - name: Upload coverage report
+        run: ./ci/upload_cov.sh "${{ matrix.NAME }}"

_service:tar_scm:meson-1.0.1.tar.gz/.github/workflows/nonative.yml Added

@@ -0,0 +1,44 @@
+name: Cross-only compilation environment
+
+concurrency:
+  group: nonative-${{ github.head_ref || github.ref }}
+  cancel-in-progress: true
+
+on:
+  push:
+    branches:
+      - master
+      # Stable branches such as 0.56 or the eventual 1.0
+      - '0-9+.0-9+'
+    paths:
+      - "mesonbuild/**"
+      - "test cases/**"
+      - ".github/workflows/nonative.yml"
+      - "run*tests.py"
+  pull_request:
+    paths:
+      - "mesonbuild/**"
+      - "test cases/**"
+      - ".github/workflows/nonative.yml"
+      - "run*tests.py"
+
+permissions:
+  contents: read
+
+jobs:
+  cross-only-armhf:
+    runs-on: ubuntu-latest
+    container: mesonbuild/eoan:latest
+    env:
+      MESON_CI_JOBNAME: ubuntu-${{ github.job }}
+
+    steps:
+    - run: |
+        apt-get -y purge clang gcc gdc
+        apt-get -y autoremove
+        python3 -m pip install coverage codecov
+    - uses: actions/checkout@v3
+    - name: Run tests
+      run: bash -c 'source /ci/env_vars.sh; cd $GITHUB_WORKSPACE; ./tools/run_with_cov.py ./run_tests.py $CI_ARGS --cross ubuntu-armhf.json --cross-only'
+    - name: Upload coverage report
+      run: ./ci/upload_cov.sh "Ubuntu nonnative"

_service:tar_scm:meson-1.0.1.tar.gz/.github/workflows/os_comp.yml Added

@@ -0,0 +1,149 @@
+name: linux
+
+concurrency:
+  group: linux-${{ github.head_ref || github.ref }}
+  cancel-in-progress: true
+
+on:
+  push:
+    branches:
+      - master
+      # Stable branches such as 0.56 or the eventual 1.0
+      - '0-9+.0-9+'
+    paths:
+      - "mesonbuild/**"
+      - "test cases/**"
+      - "unittests/**"
+      - ".github/workflows/images.yml"
+      - ".github/workflows/os_comp.yml"
+      - "run_unittests.py"
+  pull_request:
+    paths:
+      - "mesonbuild/**"
+      - "test cases/**"
+      - "unittests/**"
+      - ".github/workflows/images.yml"
+      - ".github/workflows/os_comp.yml"
+      - "run_unittests.py"
+
+permissions:
+  contents: read
+
+jobs:
+  arch:
+    name: ${{ matrix.cfg.name }}
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        cfg:
+          - { name: Arch Linux,       id: arch     }
+          - { name: CUDA (on Arch),   id: cuda     }
+          - { name: Fedora,           id: fedora   }
+          - { name: OpenSUSE,         id: opensuse }
+          - { name: Ubuntu Bionic,    id: bionic   }
+    container: mesonbuild/${{ matrix.cfg.id }}:latest
+    env:
+      MESON_CI_JOBNAME: linux-${{ matrix.cfg.id }}-gcc
+
+    steps:
+    - uses: actions/checkout@v3
+    - name: Run tests
+      # All environment variables are stored inside the docker image in /ci/env_vars.sh
+      # They are defined in the `env` section in each image.json. CI_ARGS should be set
+      # via the `args` array ub the image.json
+      run: bash -c 'source /ci/env_vars.sh; cd $GITHUB_WORKSPACE; ./tools/run_with_cov.py ./run_tests.py $CI_ARGS'
+    - name: Upload coverage report
+      run: ./ci/upload_cov.sh "OS Comp ${{ matrix.cfg.name }}"
+
+  pypy:
+    name: 'Arch / PyPy'
+    runs-on: ubuntu-latest
+    container: mesonbuild/arch:latest
+    env:
+      MESON_CI_JOBNAME_UPDATE: linux-arch-gcc-pypy
+
+    steps:
+    - uses: actions/checkout@v3
+    - name: Run tests
+      run: |
+        source /ci/env_vars.sh
+        export MESON_CI_JOBNAME=$MESON_CI_JOBNAME_UPDATE
+        pypy3 run_tests.py
+
+  ubuntu-rolling:
+    name: 'Ubuntu Rolling'
+    runs-on: ubuntu-latest
+
+    strategy:
+      fail-fast: false
+      matrix:
+        cfg:
+          - CC: 'gcc'
+            CXX: 'g++'
+          - MESON_ARGS: '--unity=on -Ddefault_library=static'
+            RUN_TESTS_ARGS: '--no-unittests'
+            CC: 'gcc'
+            CXX: 'g++'
+          - MESON_ARGS: '-Ddefault_library=both'
+            RUN_TESTS_ARGS: '--no-unittests'
+            CC: 'gcc'
+            CXX: 'g++'
+          - CC: 'clang'
+            CXX: 'clang++'
+          - MESON_ARGS: '--unity=on'
+            RUN_TESTS_ARGS: '--no-unittests'
+            CC: 'clang'
+            CXX: 'clang++'
+          - RUN_TESTS_ARGS: '--cross ubuntu-armhf.json --cross linux-mingw-w64-64bit.json'
+            MESON_RSP_THRESHOLD: '0'
+            CC: 'gcc'
+            CXX: 'g++'
+          - RUN_TESTS_ARGS: '--cross ubuntu-armhf.json --cross linux-mingw-w64-64bit.json'
+            MESON_ARGS: '--unity=on'
+            CC: 'gcc'
+            CXX: 'g++'
+
+    env:
+      MESON_CI_JOBNAME_UPDATE: linux-${{ github.job }}-${{ matrix.cfg.CC }}
+
+    container:
+      image: mesonbuild/ubuntu-rolling
+      env:
+        MESON_RSP_THRESHOLD: ${{ matrix.cfg.MESON_RSP_THRESHOLD }}
+        MESON_ARGS: ${{ matrix.cfg.MESON_ARGS }}
+        RUN_TESTS_ARGS: ${{ matrix.cfg.RUN_TESTS_ARGS }}
+        CC: ${{ matrix.cfg.CC }}
+        CXX: ${{ matrix.cfg.CXX }}
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v3
+
+      - name: Run tests
+        shell: bash
+        run: |
+          export HOME=/root
+
+          export CC=$CC
+          export CXX=$CXX
+          export OBJC=$CC
+          export OBJCXX=$CXX
+          export PATH=$(pwd)/tools:$PATH
+          if test "$MESON_RSP_THRESHOLD" != ""
+          then
+            export MESON_RSP_THRESHOLD=$MESON_RSP_THRESHOLD
+          fi
+
+          source /ci/env_vars.sh
+          export MESON_CI_JOBNAME=$MESON_CI_JOBNAME_UPDATE
+
+          update-alternatives --set x86_64-w64-mingw32-gcc /usr/bin/x86_64-w64-mingw32-gcc-posix
+          update-alternatives --set x86_64-w64-mingw32-g++ /usr/bin/x86_64-w64-mingw32-g++-posix
+          update-alternatives --set i686-w64-mingw32-gcc   /usr/bin/i686-w64-mingw32-gcc-posix
+          update-alternatives --set i686-w64-mingw32-g++   /usr/bin/i686-w64-mingw32-g++-posix
+
+          ./tools/run_with_cov.py ./run_tests.py $RUN_TESTS_ARGS -- $MESON_ARGS
+
+      - name: Upload coverage report
+        run: ./ci/upload_cov.sh "Ubuntu ${{ matrix.cfg.CC }} ${{ matrix.cfg.RUN_TESTS_ARGS }} ${{ matrix.cfg.MESON_ARGS }}"

_service:tar_scm:meson-1.0.1.tar.gz/.github/workflows/stable_builddir.yml Added

@@ -0,0 +1,35 @@
+name: stable build directories
+
+on:
+  push:
+    branches:
+      - '0-9+.0-9+'
+
+permissions:
+  contents: read
+
+jobs:
+  regression:
+    runs-on: ubuntu-latest
+    env:
+      TESTDIR: "manual tests/13 builddir upgrade"
+    steps:
+      - uses: actions/checkout@v3
+      - name: install ninja
+        run: sudo apt-get -y install build-essential ninja-build
+      - name: Fetch tags and unshallow
+        run: git fetch --unshallow --tags
+      - name: Checkout latest release on this branch
+        run: |
+          cp -r "$TESTDIR" "$TESTDIR"-temp
+          git checkout "$(git describe --abbrev=0)"
+      - name: Configure with most recent tag
+        run: ./meson.py setup "$TESTDIR"-temp builddir
+      - name: Return to testing commit
+        run: git checkout $GITHUB_SHA
+      - name: check that everything still works
+        run: |
+          ./meson.py compile -C builddir
+          ninja -C builddir test
+          DESTDIR=pkg ninja -C builddir install
+          ./meson.py introspect builddir --all

_service:tar_scm:meson-1.0.1.tar.gz/.github/workflows/unusedargs_missingreturn.yml Added

@@ -0,0 +1,80 @@
+name: UnusedMissingReturn
+# this workflow checks for
+# * unused input arguments
+# * missing return values
+# * strict prototypes
+# some users have default configs that will needlessly fail Meson self-tests due to these syntax.
+env:
+  CFLAGS: "-Werror=unused-parameter -Werror=return-type -Werror=strict-prototypes"
+  CPPFLAGS: "-Werror=unused-parameter -Werror=return-type"
+  FFLAGS: "-fimplicit-none"
+
+concurrency:
+  group: unusedargs-${{ github.head_ref || github.ref }}
+  cancel-in-progress: true
+
+on:
+  push:
+    paths:
+    - ".github/workflows/unusedargs_missingreturn.yml"
+    - "test cases/cmake/**"
+    - "test cases/common/**"
+    - "test cases/fortran/**"
+    - "test cases/linuxlike/**"
+    - "test cases/objc/**"
+    - "test cases/objcpp/**"
+    - "test caes/windows/**"
+
+  pull_request:
+    paths:
+    - ".github/workflows/unusedargs_missingreturn.yml"
+    - "test cases/cmake/**"
+    - "test cases/common/**"
+    - "test cases/fortran/**"
+    - "test cases/linuxlike/**"
+    - "test cases/objc/**"
+    - "test cases/objcpp/**"
+    - "test caes/windows/**"
+
+permissions:
+  contents: read
+
+jobs:
+
+  linux:
+    runs-on: ubuntu-20.04
+    steps:
+    - uses: actions/checkout@v3
+    - uses: actions/setup-python@v4
+      with:
+        python-version: '3.x'
+    - name: Install Compilers
+      run: |
+        sudo apt update -yq
+        sudo apt install -yq --no-install-recommends g++ gfortran ninja-build gobjc gobjc++
+        python -m pip install coverage codecov
+    - run: ./tools/run_with_cov.py run_project_tests.py --only cmake common fortran platform-linux "objective c" "objective c++"
+      env:
+        MESON_CI_JOBNAME: linux-ubuntu-gcc-werror
+    - name: Upload coverage report
+      run: ./ci/upload_cov.sh "UnusedMissingReturn"
+
+  windows:
+    runs-on: windows-latest
+    steps:
+    - uses: actions/checkout@v3
+    - uses: actions/setup-python@v4
+      with:
+        python-version: '3.x'
+
+    - run: pip install ninja pefile coverage codecov
+
+    - run: python ./tools/run_with_cov.py run_project_tests.py --only platform-windows
+      env:
+        CC: gcc
+        CXX: g++
+        FC: gfortran
+        MESON_CI_JOBNAME: msys2-gcc-werror
+
+    - name: Upload coverage report
+      run: ./ci/upload_cov.sh "UnusedMissingReturn Windows"

_service:tar_scm:meson-1.0.1.tar.gz/.github/workflows/website.yml Added

@@ -0,0 +1,74 @@
+name: Update website
+
+concurrency:
+  group: mesonbuild.com
+  # We do NOT want `cancel-in-progress` here since only one website job
+  # should run at a time to avoid upload race conditions.
+
+on:
+  push:
+    branches:
+      - master
+    paths:
+      - docs/**
+  pull_request:
+    paths:
+      - docs/**
+  workflow_dispatch:
+  release:
+    types:
+      - published
+
+permissions:
+  contents: write # for release creation (svenstaro/upload-release-action)
+
+# This job is copy/paster into wrapdb CI, please update it there when doing any
+# change here.
+jobs:
+  update_website:
+    env:
+      HAS_SSH_KEY: ${{ secrets.WEBSITE_PRIV_KEY != '' }}
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v3
+      - name: Install package
+        run: |
+          sudo apt-get -y install python3-pip ninja-build libjson-glib-dev
+          pip install hotdoc chevron strictyaml
+      - name: Setup SSH Keys and known_hosts
+        env:
+          SSH_AUTH_SOCK: /tmp/ssh_agent.sock
+        run: |
+          ssh-agent -a $SSH_AUTH_SOCK > /dev/null
+          ssh-add - <<< "${{ secrets.WEBSITE_PRIV_KEY }}"
+        if: env.HAS_SSH_KEY == 'true'
+      - name: Build website
+        run: |
+          git config --global user.name "github-actions"
+          git config --global user.email "github-actions@github.com"
+          cd docs
+          ../meson.py setup _build
+          ninja -C _build
+          ninja -C _build test
+      - name: Update website
+        env:
+          SSH_AUTH_SOCK: /tmp/ssh_agent.sock
+        run: |
+          cd docs
+          ninja -C _build upload
+        if: env.HAS_SSH_KEY == 'true'
+      - name: Release the current JSON docs
+        uses: svenstaro/upload-release-action@v2
+        with:
+          repo_token: ${{ secrets.GITHUB_TOKEN }}
+          file: docs/_build/reference_manual.json
+          tag: ${{ github.ref }}
+        if: ${{ github.event_name == 'release' }}
+      - name: Release the current man docs
+        uses: svenstaro/upload-release-action@v2
+        with:
+          repo_token: ${{ secrets.GITHUB_TOKEN }}
+          file: docs/_build/meson-reference.3
+          tag: ${{ github.ref }}
+        if: ${{ github.event_name == 'release' }}
+

_service:tar_scm:meson-1.0.1.tar.gz/.mailmap Added

_service:tar_scm:meson-1.0.1.tar.gz/.mypy.ini Added

_service:tar_scm:meson-1.0.1.tar.gz/.pylintrc Added

@@ -0,0 +1,80 @@
+MASTER
+jobs=0
+load-plugins=
+    pylint.extensions.bad_builtin,
+    pylint.extensions.set_membership,
+
+REPORTS
+score=no
+
+MESSAGES CONTROL
+disable=
+    abstract-method,
+    arguments-differ,
+    arguments-renamed,
+    attribute-defined-outside-init,
+    broad-except,
+    cell-var-from-loop,
+    consider-using-f-string,
+    consider-using-with,
+    cyclic-import,
+    deprecated-decorator,
+    duplicate-code,
+    duplicate-value,
+    exec-used,
+    fixme,
+    import-error,
+    import-outside-toplevel,
+    inconsistent-mro,
+    inconsistent-return-statements,
+    invalid-name,
+    invalid-unary-operand-type,
+    line-too-long,
+    method-cache-max-size-none,
+    missing-class-docstring,
+    missing-function-docstring,
+    missing-module-docstring,
+    multiple-imports,
+    multiple-statements,
+    no-else-break,
+    no-else-continue,
+    no-else-raise,
+    no-else-return,
+    no-member,
+    no-name-in-module,
+    no-self-argument,
+    non-parent-init-called,
+    not-an-iterable,
+    not-callable,
+    pointless-string-statement,
+    protected-access,
+    raise-missing-from,
+    redeclared-assigned-name,
+    redefined-argument-from-local,
+    redefined-builtin,
+    redefined-outer-name,
+    subprocess-run-check,
+    super-init-not-called,
+    too-few-public-methods,
+    too-many-ancestors,
+    too-many-arguments,
+    too-many-boolean-expressions,
+    too-many-branches,
+    too-many-instance-attributes,
+    too-many-lines,
+    too-many-locals,
+    too-many-nested-blocks,
+    too-many-public-methods,
+    too-many-return-statements,
+    too-many-statements,
+    typevar-name-incorrect-variance,
+    undefined-loop-variable,
+    unidiomatic-typecheck,
+    unnecessary-dict-index-lookup,
+    unnecessary-lambda-assignment,
+    unsubscriptable-object,
+    unused-argument,
+    unused-variable,
+    useless-super-delegation,
+    wrong-import-order,
+    wrong-import-position,

_service:tar_scm:meson-1.0.1.tar.gz/CODEOWNERS Added

_service:tar_scm:meson-0.63.2.tar.gz/README.md -> _service:tar_scm:meson-1.0.1.tar.gz/README.md Changed

_service:tar_scm:meson-1.0.1.tar.gz/azure-pipelines.yml Added

@@ -0,0 +1,119 @@
+# intel oneapi installation is based on the examples at
+# https://github.com/oneapi-src/oneapi-ci
+#
+# and are copyrighted:
+#
+# SPDX-FileCopyrightText: 2020 Intel Corporation
+# SPDX-License-Identifier: MIT
+#
+# The rest of this file contains the standard Meson project copyright:
+#
+# SPDX-License-Identifer: Apache-2.0
+# Copyright 2022 The Meson development team
+
+
+name: $(BuildID)
+
+trigger:
+  branches:
+    include:
+    - 'master'
+    # Release branches
+    - '0.*'
+  paths:
+    include:
+      - 'mesonbuild'
+      - 'test cases'
+      - 'unittests'
+      - 'azure-pipelines.yml'
+      - 'ci/azure-steps.yml'
+      - 'run_project_tests.py'
+      - 'run_tests.py'
+      - 'run_unittests.py'
+pr:
+  autoCancel: true
+  branches:
+    include:
+    - '*'
+  paths:
+    include:
+      - 'mesonbuild'
+      - 'test cases'
+      - 'unittests'
+      - 'azure-pipelines.yml'
+      - 'ci/azure-steps.yml'
+      - 'run_project_tests.py'
+      - 'run_tests.py'
+      - 'run_unittests.py'
+
+variables:
+  CI: 1
+  SOURCE_VERSION: $(Build.SourceVersion)
+  WINDOWS_HPCKIT_URL: https://registrationcenter-download.intel.com/akdlm/IRC_NAS/18680/w_HPCKit_p_2022.2.0.173_offline.exe
+  WINDOWS_FORTRAN_COMPONENTS: intel.oneapi.win.ifort-compiler
+
+jobs:
+
+- job: vs2019
+  timeoutInMinutes: 120
+  pool:
+    vmImage: windows-2019
+
+  strategy:
+    matrix:
+        vc2019x64ninja:
+          arch: x64
+          compiler: msvc2019
+          backend: ninja
+          ifort: true
+        vc2019x64vs:
+          arch: x64
+          compiler: msvc2019
+          backend: vs2019
+          # mysteriously, several tests fail because vs cannot find
+          # executables such as cmd.exe ???
+          ifort: false
+        vc2019arm64ninjacross:
+          arch: arm64
+          compiler: msvc2019
+          backend: ninja
+          extraargs: --cross arm64cl.txt --cross-only
+          # ifort doesn't support arm64
+          ifort: false
+
+  steps:
+  - task: Cache@2
+    inputs:
+      path: C:\Program Files (x86)\Intel\oneAPI
+      key: '"install" | "$(WINDOWS_HPCKIT_URL)" | "$(WINDOWS_FORTRAN_COMPONENTS)" | "compiler" | ci/intel-scripts/cache_exclude_windows.sh'
+      cacheHitVar: CACHE_RESTORED
+    condition: eq(variables.ifort, 'true')
+  - script: ci/intel-scripts/install_windows.bat $(WINDOWS_HPCKIT_URL) $(WINDOWS_FORTRAN_COMPONENTS)
+    displayName: install ifort
+    condition: and(ne(variables.CACHE_RESTORED, 'true'), eq(variables.ifort, 'true'))
+  - bash: ci/intel-scripts/cache_exclude_windows.sh
+    displayName: exclude unused files from cache
+    condition: and(ne(variables.CACHE_RESTORED, 'true'), eq(variables.ifort, 'true'))
+  - task: UsePythonVersion@0
+    inputs:
+      versionSpec: '3.7'
+      addToPath: true
+      architecture: 'x64'
+  - task: BatchScript@1
+    displayName: insert ifort into environment
+    inputs:
+      filename: ci/intel-scripts/activate_windows.bat
+      arguments: vs2019
+      modifyEnvironment: True
+    condition: eq(variables.ifort, 'true')
+  - task: PowerShell@2
+    inputs:
+      targetType: 'filePath'
+      filePath: .\ci\run.ps1
+    env:
+      MESON_CI_JOBNAME: azure-$(System.JobName)
+  - task: PowerShell@2
+    displayName: Gathering coverage report
+    inputs:
+      targetType: 'filePath'
+      filePath: .\ci\coverage.ps1

_service:tar_scm:meson-1.0.1.tar.gz/ci Added

_service:tar_scm:meson-1.0.1.tar.gz/ci/ciimage Added

_service:tar_scm:meson-1.0.1.tar.gz/ci/ciimage/arch Added

_service:tar_scm:meson-1.0.1.tar.gz/ci/ciimage/arch/image.json Added

_service:tar_scm:meson-1.0.1.tar.gz/ci/ciimage/arch/install.sh Added

@@ -0,0 +1,54 @@
+#!/bin/bash
+
+set -e
+
+source /ci/common.sh
+
+# Inspired by https://github.com/greyltc/docker-archlinux-aur/blob/master/add-aur.sh
+
+pkgs=(
+  python python-pip
+  ninja make git sudo fakeroot autoconf automake patch
+  libelf gcc gcc-fortran gcc-objc vala rust bison flex cython go dlang-dmd
+  mono boost qt5-base gtkmm3 gtest gmock protobuf wxgtk2 gobject-introspection
+  itstool gtk3 java-environment=8 gtk-doc llvm clang sdl2 graphviz
+  doxygen vulkan-validation-layers openssh mercurial gtk-sharp-2 qt5-tools
+  libwmf valgrind cmake netcdf-fortran openmpi nasm gnustep-base gettext
+  python-lxml hotdoc rust-bindgen qt6-base qt6-tools wayland wayland-protocols
+  # cuda
+)
+
+aur_pkgs=(scalapack)
+cleanup_pkgs=(go)
+
+AUR_USER=docker
+PACMAN_OPTS='--needed --noprogressbar --noconfirm'
+
+# Patch config files
+sed -i 's/#Color/Color/g'                            /etc/pacman.conf
+sed -i 's,#MAKEFLAGS="-j2",MAKEFLAGS="-j$(nproc)",g' /etc/makepkg.conf
+sed -i "s,PKGEXT='.pkg.tar.zst',PKGEXT='.pkg.tar',g" /etc/makepkg.conf
+
+# Install packages
+pacman -Syu $PACMAN_OPTS "${pkgs@}"
+install_python_packages
+
+# Setup the user
+useradd -m $AUR_USER
+echo "${AUR_USER}:" | chpasswd -e
+echo "$AUR_USER      ALL = NOPASSWD: ALL" >> /etc/sudoers
+
+# Install yay
+su $AUR_USER -c 'cd; git clone https://aur.archlinux.org/yay.git'
+su $AUR_USER -c 'cd; cd yay; makepkg'
+pushd /home/$AUR_USER/yay/
+pacman -U *.pkg.tar --noprogressbar --noconfirm
+popd
+rm -rf /home/$AUR_USER/yay
+
+# Install yay deps
+su $AUR_USER -c "yay -S $PACMAN_OPTS ${aur_pkgs*}"
+
+# cleanup
+pacman -Rs --noconfirm "${cleanup_pkgs@}"
+su $AUR_USER -c "yes | yay -Scc"

_service:tar_scm:meson-1.0.1.tar.gz/ci/ciimage/bionic Added

_service:tar_scm:meson-1.0.1.tar.gz/ci/ciimage/bionic/image.json Added

_service:tar_scm:meson-1.0.1.tar.gz/ci/ciimage/bionic/install.sh Added

@@ -0,0 +1,85 @@
+#!/bin/bash
+
+set -e
+
+source /ci/common.sh
+
+export DEBIAN_FRONTEND=noninteractive
+export LANG='C.UTF-8'
+export DC=gdc
+
+pkgs=(
+  python3-pip libxml2-dev libxslt1-dev libyaml-dev libjson-glib-dev
+  python3.7 python3.7-dev
+  wget unzip cmake doxygen
+  clang
+  pkg-config-arm-linux-gnueabihf
+  qt4-linguist-tools qt5-default qtbase5-private-dev
+  python-dev
+  libomp-dev
+  llvm lcov
+  ldc
+  libclang-dev
+  libgcrypt20-dev
+  libgpgme-dev
+  libhdf5-dev openssh-server
+  libboost-python-dev libboost-regex-dev
+  libblocksruntime-dev
+  libperl-dev libscalapack-mpi-dev libncurses-dev
+  itstool
+  openjdk-11-jre
+)
+
+boost_pkgs=(atomic chrono date-time filesystem log regex serialization system test thread)
+
+sed -i '/^#\sdeb-src /s/^#//' "/etc/apt/sources.list"
+apt-get -y update
+apt-get -y upgrade
+apt-get -y install eatmydata
+
+# Base stuff
+eatmydata apt-get -y build-dep meson
+
+# Add boost packages
+for i in "${boost_pkgs@}"; do
+  for j in "1.62.0" "1.65.1"; do
+    pkgs+=("libboost-${i}${j}")
+  done
+done
+
+# packages
+eatmydata apt-get -y install "${pkgs@}"
+
+# Actually select the right python version
+update-alternatives --install /usr/bin/python3 python3 /usr/bin/python3.6 1 \
+    --slave /usr/lib/x86_64-linux-gnu/pkgconfig/python3.pc python3.pc /usr/lib/x86_64-linux-gnu/pkgconfig/python-3.6.pc
+update-alternatives --install /usr/bin/python3 python3 /usr/bin/python3.7 2 \
+    --slave /usr/lib/x86_64-linux-gnu/pkgconfig/python3.pc python3.pc /usr/lib/x86_64-linux-gnu/pkgconfig/python-3.7.pc
+
+python3 -m pip install -U "${base_python_pkgs@}" "${python_pkgs@}"
+
+pushd /opt
+# Download and install PyPy3.8, and link it to /usr/bin/pypy3
+# At some point it would be more robust to download and parse
+# https://downloads.python.org/pypy/versions.json
+wget https://downloads.python.org/pypy/pypy3.8-v7.3.9-linux64.tar.bz2
+pypy_sha256="08be25ec82fc5d23b78563eda144923517daba481a90af0ace7a047c9c9a3c34"
+if  $pypy_sha256 != $(sha256sum pypy3.8-v7.3.9-linux64.tar.bz2 | cut -f1 -d" ") ; then
+  echo bad sha256 for PyPy
+  exit -1
+fi
+tar -xf pypy3.8-v7.3.9-linux64.tar.bz2
+pypy3.8-v7.3.9-linux64/bin/pypy3 -m ensurepip
+popd
+ln -s /opt/pypy3.8-v7.3.9-linux64/bin/pypy3 /usr/bin/pypy3
+
+
+# Install the ninja 0.10
+wget https://github.com/ninja-build/ninja/releases/download/v1.10.0/ninja-linux.zip
+unzip ninja-linux.zip -d /ci
+
+# cleanup
+apt-get -y remove ninja-build
+apt-get -y clean
+apt-get -y autoclean
+rm ninja-linux.zip

_service:tar_scm:meson-1.0.1.tar.gz/ci/ciimage/build.py Added

@@ -0,0 +1,241 @@
+#!/usr/bin/env python3
+
+import json
+import argparse
+import stat
+import textwrap
+import shutil
+import subprocess
+from tempfile import TemporaryDirectory
+from pathlib import Path
+import typing as T
+
+image_namespace = 'mesonbuild'
+
+image_def_file = 'image.json'
+install_script = 'install.sh'
+
+class ImageDef:
+    def __init__(self, image_dir: Path) -> None:
+        path = image_dir / image_def_file
+        data = json.loads(path.read_text(encoding='utf-8'))
+
+        assert isinstance(data, dict)
+        assert all(x in data for x in 'base_image', 'env')
+        assert isinstance(data'base_image', str)
+        assert isinstance(data'env',  dict)
+
+        self.base_image: str = data'base_image'
+        self.args: T.Liststr = data.get('args', )
+        self.env: T.Dictstr, str = data'env'
+
+class BuilderBase():
+    def __init__(self, data_dir: Path, temp_dir: Path) -> None:
+        self.data_dir = data_dir
+        self.temp_dir = temp_dir
+
+        self.common_sh = self.data_dir.parent / 'common.sh'
+        self.common_sh = self.common_sh.resolve(strict=True)
+        self.validate_data_dir()
+
+        self.image_def = ImageDef(self.data_dir)
+
+        self.docker = shutil.which('docker')
+        self.git = shutil.which('git')
+        if self.docker is None:
+            raise RuntimeError('Unable to find docker')
+        if self.git is None:
+            raise RuntimeError('Unable to find git')
+
+    def validate_data_dir(self) -> None:
+        files = 
+            self.data_dir / image_def_file,
+            self.data_dir / install_script,
+        
+        if not self.data_dir.exists():
+            raise RuntimeError(f'{self.data_dir.as_posix()} does not exist')
+        for i in files:
+            if not i.exists():
+                raise RuntimeError(f'{i.as_posix()} does not exist')
+            if not i.is_file():
+                raise RuntimeError(f'{i.as_posix()} is not a regular file')
+
+class Builder(BuilderBase):
+    def gen_bashrc(self) -> None:
+        out_file = self.temp_dir / 'env_vars.sh'
+        out_data = ''
+
+        # run_tests.py parameters
+        self.image_def.env'CI_ARGS' = ' '.join(self.image_def.args)
+
+        for key, val in self.image_def.env.items():
+            out_data += f'export {key}="{val}"\n'
+
+        # Also add /ci to PATH
+        out_data += 'export PATH="/ci:$PATH"\n'
+
+        out_file.write_text(out_data, encoding='utf-8')
+
+        # make it executable
+        mode = out_file.stat().st_mode
+        out_file.chmod(mode | stat.S_IEXEC)
+
+    def gen_dockerfile(self) -> None:
+        out_file = self.temp_dir / 'Dockerfile'
+        out_data = textwrap.dedent(f'''\
+            FROM {self.image_def.base_image}
+
+            ADD install.sh  /ci/install.sh
+            ADD common.sh   /ci/common.sh
+            ADD env_vars.sh /ci/env_vars.sh
+            RUN /ci/install.sh
+        ''')
+
+        out_file.write_text(out_data, encoding='utf-8')
+
+    def do_build(self) -> None:
+        # copy files
+        for i in self.data_dir.iterdir():
+            shutil.copy(str(i), str(self.temp_dir))
+        shutil.copy(str(self.common_sh), str(self.temp_dir))
+
+        self.gen_bashrc()
+        self.gen_dockerfile()
+
+        cmd_git = self.git, 'rev-parse', '--short', 'HEAD'
+        res = subprocess.run(cmd_git, cwd=self.data_dir, stdout=subprocess.PIPE)
+        if res.returncode != 0:
+            raise RuntimeError('Failed to get the current commit hash')
+        commit_hash = res.stdout.decode().strip()
+
+        cmd = 
+            self.docker, 'build',
+            '-t', f'{image_namespace}/{self.data_dir.name}:latest',
+            '-t', f'{image_namespace}/{self.data_dir.name}:{commit_hash}',
+            '--pull',
+            self.temp_dir.as_posix(),
+        
+        if subprocess.run(cmd).returncode != 0:
+            raise RuntimeError('Failed to build the docker image')
+
+class ImageTester(BuilderBase):
+    def __init__(self, data_dir: Path, temp_dir: Path, ci_root: Path) -> None:
+        super().__init__(data_dir, temp_dir)
+        self.meson_root = ci_root.parent.parent.resolve()
+
+    def gen_dockerfile(self) -> None:
+        out_file = self.temp_dir / 'Dockerfile'
+        out_data = textwrap.dedent(f'''\
+            FROM {image_namespace}/{self.data_dir.name}
+
+            ADD meson /meson
+        ''')
+
+        out_file.write_text(out_data, encoding='utf-8')
+
+    def copy_meson(self) -> None:
+        shutil.copytree(
+            self.meson_root,
+            self.temp_dir / 'meson',
+            ignore=shutil.ignore_patterns(
+                '.git',
+                '*_cache',
+                '__pycache__',
+                # 'work area',
+                self.temp_dir.name,
+            )
+        )
+
+    def do_test(self, tty: bool = False) -> None:
+        self.copy_meson()
+        self.gen_dockerfile()
+
+        try:
+            build_cmd = 
+                self.docker, 'build',
+                '-t', 'meson_test_image',
+                self.temp_dir.as_posix(),
+            
+            if subprocess.run(build_cmd).returncode != 0:
+                raise RuntimeError('Failed to build the test docker image')
+
+            test_cmd = 
+            if tty:
+                test_cmd = 
+                    self.docker, 'run', '--rm', '-t', '-i', 'meson_test_image',
+                    '/bin/bash', '-c', ''
+                    + 'cd meson;'
+                    + 'source /ci/env_vars.sh;'
+                    + f'echo -e "\\n\\nInteractive test shell in the {image_namespace}/{self.data_dir.name} container with the current meson tree";'
+                    + 'echo -e "The file ci/ciimage/user.sh will be sourced if it exists to enable user specific configurations";'
+                    + 'echo -e "Run the following command to run all CI tests: ./run_tests.py $CI_ARGS\\n\\n";'
+                    + ' -f ci/ciimage/user.sh  && exec /bin/bash --init-file ci/ciimage/user.sh;'
+                    + 'exec /bin/bash;'
+                
+            else:
+                test_cmd = 
+                    self.docker, 'run', '--rm', '-t', 'meson_test_image',
+                    '/bin/bash', '-c', 'source /ci/env_vars.sh; cd meson; ./run_tests.py $CI_ARGS'
+                
+
+            if subprocess.run(test_cmd).returncode != 0 and not tty:
+                raise RuntimeError('Running tests failed')
+        finally:
+            cleanup_cmd = self.docker, 'rmi', '-f', 'meson_test_image'
+            subprocess.run(cleanup_cmd).returncode
+
+class ImageTTY(BuilderBase):
+    def __init__(self, data_dir: Path, temp_dir: Path, ci_root: Path) -> None:
+        super().__init__(data_dir, temp_dir)
+        self.meson_root = ci_root.parent.parent.resolve()
+
+    def do_run(self) -> None:
+        try:
+            tty_cmd = 
+                self.docker, 'run',
+                '--name', 'meson_test_container', '-t', '-i', '-v', f'{self.meson_root.as_posix()}:/meson',
+                f'{image_namespace}/{self.data_dir.name}',
+                '/bin/bash', '-c', ''
+                    + 'cd meson;'
+                    + 'source /ci/env_vars.sh;'
+                    + f'echo -e "\\n\\nInteractive test shell in the {image_namespace}/{self.data_dir.name} container with the current meson tree";'
+                    + 'echo -e "The file ci/ciimage/user.sh will be sourced if it exists to enable user specific configurations";'
+                    + 'echo -e "Run the following command to run all CI tests: ./run_tests.py $CI_ARGS\\n\\n";'
+                    + ' -f ci/ciimage/user.sh  && exec /bin/bash --init-file ci/ciimage/user.sh;'
+                    + 'exec /bin/bash;'
+            
+            subprocess.run(tty_cmd).returncode != 0
+        finally:
+            cleanup_cmd = self.docker, 'rm', '-f', 'meson_test_container'
+            subprocess.run(cleanup_cmd).returncode
+
+
+def main() -> None:
+    parser = argparse.ArgumentParser(description='Meson CI image builder')
+    parser.add_argument('what', type=str, help='Which image to build / test')
+    parser.add_argument('-t', '--type', choices='build', 'test', 'testTTY', 'TTY', help='What to do', required=True)
+
+    args = parser.parse_args()
+
+    ci_root = Path(__file__).parent
+    ci_data = ci_root / args.what
+
+    with TemporaryDirectory(prefix=f'{args.type}_{args.what}_', dir=ci_root) as td:
+        ci_build = Path(td)
+        print(f'Build dir: {ci_build}')
+
+        if args.type == 'build':
+            builder = Builder(ci_data, ci_build)
+            builder.do_build()
+        elif args.type == 'test':
+            tester = ImageTester(ci_data, ci_build, ci_root)
+            tester.do_test()
+        elif args.type == 'testTTY':
+            tester = ImageTester(ci_data, ci_build, ci_root)
+            tester.do_test(tty=True)
+        elif args.type == 'TTY':
+            tester = ImageTTY(ci_data, ci_build, ci_root)
+            tester.do_run()
+
+if __name__ == '__main__':
+    main()

_service:tar_scm:meson-1.0.1.tar.gz/ci/ciimage/common.sh Added

_service:tar_scm:meson-1.0.1.tar.gz/ci/ciimage/cuda Added

_service:tar_scm:meson-1.0.1.tar.gz/ci/ciimage/cuda/image.json Added

_service:tar_scm:meson-1.0.1.tar.gz/ci/ciimage/cuda/install.sh Added

_service:tar_scm:meson-1.0.1.tar.gz/ci/ciimage/fedora Added

_service:tar_scm:meson-1.0.1.tar.gz/ci/ciimage/fedora/image.json Added

_service:tar_scm:meson-1.0.1.tar.gz/ci/ciimage/fedora/install.sh Added

@@ -0,0 +1,29 @@
+#!/bin/bash
+
+set -e
+
+source /ci/common.sh
+
+pkgs=(
+  python python-pip python3-devel
+  ninja-build make git autoconf automake patch
+  elfutils gcc gcc-c++ gcc-fortran gcc-objc gcc-objc++ vala rust bison flex ldc libasan libasan-static
+  mono-core boost-devel gtkmm30 gtest-devel gmock-devel protobuf-devel wxGTK3-devel gobject-introspection
+  boost-python3-devel
+  itstool gtk3-devel java-latest-openjdk-devel gtk-doc llvm-devel clang-devel SDL2-devel graphviz-devel zlib zlib-devel zlib-static
+  #hdf5-openmpi-devel hdf5-devel netcdf-openmpi-devel netcdf-devel netcdf-fortran-openmpi-devel netcdf-fortran-devel scalapack-openmpi-devel
+  doxygen vulkan-devel vulkan-validation-layers-devel openssh mercurial gtk-sharp2-devel libpcap-devel gpgme-devel
+  qt5-qtbase-devel qt5-qttools-devel qt5-linguist qt5-qtbase-private-devel
+  libwmf-devel valgrind cmake openmpi-devel nasm gnustep-base-devel gettext-devel ncurses-devel
+  libxml2-devel libxslt-devel libyaml-devel glib2-devel json-glib-devel libgcrypt-devel wayland-devel wayland-protocols-devel
+)
+
+# Sys update
+dnf -y upgrade
+
+# Install deps
+dnf -y install "${pkgs@}"
+install_python_packages hotdoc
+
+# Cleanup
+dnf -y clean all

_service:tar_scm:meson-1.0.1.tar.gz/ci/ciimage/opensuse Added

_service:tar_scm:meson-1.0.1.tar.gz/ci/ciimage/opensuse/image.json Added

_service:tar_scm:meson-1.0.1.tar.gz/ci/ciimage/opensuse/install.sh Added

@@ -0,0 +1,48 @@
+#!/bin/bash
+
+set -e
+
+source /ci/common.sh
+
+pkgs=(
+  python3-pip python3 python3-devel
+  ninja make git autoconf automake patch libjpeg-devel
+  elfutils gcc gcc-c++ gcc-fortran gcc-objc gcc-obj-c++ vala rust bison flex curl lcov
+  mono-core gtkmm3-devel gtest gmock protobuf-devel wxGTK3-3_2-devel gobject-introspection-devel
+  itstool gtk3-devel java-15-openjdk-devel gtk-doc llvm-devel clang-devel libSDL2-devel graphviz-devel zlib-devel zlib-devel-static
+  #hdf5-devel netcdf-devel libscalapack2-openmpi3-devel libscalapack2-gnu-openmpi3-hpc-devel openmpi3-devel
+  doxygen vulkan-devel vulkan-validationlayers openssh mercurial gtk-sharp3-complete gtk-sharp2-complete libpcap-devel libgpgme-devel
+  libqt5-qtbase-devel libqt5-qttools-devel libqt5-linguist libqt5-qtbase-private-headers-devel
+  libwmf-devel valgrind cmake nasm gnustep-base-devel gettext-tools gettext-runtime gettext-csharp ncurses-devel
+  libxml2-devel libxslt-devel libyaml-devel glib2-devel json-glib-devel
+  boost-devel libboost_date_time-devel libboost_filesystem-devel libboost_locale-devel libboost_system-devel
+  libboost_test-devel libboost_log-devel libboost_regex-devel
+  libboost_python3-devel libboost_regex-devel
+)
+
+# Sys update
+zypper --non-interactive patch --with-update --with-optional
+zypper --non-interactive update
+
+# Install deps
+zypper install -y "${pkgs@}"
+install_python_packages hotdoc
+
+echo 'export PKG_CONFIG_PATH="/usr/lib64/mpi/gcc/openmpi3/lib64/pkgconfig:$PKG_CONFIG_PATH"' >> /ci/env_vars.sh
+
+# dmd is very special on OpenSUSE (as in the packages do not work)
+# see https://bugzilla.opensuse.org/show_bug.cgi?id=1162408
+curl -fsS https://dlang.org/install.sh | bash -s dmd | tee dmd_out.txt
+cat dmd_out.txt | grep source | sed 's/^^`*`//g' | sed 's/`.*//g' >> /ci/env_vars.sh
+chmod +x /ci/env_vars.sh
+
+source /ci/env_vars.sh
+
+dub_fetch urld
+dub build urld --compiler=dmd
+dub_fetch dubtestproject
+dub build dubtestproject:test1 --compiler=dmd
+dub build dubtestproject:test2 --compiler=dmd
+
+# Cleanup
+zypper --non-interactive clean --all

_service:tar_scm:meson-1.0.1.tar.gz/ci/ciimage/ubuntu-rolling Added

_service:tar_scm:meson-1.0.1.tar.gz/ci/ciimage/ubuntu-rolling/image.json Added

_service:tar_scm:meson-1.0.1.tar.gz/ci/ciimage/ubuntu-rolling/install.sh Added

@@ -0,0 +1,55 @@
+#!/bin/bash
+
+set -e
+
+source /ci/common.sh
+
+export DEBIAN_FRONTEND=noninteractive
+export LANG='C.UTF-8'
+export DC=gdc
+
+pkgs=(
+  python3-pip libxml2-dev libxslt1-dev libyaml-dev libjson-glib-dev
+  wget unzip
+  qt5-qmake qtbase5-dev qtchooser qtbase5-dev-tools clang
+  libomp-dev
+  llvm lcov
+  dub ldc
+  mingw-w64 mingw-w64-tools libz-mingw-w64-dev
+  libclang-dev
+  libgcrypt20-dev
+  libgpgme-dev
+  libhdf5-dev
+  libboost-python-dev libboost-regex-dev
+  libblocksruntime-dev
+  libperl-dev
+  liblapack-dev libscalapack-mpi-dev
+  bindgen
+  itstool
+  openjdk-11-jre
+)
+
+sed -i '/^#\sdeb-src /s/^#//' "/etc/apt/sources.list"
+apt-get -y update
+apt-get -y upgrade
+apt-get -y install eatmydata
+
+# Base stuff
+eatmydata apt-get -y build-dep meson
+
+# packages
+eatmydata apt-get -y install "${pkgs@}"
+eatmydata apt-get -y install --no-install-recommends wine-stable  # Wine is special
+
+install_python_packages hotdoc
+
+# dub stuff
+dub_fetch urld
+dub build urld --compiler=gdc
+dub_fetch dubtestproject
+dub build dubtestproject:test1 --compiler=ldc2
+dub build dubtestproject:test2 --compiler=ldc2
+
+# cleanup
+apt-get -y clean
+apt-get -y autoclean

_service:tar_scm:meson-1.0.1.tar.gz/ci/ciimage/ubuntu-rolling/test.sh Added

_service:tar_scm:meson-1.0.1.tar.gz/ci/coverage.ps1 Added

_service:tar_scm:meson-1.0.1.tar.gz/ci/intel-scripts Added

_service:tar_scm:meson-1.0.1.tar.gz/ci/intel-scripts/activate_windows.bat Added

_service:tar_scm:meson-1.0.1.tar.gz/ci/intel-scripts/cache_exclude_windows.sh Added

_service:tar_scm:meson-1.0.1.tar.gz/ci/intel-scripts/install_windows.bat Added

_service:tar_scm:meson-1.0.1.tar.gz/ci/run.ps1 Added

@@ -0,0 +1,101 @@
+python ./skip_ci.py --base-branch-env=SYSTEM_PULLREQUEST_TARGETBRANCH --is-pull-env=SYSTEM_PULLREQUEST_PULLREQUESTID --base-branch-origin
+if ($LastExitCode -ne 0) {
+  exit 0
+}
+
+# remove Chocolately, MinGW, Strawberry Perl from path, so we don't find gcc/gfortran and try to use it
+# remove PostgreSQL from path so we don't pickup a broken zlib from it
+$env:Path = ($env:Path.Split(';') | Where-Object { $_ -notmatch 'mingw|Strawberry|Chocolatey|PostgreSQL' }) -join ';'
+
+if ($env:arch -eq 'x64') {
+    # Rust puts its shared stdlib in a secret place, but it is needed to run tests.
+    $env:Path += ";$HOME/.rustup/toolchains/stable-x86_64-pc-windows-msvc/bin"
+} elseif ($env:arch -eq 'x86') {
+    # Switch to the x86 Rust toolchain
+    rustup default stable-i686-pc-windows-msvc
+
+    # Also install clippy
+    rustup component add clippy
+
+    # Rust puts its shared stdlib in a secret place, but it is needed to run tests.
+    $env:Path += ";$HOME/.rustup/toolchains/stable-i686-pc-windows-msvc/bin"
+    # Need 32-bit Python for tests that need the Python dependency
+    $env:Path = "C:\hostedtoolcache\windows\Python\3.7.9\x86;C:\hostedtoolcache\windows\Python\3.7.9\x86\Scripts;$env:Path"
+}
+
+# Set the CI env var for the meson test framework
+$env:CI = '1'
+
+# download and install prerequisites
+function DownloadFile(String $Source, String $Destination) {
+  $retries = 10
+  echo "Downloading $Source"
+  for ($i = 1; $i -le $retries; $i++) {
+      try {
+          (New-Object net.webclient).DownloadFile($Source, $Destination)
+          break # succeeded
+      } catch net.WebException {
+          if ($i -eq $retries) {
+              throw # fail on last retry
+          }
+          $backoff = (10 * $i) # backoff 10s, 20s, 30s...
+          echo ('{0}: {1}' -f $Source, $_.Exception.Message)
+          echo ('Retrying in {0}s...' -f $backoff)
+          Start-Sleep -m ($backoff * 1000)
+        }
+    }
+}
+
+
+if (($env:backend -eq 'ninja') -and ($env:arch -ne 'arm64')) { $dmd = $true } else { $dmd = $false }
+
+DownloadFile -Source https://github.com/mesonbuild/cidata/releases/download/ci3/ci_data.zip -Destination $env:AGENT_WORKFOLDER\ci_data.zip
+echo "Extracting ci_data.zip"
+Expand-Archive $env:AGENT_WORKFOLDER\ci_data.zip -DestinationPath $env:AGENT_WORKFOLDER\ci_data
+& "$env:AGENT_WORKFOLDER\ci_data\install.ps1" -Arch $env:arch -Compiler $env:compiler -Boost $true -DMD $dmd
+
+if ($env:arch -eq 'x64') {
+    DownloadFile -Source https://downloads.python.org/pypy/pypy3.8-v7.3.9-win64.zip -Destination $env:AGENT_WORKFOLDER\pypy38.zip
+    Expand-Archive $env:AGENT_WORKFOLDER\pypy38.zip -DestinationPath $env:AGENT_WORKFOLDER\pypy38
+    $ENV:Path = $ENV:Path + ";$ENV:AGENT_WORKFOLDER\pypy38\pypy3.8-v7.3.9-win64;$ENV:AGENT_WORKFOLDER\pypy38\pypy3.8-v7.3.9-win64\Scripts"
+    pypy3 -m ensurepip
+}
+
+
+echo "=== PATH BEGIN ==="
+echo ($env:Path).Replace(';',"`n")
+echo "=== PATH END ==="
+echo ""
+
+$progs = @("python","ninja","pkg-config","cl","rc","link","pypy3","ifort")
+foreach ($prog in $progs) {
+  echo ""
+  echo "Locating ${prog}:"
+  where.exe $prog
+}
+
+
+echo ""
+echo "Ninja / MSBuld version:"
+if ($env:backend -eq 'ninja') {
+  ninja --version
+} else {
+  MSBuild /version
+}
+
+echo ""
+echo "Python version:"
+python --version
+
+# Needed for running unit tests in parallel.
+echo ""
+python -m pip --disable-pip-version-check install --upgrade pefile pytest-xdist pytest-subtests jsonschema coverage
+
+echo ""
+echo "=== Start running tests ==="
+# Starting from VS2019 Powershell(?) will fail the test run
+# if it prints anything to stderr. Python's test runner
+# does that by default so we need to forward it.
+cmd /c "python 2>&1 ./tools/run_with_cov.py  run_tests.py --backend $env:backend $env:extraargs"
+
+exit $LastExitCode

_service:tar_scm:meson-1.0.1.tar.gz/ci/upload_cov.sh Added

_service:tar_scm:meson-1.0.1.tar.gz/ci/usercustomize.py Added

_service:tar_scm:meson-0.63.2.tar.gz/cross/wasm.txt -> _service:tar_scm:meson-1.0.1.tar.gz/cross/wasm.txt Changed

_service:tar_scm:meson-0.63.2.tar.gz/data/macros.meson -> _service:tar_scm:meson-1.0.1.tar.gz/data/macros.meson Changed

_service:tar_scm:meson-0.63.2.tar.gz/data/shell-completions/bash/meson -> _service:tar_scm:meson-1.0.1.tar.gz/data/shell-completions/bash/meson Changed

@@ -1,21 +1,27 @@
 _meson() {
   command="${COMP_WORDS1}"
-  case "$command" in
-    setup |\
-    configure |\
-    install |\
-    introspect |\
-    init |\
-    test |\
-    wrap |\
-    subprojects |\
-    help)
+  meson_subcommands=(
+      setup
+      configure
+      dist
+      install
+      introspect
+      init
+      test
+      wrap
+      subprojects
+      help
+      rewrite
+      compile
+      devenv
+      env2mfile
+  )
+
+  if  " ${meson_subcommands*} " =~ " ${command} " ; then
       _meson-$command "${COMP_WORDS@:1}"
-      ;;
-    *)
+  else
       _meson-setup "${COMP_WORDS@}"
-      ;;
-  esac
+  fi
 } &&
 complete -F _meson meson
 
@@ -192,7 +198,7 @@
     fi
 
     if  $COMP_CWORD -eq 1 ; then
-      COMPREPLY+=($(compgen -W 'setup configure test introspect' -- "$cur"))
+      COMPREPLY+=($(compgen -W "${meson_subcommands*}" -- "$cur"))
     fi
   fi
 }
@@ -242,6 +248,96 @@
   fi
 }
 
+_meson-dist() {
+  : TODO
+}
+
+_meson-install() {
+  : TODO
+}
+
+_meson-introspect() {
+  shortopts=(
+    h
+  )
+
+  longopts=(
+    targets
+    installed
+    buildsystem-files
+    buildoptions
+    tests
+    benchmarks
+    dependencies
+    projectinfo
+  )
+
+  local cur prev
+  if ! _get_comp_words_by_ref cur prev &>/dev/null; then
+    cur="${COMP_WORDSCOMP_CWORD}"
+  fi
+
+  if  "$cur" == "--"* ; then
+    COMPREPLY+=($(compgen -P '--' -W '${longopts*}' -- "${cur:2}"))
+  elif  "$cur" == "-"* ; then
+    COMPREPLY+=($(compgen -P '--' -W '${longopts*}' -- "${cur:2}"))
+    COMPREPLY+=($(compgen -P '-' -W '${shortopts*}' -- "${cur:1}"))
+  else
+    for dir in "${COMP_WORDS@}"; do
+      if  -d "$dir" ; then
+        break
+      fi
+      dir=.
+    done
+    if  ! -d "$dir/meson-private" ; then
+      _filedir -d
+    fi
+
+    if  -z "$cur" ; then
+      COMPREPLY+=($(compgen -P '--' -W '${longopts*}'))
+      COMPREPLY+=($(compgen -P '-' -W '${shortopts*}'))
+    fi
+  fi
+}
+
+_meson-init() {
+  shortopts=(
+    h
+    C
+    n
+    e
+    e
+    d
+    l
+    b
+    f
+  )
+
+  longopts=(
+    help
+	name
+	executable
+	deps
+	language
+	builddir
+	force
+	type
+	version
+  )
+
+  if  "$cur" == "--"* ; then
+    COMPREPLY+=($(compgen -P '--' -W '${longopts*}' -- "${cur:2}"))
+  elif  "$cur" == "-"* && ${#cur} -gt 1 ; then
+    COMPREPLY+=($(compgen -P '-' -W '${shortopts*}' -- "${cur:1}"))
+  else
+    if  -z "$cur" ; then
+      COMPREPLY+=($(compgen -P '--' -W '${longopts*}'))
+      COMPREPLY+=($(compgen -P '-' -W '${shortopts*}'))
+    fi
+  fi
+
+}
+
 _meson-test() {
   shortopts=(
     q
@@ -367,50 +463,30 @@
   fi
 }
 
-_meson-introspect() {
-  shortopts=(
-    h
-  )
+_meson-wrap() {
+  : TODO
+}
 
-  longopts=(
-    targets
-    installed
-    buildsystem-files
-    buildoptions
-    tests
-    benchmarks
-    dependencies
-    projectinfo
-  )
+_meson-subprojects() {
+  : TODO
+}
 
-  local cur prev
-  if ! _get_comp_words_by_ref cur prev &>/dev/null; then
-    cur="${COMP_WORDSCOMP_CWORD}"
-  fi
+_meson-help() {
+  : # Nothing to do
+}
 
-  if  "$cur" == "--"* ; then
-    COMPREPLY+=($(compgen -P '--' -W '${longopts*}' -- "${cur:2}"))
-  elif  "$cur" == "-"* ; then
-    COMPREPLY+=($(compgen -P '--' -W '${longopts*}' -- "${cur:2}"))
-    COMPREPLY+=($(compgen -P '-' -W '${shortopts*}' -- "${cur:1}"))
-  else
-    for dir in "${COMP_WORDS@}"; do
-      if  -d "$dir" ; then
-        break
-      fi
-      dir=.
-    done
-    if  ! -d "$dir/meson-private" ; then
-      _filedir -d
-    fi
+_meson-rewrite() {
+  : TODO
+}
 
-    if  -z "$cur" ; then
-      COMPREPLY+=($(compgen -P '--' -W '${longopts*}'))
-      COMPREPLY+=($(compgen -P '-' -W '${shortopts*}'))
-    fi
-  fi
+_meson-compile() {
+  : TODO
 }
 
-_meson-wrap() {
+_meson-devenv() {
+  : TODO
+}
+
+_meson-env2mfile() {
   : TODO
 }

_service:tar_scm:meson-1.0.1.tar.gz/docs Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/.editorconfig Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/README.md Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/extensions Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/extensions/refman_links.py Added

@@ -0,0 +1,111 @@
+from pathlib import Path
+from json import loads
+import re
+
+from hotdoc.core.exceptions import HotdocSourceException
+from hotdoc.core.extension import Extension
+from hotdoc.core.tree import Page
+from hotdoc.core.project import Project
+from hotdoc.run_hotdoc import Application
+from hotdoc.core.formatter import Formatter
+from hotdoc.utils.loggable import Logger, warn, info
+
+import typing as T
+
+if T.TYPE_CHECKING:
+    import argparse
+
+Logger.register_warning_code('unknown-refman-link', HotdocSourceException, 'refman-links')
+
+class RefmanLinksExtension(Extension):
+    extension_name = 'refman-links'
+    argument_prefix = 'refman'
+
+    def __init__(self, app: Application, project: Project):
+        self.project: Project
+        super().__init__(app, project)
+        self._data_file: T.OptionalPath = None
+        self._data: T.Dictstr, str = {}
+
+    @staticmethod
+    def add_arguments(parser: 'argparse.ArgumentParser'):
+        group = parser.add_argument_group(
+            'Refman links',
+            'Custom Meson extension',
+        )
+
+        # Add Arguments with `group.add_argument(...)`
+        group.add_argument(
+            f'--refman-data-file',
+            help="JSON file with the mappings to replace",
+            default=None,
+        )
+
+    def parse_config(self, config: T.Dictstr, T.Any) -> None:
+        super().parse_config(config)
+        self._data_file = config.get('refman_data_file')
+
+    def _formatting_page_cb(self, formatter: Formatter, page: Page) -> None:
+        ''' Replace Meson refman tags
+
+        Links of the form function are automatically replaced
+        with valid links to the correct URL. To reference objects / types use the
+        @object syntax.
+        '''
+        link_regex = re.compile(r'(\\#?@?( \n\t*a-zA-Z0-9_+ \n\t*\.)* \n\t*a-zA-Z0-9_+ \n\t*\\)(.)?', re.MULTILINE)
+        for m in link_regex.finditer(page.formatted_contents):
+            i = m.group(1)
+            obj_id: str = i2:-2
+            obj_id = re.sub(r' \n\t', '', obj_id)  # Remove whitespaces
+
+            # Marked as inside a code block?
+            in_code_block = False
+            if obj_id.startswith('#'):
+                in_code_block = True
+                obj_id = obj_id1:
+
+            if obj_id not in self._data:
+                warn('unknown-refman-link', f'{Path(page.name).name}: Unknown Meson refman link: "{obj_id}"')
+                continue
+
+            # Just replaces !file.id paths with the page file (no fancy HTML)
+            if obj_id.startswith('!'):
+                page.formatted_contents = page.formatted_contents.replace(i, self._dataobj_id)
+                continue
+
+            # Fancy links for functions and methods
+            text = obj_id
+            if text.startswith('@'):
+                text = text1:
+            elif in_code_block:
+                if m.group(3) != '(':
+                    text = text + '()'
+            else:
+                text = text + '()'
+            if not in_code_block:
+                text = f'<code>{text}</code>'
+            link = f'<a href="{self._dataobj_id}"><ins>{text}</ins></a>'
+            page.formatted_contents = page.formatted_contents.replace(i, link, 1)
+
+    def setup(self) -> None:
+        super().setup()
+
+        if not self._data_file:
+            info('Meson refman extension DISABLED')
+            return
+
+        raw = Path(self._data_file).read_text(encoding='utf-8')
+        self._data = loads(raw)
+
+        # Register formatter
+        for ext in self.project.extensions.values():
+            ext = T.cast(Extension, ext)
+            ext.formatter.formatting_page_signal.connect(self._formatting_page_cb)
+        info('Meson refman extension LOADED')
+
+    @staticmethod
+    def get_dependencies() -> T.ListT.TypeExtension:
+        return   # In case this extension has dependencies on other extensions
+
+def get_extension_classes() -> T.ListT.TypeExtension:
+    return RefmanLinksExtension

_service:tar_scm:meson-1.0.1.tar.gz/docs/genrefman.py Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/genrelnotes.py Added

@@ -0,0 +1,105 @@
+#!/usr/bin/env python3
+
+# 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.
+'''
+  Generates release notes for new releases of Meson build system
+'''
+import argparse
+import subprocess
+import re
+import shutil
+import datetime
+from pathlib import Path
+
+RELNOTE_TEMPLATE = '''---
+title: Release {}
+short-description: Release notes for {}
+...
+
+# New features{}
+
+'''
+
+
+def add_to_sitemap(sitemap, output_sitemap):
+    '''
+       Adds release note entry to sitemap.txt.
+    '''
+    sitemapfile = Path(sitemap)
+    with sitemapfile.open(encoding='utf-8') as s_f:
+        lines = s_f.readlines()
+    relnotes = None
+    to_version = None
+    output = Path(output_sitemap)
+    output.parent.mkdir(exist_ok=True, parents=True)
+    with output.open('w', encoding='utf-8') as s_f:
+        for line in lines:
+            if relnotes is None:
+                m = re.match(r'\s*Release-notes-for-(0-9+)\.(0-9+)\.(0-9+)\.md', line)
+                if m:
+                    from_version = f'{m1}.{m2}.{m3}'
+                    if from_version == '0.64.0':
+                        to_version = '1.0.0'
+                    else:
+                        to_version = f'{m1}.{int(m2) + 1}.{m3}'
+                    new_line = line.replace(from_version, to_version)
+                    relnotes = new_line.strip()
+                    s_f.write(new_line)
+            s_f.write(line)
+
+    if sitemapfile == output:
+        subprocess.check_call('git', 'add', output)
+
+    return relnotes, to_version
+
+def generate(relnotes, to_version, source_dir, output_dir):
+    '''
+       Generate notes for Meson build next release.
+    '''
+    title_suffix = ' (in development)' if output_dir else ''
+    title = f'{to_version}{title_suffix}'
+    output = Path(output_dir, relnotes) if output_dir else Path('markdown', relnotes)
+    output.parent.mkdir(exist_ok=True, parents=True)
+    with output.open('w', encoding='utf-8') as ofile:
+        ofile.write(RELNOTE_TEMPLATE.format(title, to_version, title_suffix))
+        if not output_dir:
+            date = datetime.date.today()
+            date_str = date.strftime("%d %B %Y")
+            ofile.write(f'Meson {to_version} was released on {date_str}\n')
+        for snippetfile in sorted(Path(source_dir, 'markdown/snippets').glob('*.md')):
+            snippet = snippetfile.read_text(encoding='utf-8')
+            ofile.write(snippet)
+            if not snippet.endswith('\n'):
+                ofile.write('\n')
+            ofile.write('\n')
+
+    if not output_dir:
+        subprocess.check_call('git', 'rm', 'markdown/snippets/*.md')
+        subprocess.check_call('git', 'add', output)
+
+if __name__ == '__main__':
+    parser = argparse.ArgumentParser(description='Generate meson docs')
+    parser.add_argument('--input-sitemap', default='sitemap.txt')
+    parser.add_argument('--output-sitemap', default='sitemap.txt')
+    parser.add_argument('--source-dir', default='.')
+    parser.add_argument('--output-dir')
+
+    args = parser.parse_args()
+
+    if Path(args.source_dir, 'markdown/snippets').glob('*.md'):
+        relnotes, to_version = add_to_sitemap(args.input_sitemap, args.output_sitemap)
+        generate(relnotes, to_version, args.source_dir, args.output_dir)
+    elif args.input_sitemap != args.output_sitemap:
+        shutil.copyfile(args.input_sitemap, args.output_sitemap)

_service:tar_scm:meson-1.0.1.tar.gz/docs/jsonvalidator.py Added

@@ -0,0 +1,196 @@
+#!/usr/bin/env python3
+
+# SPDX-License-Identifer: Apache-2.0
+# Copyright 2021 The Meson development team
+
+import argparse
+import json
+from pathlib import Path
+from copy import deepcopy
+
+import typing as T
+
+T_None = type(None)
+
+# Global root object
+root: dict
+
+def assert_has_typed_keys(path: str, data: dict, keys: T.Dictstr, T.Any) -> dict:
+    assert set(data.keys()).issuperset(keys.keys()), f'{path}: DIFF: {set(data.keys()).difference(keys.keys())}'
+    res = dict()
+    for key, val in keys.items():
+        cur = data.pop(key)
+        assert isinstance(cur, val), f'{path}: type({key}: {cur}) != {val}'
+        reskey = cur
+    return res
+
+def validate_base_obj(path: str, name: str, obj: dict) -> None:
+    expected: T.Dictstr, T.Any = {
+        'name': str,
+        'description': str,
+        'since': (str, T_None),
+        'deprecated': (str, T_None),
+        'notes': list,
+        'warnings': list,
+    }
+    cur = assert_has_typed_keys(f'{path}.{name}', obj, expected)
+    assert cur'name',                                            f'{path}.{name}'
+    assert cur'description',                                     f'{path}.{name}'
+    assert cur'name' == name,                                    f'{path}.{name}'
+    assert all(isinstance(x, str) and x for x in cur'notes'),    f'{path}.{name}'
+    assert all(isinstance(x, str) and x for x in cur'warnings'), f'{path}.{name}'
+
+def validate_type(path: str, typ: dict) -> None:
+    expected: T.Dictstr, T.Any = {
+        'obj': str,
+        'holds': list,
+    }
+    cur = assert_has_typed_keys(path, typ, expected)
+    assert not typ, f'{path} has extra keys: {typ.keys()}'
+    assert cur'obj' in root'objects', path
+    for i in cur'holds':
+        validate_type(path, i)
+
+def validate_arg(path: str, name: str, arg: dict) -> None:
+    validate_base_obj(path, name, arg)
+    expected: T.Dictstr, T.Any = {
+        'type': list,
+        'type_str': str,
+        'required': bool,
+        'default': (str, T_None),
+        'min_varargs': (int, T_None),
+        'max_varargs': (int, T_None),
+    }
+    cur = assert_has_typed_keys(f'{path}.{name}', arg, expected)
+    assert not arg, f'{path}.{name} has extra keys: {arg.keys()}'
+    assert cur'type', f'{path}.{name}'
+    assert cur'type_str', f'{path}.{name}'
+    for i in cur'type':
+        validate_type(f'{path}.{name}', i)
+    if cur'min_varargs' is not None:
+        assert cur'min_varargs' > 0, f'{path}.{name}'
+    if cur'max_varargs' is not None:
+        assert cur'max_varargs' > 0, f'{path}.{name}'
+
+def validate_function(path: str, name: str, func: dict) -> None:
+    validate_base_obj(path, name, func)
+    expected: T.Dictstr, T.Any = {
+        'returns': list,
+        'returns_str': str,
+        'example': (str, T_None),
+        'posargs': dict,
+        'optargs': dict,
+        'kwargs': dict,
+        'varargs': (dict, T_None),
+        'arg_flattening': bool,
+    }
+    cur = assert_has_typed_keys(f'{path}.{name}', func, expected)
+    assert not func, f'{path}.{name} has extra keys: {func.keys()}'
+    assert cur'returns', f'{path}.{name}'
+    assert cur'returns_str', f'{path}.{name}'
+    for i in cur'returns':
+        validate_type(f'{path}.{name}', i)
+    for k, v in cur'posargs'.items():
+        validate_arg(f'{path}.{name}', k, v)
+    for k, v in cur'optargs'.items():
+        validate_arg(f'{path}.{name}', k, v)
+    for k, v in cur'kwargs'.items():
+        validate_arg(f'{path}.{name}', k, v)
+    if cur'varargs':
+        validate_arg(f'{path}.{name}', cur'varargs''name', cur'varargs')
+
+def validate_object(path: str, name: str, obj: dict) -> None:
+    validate_base_obj(path, name, obj)
+    expected: T.Dictstr, T.Any = {
+        'example': (str, T_None),
+        'object_type': str,
+        'methods': dict,
+        'is_container': bool,
+        'extends': (str, T_None),
+        'returned_by': list,
+        'extended_by': list,
+        'defined_by_module': (str, T_None),
+    }
+    cur = assert_has_typed_keys(f'{path}.{name}', obj, expected)
+    assert not obj, f'{path}.{name} has extra keys: {obj.keys()}'
+    for key, val in cur'methods'.items():
+        validate_function(f'{path}.{name}', key, val)
+    if cur'extends' is not None:
+        assert cur'extends' in root'objects', f'{path}.{name}'
+    assert all(isinstance(x, str) for x in cur'returned_by'), f'{path}.{name}'
+    assert all(isinstance(x, str) for x in cur'extended_by'), f'{path}.{name}'
+    assert all(x in root'objects' for x in cur'extended_by'), f'{path}.{name}'
+    if cur'defined_by_module' is not None:
+        assert cur'defined_by_module' in root'objects', f'{path}.{name}'
+        assert cur'object_type' == 'RETURNED', f'{path}.{name}'
+        assert root'objects'cur'defined_by_module''object_type' == 'MODULE', f'{path}.{name}'
+        assert name in root'objects_by_type''modules'cur'defined_by_module', f'{path}.{name}'
+        return
+    assert cur'object_type' in {'ELEMENTARY', 'BUILTIN', 'MODULE', 'RETURNED'}, f'{path}.{name}'
+    if cur'object_type' == 'ELEMENTARY':
+        assert name in root'objects_by_type''elementary', f'{path}.{name}'
+    if cur'object_type' == 'BUILTIN':
+        assert name in root'objects_by_type''builtins', f'{path}.{name}'
+    if cur'object_type' == 'RETURNED':
+        assert name in root'objects_by_type''returned', f'{path}.{name}'
+    if cur'object_type' == 'MODULE':
+        assert name in root'objects_by_type''modules', f'{path}.{name}'
+
+def main() -> int:
+    global root
+
+    parser = argparse.ArgumentParser(description='Meson JSON docs validator')
+    parser.add_argument('doc_file', type=Path, help='The JSON docs to validate')
+    args = parser.parse_args()
+
+    root_tmp = json.loads(args.doc_file.read_text(encoding='utf-8'))
+    root = deepcopy(root_tmp)
+    assert isinstance(root, dict)
+
+    expected: T.Dictstr, T.Any = {
+        'version_major': int,
+        'version_minor': int,
+        'meson_version': str,
+        'functions': dict,
+        'objects': dict,
+        'objects_by_type': dict,
+    }
+    cur = assert_has_typed_keys('root', root_tmp, expected)
+    assert not root_tmp, f'root has extra keys: {root_tmp.keys()}'
+
+    refs = cur'objects_by_type'
+    expected = {
+        'elementary': list,
+        'builtins': list,
+        'returned': list,
+        'modules': dict,
+    }
+    assert_has_typed_keys(f'root.objects_by_type', refs, expected)
+    assert not refs, f'root.objects_by_type has extra keys: {refs.keys()}'
+    assert all(isinstance(x, str) for x in root'objects_by_type''elementary')
+    assert all(isinstance(x, str) for x in root'objects_by_type''builtins')
+    assert all(isinstance(x, str) for x in root'objects_by_type''returned')
+    assert all(isinstance(x, str) for x in root'objects_by_type''modules')
+    assert all(x in root'objects' for x in root'objects_by_type''elementary')
+    assert all(x in root'objects' for x in root'objects_by_type''builtins')
+    assert all(x in root'objects' for x in root'objects_by_type''returned')
+    assert all(x in root'objects' for x in root'objects_by_type''modules')
+    assert all(root'objects'x'object_type' == 'ELEMENTARY' for x in root'objects_by_type''elementary')
+    assert all(root'objects'x'object_type' == 'BUILTIN'    for x in root'objects_by_type''builtins')
+    assert all(root'objects'x'object_type' == 'RETURNED'   for x in root'objects_by_type''returned')
+    assert all(root'objects'x'object_type' == 'MODULE'     for x in root'objects_by_type''modules')
+
+    # Check that module references are correct
+    assert all(all(isinstance(x, str)                           for x in v) for k, v in root'objects_by_type''modules'.items())
+    assert all(all(x in root'objects'                         for x in v) for k, v in root'objects_by_type''modules'.items())
+    assert all(all(root'objects'x'defined_by_module' == k for x in v) for k, v in root'objects_by_type''modules'.items())
+
+    for key, val in cur'functions'.items():
+        validate_function('root', key, val)
+    for key, val in cur'objects'.items():
+        validate_object('root', key, val)
+
+    return 0
+
+if __name__ == '__main__':
+    raise SystemExit(main())

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/ARM-performance-test.md Added

@@ -0,0 +1,81 @@
+# Arm performance test
+
+Performance differences in build systems become more apparent on
+slower platforms. To examine this difference we compared the
+performance of Meson with GNU Autotools. We took the GLib software
+project and rewrote its build setup with Meson. GLib was chosen
+because it is a relatively large C code base which requires lots of
+low level configuration.
+
+The Meson version of the build system is not fully equivalent to the
+original Autotools one. It does not do all the same configuration
+steps and does not build all the same targets. The biggest missing
+piece being internationalisation support with Gettext. However it does
+configure the system enough to build all C source and run all unit
+tests.
+
+All measurements were done on a Nexus 4 smart phone running the latest
+Ubuntu touch image (updated on September 9th 2013).
+
+Measurements
+------
+
+The first thing we measured was the time it took to run the configure step.
+
+!GLib config time(images/glib_conf.png)
+
+Meson takes roughly 20 seconds whereas Autotools takes 220. This is a
+difference of one order of magnitude. Autotools' time contains both
+autogen and configure. Again it should be remembered that Meson does
+not do all the configure steps that Autotools does. It does do about
+90% of them and it takes just 10% of the time to do it.
+
+Then we measured the build times. Two parallel compilation processes
+were used for both systems.
+
+!GLib build time(images/glib_build.png)
+
+On desktop machines Ninja based build systems are 10-20% faster than
+Make based ones. On this platform the difference grows to 50%. The
+difference is probably caused by Make's inefficient disk access
+patterns. Ninja is better at keeping both cores running all the time
+which yields impressive performance improvements.
+
+!GLib no-op time(images/glib_empty.png)
+
+Next we measured the "empty build" case. That is, how long does it
+take for the build system to detect that no changes need to be
+made. This is one of the most important metrics of build systems
+because it places a hard limit on how fast you can iterate on your
+code. Autotools takes 14 seconds to determine that no work needs to be
+done. Meson (or, rather, Ninja) takes just one quarter of a second.
+
+!GLib link time(images/glib_link.png)
+
+One step which takes quite a lot of time is linking. A common case is
+that you are working on a library and there are tens of small test
+executables that link to it. Even if the compilation step would be
+fast, relinking all of the test executables takes time. It is common
+for people to manually compile only one test application with a
+command such as `make sometest` rather than rebuild everything.
+
+Meson has an optimization for this case. Whenever a library is
+rebuilt, Meson inspects the ABI it exports. If it has not changed,
+Meson will skip all relinking steps as unnecessary. The difference
+this makes can be clearly seen in the chart above. In that test the
+source was fully built, then the file `glib/gbytes.c` was touched to
+force the rebuild of the base glib shared library. As can be seen,
+Autotools then relinks all test executables that link with glib. Since
+Meson can detect that the ABI is the same it can skip those steps. The
+end result being that Meson is almost one hundred times faster on this
+very common use case.
+
+Conclusions
+-----
+
+One of the main drawbacks of C and C++ compared to languages such as
+Java are long compilation times. However at least some of the blame
+can be found in the build tools used rather than the languages
+themselves or their compilers. Choosing proper tools can bring C and
+C++ compilation very close to instantaneous rebuilds. This has a
+direct impact on programmer productivity.

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/Adding-arguments.md Added

@@ -0,0 +1,72 @@
+---
+short-description: Adding compiler arguments
+...
+
+# Adding arguments
+
+Often you need to specify extra compiler arguments. Meson provides two
+different ways to achieve this: global arguments and per-target
+arguments.
+
+Global arguments
+--
+
+Global compiler arguments are set with the following command. As an
+example you could do this.
+
+```meson
+add_global_arguments('-DFOO=bar', language : 'c')
+```
+
+This makes Meson add the define to all C compilations. Usually you
+would use this setting for flags for global settings. Note that for
+setting the C/C++ language standard (the `-std=c99` argument in GCC),
+you would probably want to use a default option of the project
+function. For details see the reference manual(Reference-manual.md).
+
+Global arguments have certain limitations. They all have to be defined
+before any build targets are specified. This ensures that the global
+flags are the same for every single source file built in the entire
+project with one exception. Compilation tests that are run as part of
+your project configuration do not use these flags. The reason for that
+is that you may need to run a test compile with and without a given
+flag to determine your build setup. For this reason tests do not use
+these global arguments.
+
+You should set only the most essential flags with this setting, you
+should *not* set debug or optimization flags. Instead they should be
+specified by selecting an appropriate build type.
+
+Project arguments
+--
+
+Project arguments work similar to global arguments except that they
+are valid only within the current subproject. The usage is simple:
+
+```meson
+add_project_arguments('-DMYPROJ=projname', language : 'c')
+```
+
+This would add the compiler flags to all C sources in the current
+project.
+
+Per target arguments
+--
+
+Per target arguments are just as simple to define.
+
+```meson
+executable('prog', 'prog.cc', cpp_args : '-DCPPTHING')
+```
+
+Here we create a C++ executable with an extra argument that is used
+during compilation but not for linking.
+
+You can find the parameter name for other languages in the reference
+tables(Reference-tables.md).
+
+Specifying extra linker arguments is done in the same way:
+
+```meson
+executable('prog', 'prog.cc', link_args : '-Wl,--linker-option')
+```

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/Adding-new-projects-to-wrapdb.md Added

@@ -0,0 +1,175 @@
+# Adding new projects to WrapDB
+
+
+## How it works
+
+New wraps must be submitted as a working subproject to the wrapdb
+repository(https://github.com/mesonbuild/wrapdb).
+
+There are two types of wraps on WrapDB - regular wraps and wraps with
+Meson build definition patches.
+
+Wraps with Meson build definition patches work in much the same way as
+Debian: we take the unaltered upstream source package and add a new
+build system to it as a patch. These build systems are stored as a
+subdirectory of subprojects/packagefiles/. They only contain build
+definition files. You may also think of them as an overlay to upstream
+source.
+
+Wraps without Meson build definition patches only contain the wrap
+metadata describing how to fetch the project
+
+Whenever a new release is pushed into the wrapdb, a new tag is
+generated with an incremented version number, and a new release is
+added to the wrapdb API listing. All the old releases remain
+unaltered. New commits are always done via GitHub merge requests and
+must be reviewed by someone other than the submitter.
+
+Note that your Git repo with wrap must not contain the subdirectory of
+the source release. That gets added automatically by the service. You
+also must not commit any source code from the original tarball into
+the wrap repository.
+
+## Choosing the wrap name
+
+Wrapped subprojects are used much like external dependencies. Thus
+they should have the same name as the upstream projects.
+
+NOTE: Wrap names must fully match this regexp: `a-z0-9._+`.
+
+If the project provides a pkg-config file, then the wrap name
+should be the same as the pkg-config name. Usually this is the name of
+the project, such as `libpng`. Sometimes it is slightly different,
+however. As an example the libogg project's chosen pkg-config name is
+`ogg` instead of `libogg`, which is the reason why the wrap is
+named plain `ogg`.
+
+If there is no pkg-config file, the name the project uses/promotes
+should be used, lowercase only (Catch2 -> catch2).
+
+If the project name is too generic or ambiguous (e.g. `benchmark`),
+consider using `organization-project` naming format (e.g.
+`google-benchmark`).
+
+## How to contribute a new wrap
+
+If the project already uses Meson build system, then only a wrap file
+`project.wrap` should be provided. In other case a Meson build
+definition patch - a set of `meson.build` files - should also be
+provided.
+
+### Creating the wrap contents
+
+New release branches require a `project.wrap` file, so create one if
+needed.
+
+```
+${EDITOR} upstream.wrap
+```
+
+The file format is simple, see any existing wrapdb subproject for the
+content. The checksum is SHA-256 and can be calculated with the
+following command on most unix-like operating systems:
+
+```
+sha256sum path/to/libfoo-1.0.0.tar.gz
+```
+
+Under macOS the command is the following:
+
+```
+shasum -a 256 path/to/libfoo-1.0.0.tar.gz
+```
+
+Next you need to add the entries that define what dependencies the
+current project provides. This is important, as it is what makes
+Meson's automatic dependency resolver work. It is done by adding a
+`provide` entry at the end of the `upstream.wrap` file. Using the Ogg
+library as an example, this is what it would look like:
+
+```ini
+provide
+ogg = ogg_dep
+```
+
+The `ogg` part on the left refers to the dependency name, which should
+be the same as its Pkg-Config name. `ogg_dep` on the right refers to
+the variable in the build definitions that provides the dependency.
+Most commonly it holds the result of a `declare_dependency` call. If a
+variable of that name is not defined, Meson will exit with a hard
+error. For further details see the main Wrap
+manual(Wrap-dependency-system-manual.md).
+
+Now you can create the build files, if the upstream project does not
+contain any, and work on them until the project builds correctly.
+Remember that all files go in the directory
+`subprojects/packagefiles/<project-name>`.
+
+```
+${EDITOR} meson.build meson_options.txt
+```
+
+In order to apply the locally added build files to the upstream
+release tarball, the `wrap-file` section must contain a
+`patch_directory` property naming the subdirectory in
+subprojects/packagefiles/ with the build files inside, as this is
+central to the way the wrapdb works. It will be used by the wrapdb
+meson.build, and when a release is created, the files from this
+directory will be converted into an archive and a patch_url will be
+added to the wrap file.
+
+When you are satisfied with the results, add the build files to Git, update
+releases.json as described in
+README.md(https://github.com/mesonbuild/wrapdb#readme), and push the result
+to GitHub.
+
+```
+<verify that your project builds and runs>
+git add releases.json subprojects/project.wrap subprojects/packagefiles/project/
+git commit -a -m 'Add wrap files for libfoo-1.0.0'
+git push -u origin libfoo
+```
+
+Now you should create a pull request on GitHub.
+
+If packaging review requires you to do changes, use the `--amend`
+argument to `commit` so that your branch will have only one commit.
+
+```
+${EDITOR} meson.build
+git commit -u --amend
+git push --force
+```
+
+## Changes to original source
+
+The point of a wrap is to provide the upstream project with as few
+changes as possible. Most projects should not contain anything more
+than a few Meson definition files. Sometimes it may be necessary to
+add a template header file or something similar. These should be held
+at a minimum.
+
+It should especially be noted that there must **not** be any patches
+to functionality. All such changes must be submitted to upstream. You
+may also host your own Git repo with the changes if you wish. The Wrap
+system has native support for Git subprojects.
+
+## Passing automatic validation
+
+Every submitted wrap goes through an automated correctness review and
+passing it is a requirement for merging. Therefore it is highly
+recommended that you run the validation checks yourself so you can fix
+any issues faster.
+
+You can test the wrap itself with the following commands:
+
+    meson subprojects purge --confirm
+    meson setup builddir/ -Dwraps=<project-name>
+
+The first command is to ensure the wrap is correctly fetched from the
+latest packagefiles. The second command configures meson and selects a
+set of subprojects to enable.
+
+The Github project contains automatic CI on pushing to run the project
+and check the metadata for obvious mistakes. This can be checked from
+your fork before submitting a PR.

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/Additional.md Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/Build-options.md Added

@@ -0,0 +1,273 @@
+---
+short-description: Build options to configure project properties
+...
+
+# Build options
+
+Most non-trivial builds require user-settable options. As an example a
+program may have two different data backends that are selectable at
+build time. Meson provides for this by having a option definition
+file. Its name is `meson_options.txt` and it is placed at the root of
+your source tree.
+
+Here is a simple option file.
+
+```meson
+option('someoption', type : 'string', value : 'optval', description : 'An option')
+option('other_one', type : 'boolean', value : false)
+option('combo_opt', type : 'combo', choices : 'one', 'two', 'three', value : 'three')
+option('integer_opt', type : 'integer', min : 0, max : 5, value : 3) # Since 0.45.0
+option('free_array_opt', type : 'array', value : 'one', 'two')  # Since 0.44.0
+option('array_opt', type : 'array', choices : 'one', 'two', 'three', value : 'one', 'two')
+option('some_feature', type : 'feature', value : 'enabled')  # Since 0.47.0
+option('long_desc', type : 'string', value : 'optval',
+       description : 'An option with a very long description' +
+                     'that does something in a specific context') # Since 0.55.0
+```
+
+For built-in options, see Built-in optionsbuiltin_opts.
+
+## Build option types
+
+All types allow a `description` value to be set describing the option,
+if no description is set then the name of the option will be used instead.
+
+### Strings
+
+The string type is a free form string. If the default value is not set
+then an empty string will be used as the default.
+
+### Booleans
+
+Booleans may have values of either `true` or `false`. If no default
+value is supplied then `true` will be used as the default.
+
+### Combos
+
+A combo allows any one of the values in the `choices` parameter to be
+selected.  If no default value is set then the first value will be the
+default.
+
+### Integers
+
+An integer option contains a single integer with optional upper and
+lower values that are specified with the `min` and `max` keyword
+arguments.
+
+This type is available since Meson version 0.45.0.
+
+### Arrays
+
+Arrays represent an array of strings. By default the array can contain
+arbitrary strings. To limit the possible values that can used set the
+`choices` parameter. Meson will then only allow the value array to
+contain strings that are in the given list. The array may be
+empty. The `value` parameter specifies the default value of the option
+and if it is unset then the values of `choices` will be used as the
+default.
+
+As of 0.47.0 -Dopt= and -Dopt= both pass an empty list, before this
+-Dopt= would pass a list with an empty string.
+
+This type is available since version 0.44.0
+
+### Features
+
+A `feature` option has three states: `enabled`, `disabled` or `auto`.
+It is intended to be passed as value for the `required` keyword
+argument of most functions. Currently supported in
+add_languages,
+compiler.find_library,
+compiler.has_header,
+dependency,
+find_program,
+import and
+subproject
+functions.
+
+- `enabled` is the same as passing `required : true`.
+- `auto` is the same as passing `required : false`.
+- `disabled` do not look for the dependency and always return 'not-found'.
+
+When getting the value of this type of option using get_option, a
+special @feature object is returned instead
+of the string representation of the option's value. This object can be
+passed to `required`:
+
+```meson
+d = dependency('foo', required : get_option('myfeature'))
+if d.found()
+  app = executable('myapp', 'main.c', dependencies : d)
+endif
+```
+
+To check the value of the feature, the object has three methods
+returning a boolean and taking no argument:
+
+- `.enabled()`
+- `.disabled()`
+- `.auto()`
+
+This is useful for custom code depending on the feature:
+
+```meson
+if get_option('myfeature').enabled()
+  # ...
+endif
+```
+
+If the value of a `feature` option is set to `auto`, that value is
+overridden by the global `auto_features` option (which defaults to
+`auto`). This is intended to be used by packagers who want to have
+full control on which dependencies are required and which are
+disabled, and not rely on build-deps being installed (at the right
+version) to get a feature enabled. They could set
+`auto_features=enabled` to enable all features and disable explicitly
+only the few they don't want, if any.
+
+This type is available since version 0.47.0
+
+## Deprecated options
+
+Since *0.60.0*
+
+Project options can be marked as deprecated and Meson will warn when user sets a
+value to it. It is also possible to deprecate only some of the choices, and map
+deprecated values to a new value.
+
+```meson
+# Option fully deprecated, it warns when any value is set.
+option('o1', type: 'boolean', deprecated: true)
+
+# One of the choices is deprecated, it warns only when 'a' is in the list of values.
+option('o2', type: 'array', choices: 'a', 'b', deprecated: 'a')
+
+# One of the choices is deprecated, it warns only when 'a' is in the list of values
+# and replace it by 'c'.
+option('o3', type: 'array', choices: 'a', 'b', 'c', deprecated: {'a': 'c'})
+
+# A boolean option has been replaced by a feature, old true/false values are remapped.
+option('o4', type: 'feature', deprecated: {'true': 'enabled', 'false': 'disabled'})
+
+# A feature option has been replaced by a boolean, enabled/disabled/auto values are remapped.
+option('o5', type: 'boolean', deprecated: {'enabled': 'true', 'disabled': 'false', 'auto': 'false'})
+```
+
+Since *0.63.0* the `deprecated` keyword argument can take the name of a new option
+that replace this option. In that case, setting a value on the deprecated option
+will set the value on both the old and new names, assuming they accept the same
+values.
+
+```meson
+# A boolean option has been replaced by a feature with another name, old true/false values
+# are accepted by the new option for backward compatibility.
+option('o6', type: 'boolean', value: 'true', deprecated: 'o7')
+option('o7', type: 'feature', value: 'enabled', deprecated: {'true': 'enabled', 'false': 'disabled'})
+
+# A project option is replaced by a module option
+option('o8', type: 'string', value: '', deprecated: 'python.platlibdir')
+```
+
+## Using build options
+
+```meson
+optval = get_option('opt_name')
+```
+
+This function also allows you to query the value of Meson's built-in
+project options. For example, to get the installation prefix you would
+issue the following command:
+
+```meson
+prefix = get_option('prefix')
+```
+
+It should be noted that you can not set option values in your Meson
+scripts. They have to be set externally with the `meson configure`
+command line tool. Running `meson configure` without arguments in a
+build dir shows you all options you can set.
+
+To change their values use the `-D`
+option:
+
+```console
+$ meson configure -Doption=newvalue
+```
+
+Setting the value of arrays is a bit special. If you only pass a
+single string, then it is considered to have all values separated by
+commas. Thus invoking the following command:
+
+```console
+$ meson configure -Darray_opt=foo,bar
+```
+
+would set the value to an array of two elements, `foo` and `bar`.
+
+If you need to have commas in your string values, then you need to
+pass the value with proper shell quoting like this:
+
+```console
+$ meson configure "-Doption='a,b', 'c,d'"
+```
+
+The inner values must always be single quotes and the outer ones
+double quotes.
+
+To change values in subprojects prepend the name of the subproject and
+a colon:
+
+```console
+$ meson configure -Dsubproject:option=newvalue
+```
+
+**NOTE:** If you cannot call `meson configure` you likely have a old
+  version of Meson. In that case you can call `mesonconf` instead, but
+  that is deprecated in newer versions
+
+## Yielding to superproject option
+
+Suppose you have a master project and a subproject. In some cases it
+might be useful to have an option that has the same value in both of
+them. This can be achieved with the `yield` keyword. Suppose you have
+an option definition like this:
+
+```meson
+option('some_option', type : 'string', value : 'value', yield : true)
+```
+
+If you build this project on its own, this option behaves like
+usual. However if you build this project as a subproject of another
+project which also has an option called `some_option`, then calling
+`get_option` returns the value of the superproject. If the value of
+`yield` is `false`, `get_option` returns the value of the subproject's
+option.
+
+
+## Built-in build options
+
+There are a number of built-in optionsbuiltin_opts. To get the
+current list execute `meson configure` in the build directory.
+
+builtin_opts: https://mesonbuild.com/Builtin-options.html
+
+### Visual Studio
+
+#### Startup project
+
+The `backend_startup_project` option can be set to define the default
+project that will be executed with the "Start debugging F5" action in
+visual studio. It should be the same name as an executable target
+name.
+
+```meson
+project('my_project', 'c', default_options: 'backend_startup_project=my_exe')
+executable('my_exe', ...)
+```
+
+### Ninja
+
+#### Max links
+
+The `backend_max_links` can be set to limit the number of processes
+that ninja will use to link.

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/Build-system-converters.md Added

@@ -0,0 +1,27 @@
+---
+short-description: Converting other build systems to Meson
+...
+
+# Build system converters
+
+Moving from one build system into another includes a fair bit of
+work. To make things easier, Meson provides scripts to convert other
+build systems into Meson. At the time of writing, scripts for CMake
+and autotools exist. It can be found in the `tools` subdirectory in
+Meson's source tree.
+
+The scripts do not try to do a perfect conversion. This would be
+extremely difficult because the data models of other build systems are
+very different. The goal of the converter script is to convert as much
+of the low level drudgery as possible. Using the scripts is
+straightforward. We'll use the CMake one as an example but the
+Autotools one works exactly the same way.
+
+    cmake2meson.py path/to/CMake/project/root
+
+This command generates a skeleton Meson project definition that tries
+to mirror CMake's setup as close as possible. Once this is done, you
+need to go through these files manually and finalize the
+conversion. To make this task as simple as possible, the converter
+script will transfer all comments from the CMake definition into Meson
+definition.

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/Build-targets.md Added

@@ -0,0 +1,100 @@
+---
+short-description: Definition of build targets
+...
+
+# Build targets
+
+Meson provides four kinds of build targets: executables, libraries
+(which can be set to be built as static or shared or both of them at
+the build configuration time), static libraries, and shared libraries.
+They are created with the commands `executable`, `library`,
+`static_library` and `shared_library`, respectively. All objects created
+in this way are **immutable**. That is, you can not change any aspect of
+them after they have been constructed. This ensures that all information
+pertaining to a given build target is specified in one well defined
+place.
+
+Libraries and executables
+--
+
+As an example, here is how you would build a library.
+
+```meson
+project('shared lib', 'c')
+library('mylib', 'source.c')
+```
+
+It is generally preferred to use the `library` command instead of
+`shared_library` and `static_library` and then configure which
+libraries (static or shared or both of them) will be built at the
+build configuration time using the `default_library`
+built-in option(Builtin-options.md).
+
+In Unix-like operating systems, shared libraries can be
+versioned. Meson supports this with keyword arguments, which will be
+ignored if the library is configured as static at the compile time.
+
+```meson
+project('shared lib', 'c')
+library('mylib', 'source.c', version : '1.2.3', soversion : '0')
+```
+
+It is common to build a library and then an executable that links
+against it. This is supported as well.
+
+```meson
+project('shared lib', 'c')
+lib = library('mylib', 'source.c')
+executable('program', 'prog.c', link_with : lib)
+```
+
+Meson sets things up so that the resulting executable can be run
+directly from the build directory. There is no need to write shell
+scripts or set environment variables.
+
+One target can have multiple language source files.
+
+```meson
+project('multilang', 'c', 'cpp')
+executable('multiexe', 'file.c', 'file2.cc')
+```
+
+Object files
+--
+
+Sometimes you can't build files from sources but need to utilize an
+existing object file. A typical case is using an object file provided
+by a third party. Object files can be specified just like sources.
+
+```meson
+exe = executable('myexe', 'source.cpp', objects : 'third_party_object.o')
+```
+
+A different case is when you want to use object files built in one
+target directly in another. A typical case is when you build a shared
+library and it has an internal class that is not exported in the
+ABI. This means you can't access it even if you link against the
+library. Typical workarounds for this include building both a shared
+and static version of the library or putting the source file in the
+test executable's source list. Both of these approaches cause the
+source to be built twice, which is slow.
+
+In Meson you can extract object files from targets and use them as-is
+on other targets. This is the syntax for it.
+
+```meson
+lib = shared_library('somelib', 'internalclass.cc', 'file.cc', ...)
+eo = lib.extract_objects('internalclass.cc')
+executable('classtest', 'classtest.cpp', objects : eo)
+```
+
+Here we take the internal class object and use it directly in the
+test. The source file is only compiled once.
+
+Note that careless use of this feature may cause strange bugs. As an
+example trying to use objects of an executable or static library in a
+shared library will not work because shared library objects require
+special compiler flags. Getting this right is the user's
+responsibility. For this reason it is strongly recommended that you
+only use this feature for generating unit test executables in the
+manner described above.

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/Builtin-options.md Added

@@ -0,0 +1,327 @@
+---
+short-description: Built-in options to configure project properties
+...
+
+# Built-in options
+
+Meson provides two kinds of options: build options provided by the
+build files(Build-options.md) and built-in options that are either
+universal options, base options, compiler options.
+
+## Universal options
+
+All these can be set by passing `-Doption=value` to `meson` (aka `meson
+setup`), or by setting them inside `default_options` of project in your
+`meson.build`. Some options can also be set by `--option=value`, or `--option
+value` -- a list is shown by running `meson setup --help`.
+
+For legacy reasons `--warnlevel` is the cli argument for the
+`warning_level` option.
+
+They can also be edited after setup using `meson configure
+-Doption=value`.
+
+Installation options are usually relative to the prefix but it should
+not be relied on, since they can be absolute paths in the following cases:
+
+* When the prefix is `/usr`: `sysconfdir` defaults to `/etc`,
+ `localstatedir` defaults to `/var`, and `sharedstatedir` defaults to
+ `/var/lib`
+* When the prefix is `/usr/local`: `localstatedir` defaults
+ to `/var/local`, and `sharedstatedir` defaults to `/var/local/lib`
+* When an absolute path outside of prefix is provided by the user/distributor.
+
+### Directories
+
+| Option                               | Default value | Description |
+| ------                               | ------------- | ----------- |
+| prefix                               | see below     | Installation prefix |
+| bindir                               | bin           | Executable directory |
+| datadir                              | share         | Data file directory |
+| includedir                           | include       | Header file directory |
+| infodir                              | share/info    | Info page directory |
+| libdir                               | see below     | Library directory |
+| libexecdir                           | libexec       | Library executable directory |
+| localedir                            | share/locale  | Locale data directory |
+| localstatedir                        | var           | Localstate data directory |
+| mandir                               | share/man     | Manual page directory |
+| sbindir                              | sbin          | System executable directory |
+| sharedstatedir                       | com           | Architecture-independent data directory |
+| sysconfdir                           | etc           | Sysconf data directory |
+
+
+`prefix` defaults to `C:/` on Windows, and `/usr/local` otherwise. You
+should always override this value.
+
+`libdir` is automatically detected based on your platform, it should
+be correct when doing "native" (build machine == host machine)
+compilation. For cross compiles Meson will try to guess the correct
+libdir, but it may not be accurate, especially on Linux where
+different distributions have different defaults. Using a cross
+file(Cross-compilation.md#defining-the-environment), particularly the
+paths section may be necessary.
+
+### Core options
+
+Options that are labeled "per machine" in the table are set per
+machine. See the specifying options per
+machine(#specifying-options-per-machine) section for details.
+
+| Option                                 | Default value | Description                                                    | Is per machine | Is per subproject |
+| -------------------------------------- | ------------- | -----------                                                    | -------------- | ----------------- |
+| auto_features {enabled, disabled, auto} | auto       | Override value of all 'auto' features                          | no             | no                |
+| backend {ninja, vs,<br>vs2010, vs2012, vs2013, vs2015, vs2017, vs2019, vs2022, xcode} | ninja | Backend to use        | no             | no                |
+| buildtype {plain, debug,<br>debugoptimized, release, minsize, custom} | debug |  Build type to use                    | no             | no                |
+| debug                                  | true          | Enable debug symbols and other information                     | no             | no                |
+| default_library {shared, static, both} | shared      | Default library type                                           | no             | yes               |
+| errorlogs                              | true          | Whether to print the logs from failing tests.                  | no             | no                |
+| install_umask {preserve, 0000-0777}    | 022           | Default umask to apply on permissions of installed files       | no             | no                |
+| layout {mirror,flat}                   | mirror        | Build directory layout                                         | no             | no                |
+| optimization {plain, 0, g, 1, 2, 3, s} | 0             | Optimization level                                             | no             | no                |
+| pkg_config_path {OS separated path}    | ''            | Additional paths for pkg-config to search before builtin paths | yes            | no                |
+| prefer_static                          | false         | Whether to try static linking before shared linking            | no             | no                |
+| cmake_prefix_path                      |             | Additional prefixes for cmake to search before builtin paths   | yes            | no                |
+| stdsplit                               | true          | Split stdout and stderr in test logs                           | no             | no                |
+| strip                                  | false         | Strip targets on install                                       | no             | no                |
+| unity {on, off, subprojects}           | off           | Unity build                                                    | no             | no                |
+| unity_size {>=2}                       | 4             | Unity file block size                                          | no             | no                |
+| warning_level {0, 1, 2, 3, everything} | 1             | Set the warning level. From 0 = none to everything = highest   | no             | yes               |
+| werror                                 | false         | Treat warnings as errors                                       | no             | yes               |
+| wrap_mode {default, nofallback,<br>nodownload, forcefallback, nopromote} | default | Wrap mode to use                 | no             | no                |
+| force_fallback_for                     |             | Force fallback for those dependencies                          | no             | no                |
+
+<a name="build-type-options"></a> For setting optimization levels and
+toggling debug, you can either set the `buildtype` option, or you can
+set the `optimization` and `debug` options which give finer control
+over the same. Whichever you decide to use, the other will be deduced
+from it. For example, `-Dbuildtype=debugoptimized` is the same as
+`-Ddebug=true -Doptimization=2` and vice-versa. This table documents
+the two-way mapping:
+
+| buildtype      | debug | optimization |
+| ---------      | ----- | ------------ |
+| plain          | false | plain        |
+| debug          | true  | 0            |
+| debugoptimized | true  | 2            |
+| release        | false | 3            |
+| minsize        | true  | s            |
+
+All other combinations of `debug` and `optimization` set `buildtype` to `'custom'`.
+
+## Base options
+
+These are set in the same way as universal options, either by
+`-Doption=value`, or by setting them inside `default_options` of
+project in your `meson.build`. However, they cannot be shown in
+the output of `meson setup --help` because they depend on both the current
+platform and the compiler that will be selected. The only way to see
+them is to setup a builddir and then run `meson configure` on it with
+no options.
+
+The following options are available. Note that they may not be
+available on all platforms or with all compilers:
+
+| Option              | Default value        | Possible values                                               | Description                                                                    |
+|---------------------|----------------------|---------------------------------------------------------------|--------------------------------------------------------------------------------|
+| b_asneeded          | true                 | true, false                                                   | Use -Wl,--as-needed when linking                                               |
+| b_bitcode           | false                | true, false                                                   | Embed Apple bitcode, see below                                                 |
+| b_colorout          | always               | auto, always, never                                           | Use colored output                                                             |
+| b_coverage          | false                | true, false                                                   | Enable coverage tracking                                                       |
+| b_lundef            | true                 | true, false                                                   | Don't allow undefined symbols when linking                                     |
+| b_lto               | false                | true, false                                                   | Use link time optimization                                                     |
+| b_lto_threads       | 0                    | Any integer*                                                  | Use multiple threads for lto. *(Added in 0.57.0)*                              |
+| b_lto_mode          | default              | default, thin                                                 | Select between lto modes, thin and default. *(Added in 0.57.0)*                |
+| b_thinlto_cache     | false                | true, false                                                   | Enable LLVM's ThinLTO cache for faster incremental builds. *(Added in 0.64.0)* |
+| b_thinlto_cache_dir | (Internal build dir) | true, false                                                   | Specify where to store ThinLTO cache objects. *(Added in 0.64.0)*              |
+| b_ndebug            | false                | true, false, if-release                                       | Disable asserts                                                                |
+| b_pch               | true                 | true, false                                                   | Use precompiled headers                                                        |
+| b_pgo               | off                  | off, generate, use                                            | Use profile guided optimization                                                |
+| b_sanitize          | none                 | see below                                                     | Code sanitizer to use                                                          |
+| b_staticpic         | true                 | true, false                                                   | Build static libraries as position independent                                 |
+| b_pie               | false                | true, false                                                   | Build position-independent executables (since 0.49.0)                          |
+| b_vscrt             | from_buildtype       | none, md, mdd, mt, mtd, from_buildtype, static_from_buildtype | VS runtime library to use (since 0.48.0) (static_from_buildtype since 0.56.0)  |
+
+The value of `b_sanitize` can be one of: `none`, `address`, `thread`,
+`undefined`, `memory`, `leak`, `address,undefined`, but note that some
+compilers might not support all of them. For example Visual Studio
+only supports the address sanitizer.
+
+\* < 0 means disable, == 0 means automatic selection, > 0 sets a specific number to use
+
+LLVM supports `thin` lto, for more discussion see LLVM's documentation(https://clang.llvm.org/docs/ThinLTO.html)
+
+<a name="b_vscrt-from_buildtype"></a>
+The default value of `b_vscrt` is `from_buildtype`. The following table is
+used internally to pick the CRT compiler arguments for `from_buildtype` or
+`static_from_buildtype` *(since 0.56)* based on the value of the `buildtype`
+option:
+
+| buildtype      | from_buildtype | static_from_buildtype |
+| --------       | -------------- | --------------------- |
+| debug          | `/MDd`         | `/MTd`                |
+| debugoptimized | `/MD`          | `/MT`                 |
+| release        | `/MD`          | `/MT`                 |
+| minsize        | `/MD`          | `/MT`                 |
+| custom         | error!         | error!                |
+
+### Notes about Apple Bitcode support
+
+`b_bitcode` will pass `-fembed-bitcode` while compiling and will pass
+`-Wl,-bitcode_bundle` while linking. These options are incompatible
+with `b_asneeded`, so that option will be silently disabled.
+
+shared_modules will not have
+bitcode embedded because `-Wl,-bitcode_bundle` is incompatible with
+both `-bundle` and `-Wl,-undefined,dynamic_lookup` which are necessary
+for shared modules to work.
+
+## Compiler options
+
+Same caveats as base options above.
+
+The following options are available. They can be set by passing
+`-Doption=value` to `meson`. Note that both the options themselves and
+the possible values they can take will depend on the target platform
+or compiler being used:
+
+| Option           | Default value | Possible values                          | Description |
+| ------           | ------------- | ---------------                          | ----------- |
+| c_args           |               | free-form comma-separated list           | C compile arguments to use |
+| c_link_args      |               | free-form comma-separated list           | C link arguments to use |
+| c_std            | none          | none, c89, c99, c11, c17, c18, c2x, gnu89, gnu99, gnu11, gnu17, gnu18, gnu2x | C language standard to use |
+| c_winlibs        | see below     | free-form comma-separated list           | Standard Windows libs to link against |
+| c_thread_count   | 4             | integer value ≥ 0                        | Number of threads to use with emcc when using threads |
+| cpp_args         |               | free-form comma-separated list           | C++ compile arguments to use |
+| cpp_link_args    |               | free-form comma-separated list           | C++ link arguments to use |
+| cpp_std          | none          | none, c++98, c++03, c++11, c++14, c++17, c++20 <br/>c++2a, c++1z, gnu++03, gnu++11, gnu++14, gnu++17, gnu++1z, <br/> gnu++2a, gnu++20, vc++14, vc++17, vc++latest | C++ language standard to use |
+| cpp_debugstl     | false         | true, false                              | C++ STL debug mode |
+| cpp_eh           | default       | none, default, a, s, sc                  | C++ exception handling type |
+| cpp_rtti         | true          | true, false                              | Whether to enable RTTI (runtime type identification) |
+| cpp_thread_count | 4             | integer value ≥ 0                        | Number of threads to use with emcc when using threads |
+| cpp_winlibs      | see below     | free-form comma-separated list           | Standard Windows libs to link against |
+| fortran_std      | none          | none, legacy, f95, f2003, f2008, f2018 | Fortran language standard to use |
+| cuda_ccbindir    |               | filesystem path                          | CUDA non-default toolchain directory to use (-ccbin) *(Added in 0.57.1)* |
+
+The default values of `c_winlibs` and `cpp_winlibs` are in
+compiler-specific argument forms, but the libraries are: kernel32,
+user32, gdi32, winspool, shell32, ole32, oleaut32, uuid, comdlg32,
+advapi32.
+
+All these `<lang>_*` options are specified per machine. See below in
+the specifying options per machine(#specifying-options-per-machine)
+section on how to do this in cross builds.
+
+When using MSVC, `cpp_eh=none` will result in no exception flags being
+passed, while the `cpp_eh=value` will result in `/EHvalue`. Since
+*0.51.0* `cpp_eh=default` will result in `/EHsc` on MSVC. When using
+gcc-style compilers, nothing is passed (allowing exceptions to work),
+while `cpp_eh=none` passes `-fno-exceptions`.
+
+Since *0.54.0* The `<lang>_thread_count` option can be used to control
+the value passed to `-s PTHREAD_POOL_SIZE` when using emcc. No other
+c/c++ compiler supports this option.
+
+Since *0.63.0* all compiler options can be set per subproject, see
+here(#specifying-options-per-subproject) for details on how the default value
+is inherited from the main project. This is useful, for example, when the main
+project requires C++11, but a subproject requires C++14. The `cpp_std` value
+from the subproject's `default_options` is now respected.
+
+## Specifying options per machine
+
+Since *0.51.0*, some options are specified per machine rather than
+globally for all machine configurations. Prefixing the option with
+`build.` only affects the build machine configuration, while leaving it
+unprefixed only affects the host machine configuration.
+For example:
+
+ - `build.pkg_config_path` controls the paths pkg-config will search
+   for `native: true` (build machine) dependencies.
+
+ - `pkg_config_path` controls the paths pkg-config will search for
+   `native: false` (host machine) dependencies.
+
+This is useful for cross builds. In native builds, the build and host
+machines are the same, and the unprefixed option alone will suffice.
+
+Prior to *0.51.0*, these options only affected native builds when
+specified on the command line as there was no `build.` prefix.
+Similarly named fields in the `properties` section of the cross file
+would affect cross compilers, but the code paths were fairly different,
+allowing differences in behavior to crop out.
+
+## Specifying options per subproject
+
+Since *0.54.0* `default_library` and `werror` built-in options can be
+defined per subproject. This is useful, for example, when building
+shared libraries in the main project and statically linking a subproject,
+or when the main project must build with no warnings but some subprojects
+cannot.
+
+Most of the time, this would be used either in the parent project by
+setting subproject's default_options (e.g. `subproject('foo',
+default_options: 'default_library=static')`), or by the user through the
+command line: `-Dfoo:default_library=static`.
+
+The value is overridden in this order:
+- Value from parent project
+- Value from subproject's default_options if set
+- Value from subproject() default_options if set
+- Value from command line if set
+
+Since *0.56.0* `warning_level` can also be defined per subproject.
+
+## Module options
+
+Some Meson modules have built-in options. They can be set by prefixing the
+option with the module's name:
+`-D<module>.<option>=<value>` (e.g. `-Dpython.platlibdir=/foo`).
+
+### Pkgconfig module
+
+| Option      | Default value | Possible values | Description                                                |
+|-------------|---------------|-----------------|------------------------------------------------------------|
+| relocatable | false         | true, false     | Generate the pkgconfig files as relocatable (Since 0.63.0) |
+
+*Since 0.63.0* The `pkgconfig.relocatable` option is used by the
+pkgconfig module–namely `pkg.generate()`(Pkgconfig-module.md)–and
+affects how the `prefix` (not to be confused with the
+install prefix(#directories)) in the generated pkgconfig file is set.
+When it is `true`, the `prefix` will be relative to the `install_dir`-this
+allows the pkgconfig file to be moved around and still work, as long
+as the relative path is not broken. In general, this allows for the whole
+installed package to be placed anywhere on the system and still work as a
+dependency. When it is set to `false`, the `prefix` will be the same as
+the install prefix.
+
+An error will be raised if `pkgconfig.relocatable` is `true` and the
+`install_dir` for a generated pkgconfig file points outside the
+install prefix. For example: if the install prefix is `/usr` and the
+`install_dir` for a pkgconfig file is `/var/lib/pkgconfig`.
+
+### Python module
+
+| Option           | Default value | Possible values             | Description |
+| ------           | ------------- | -----------------           | ----------- |
+| install_env      | prefix        | {auto,prefix,system,venv}   | Which python environment to install to (Since 0.62.0) |
+| platlibdir       |               | Directory path              | Directory for site-specific, platform-specific files (Since 0.60.0) |
+| purelibdir       |               | Directory path              | Directory for site-specific, non-platform-specific files  (Since 0.60.0) |
+
+*Since 0.60.0* The `python.platlibdir` and `python.purelibdir` options are used
+by the python module methods `python.install_sources()` and
+`python.get_install_dir()`; Meson tries to detect the correct installation paths
+and make them relative to the installation `prefix` by default which will often
+result in the interpreter not finding the installed python modules unless
+`prefix` is `/usr` on Linux, or, for instance, `C:\Python39` on Windows. These
+options can be absolute paths outside of `prefix`.
+
+*Since 0.62.0* The `python.install_env` option is used to detect the correct
+installation path. Setting to `system` will avoid making the paths relative to
+`prefix` and instead use the global site-packages of the selected python
+interpreter directly, even if it is a venv. Setting to `venv` will instead use
+the paths for the virtualenv the python found installation comes from (or fail
+if it is not a virtualenv).  Setting to `auto` will check if the found
+installation is a virtualenv, and use `venv` or `system` as appropriate (but
+never `prefix`). This option is mutually exclusive with the `platlibdir`/`purelibdir`.
+
+For backwards compatibility purposes, the default `install_env` is `prefix`.

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/CMake-module.md Added

@@ -0,0 +1,291 @@
+# CMake module
+
+**Note**: the functionality of this module is governed by Meson's
+  rules on mixing build systems(Mixing-build-systems.md).
+
+This module provides helper tools for generating cmake package files.
+It also supports the usage of CMake based subprojects, similar to
+the normal Meson subprojects(Subprojects.md).
+
+
+## Usage
+
+To use this module, just do: **`cmake = import('cmake')`**. The
+following functions will then be available as methods on the object
+with the name `cmake`. You can, of course, replace the name `cmake`
+with anything else.
+
+It is generally recommended to use the latest Meson version and
+CMake >=3.17 for best compatibility. CMake subprojects will
+usually also work with older CMake versions. However, this can
+lead to unexpected issues in rare cases.
+
+## CMake subprojects
+
+Using CMake subprojects is similar to using the "normal" Meson
+subprojects. They also have to be located in the `subprojects`
+directory.
+
+Example:
+
+```cmake
+add_library(cm_lib SHARED ${SOURCES})
+```
+
+```meson
+cmake = import('cmake')
+
+# Configure the CMake project
+sub_proj = cmake.subproject('libsimple_cmake')
+
+# Fetch the dependency object
+cm_lib = sub_proj.dependency('cm_lib')
+
+executable(exe1, 'sources', dependencies: cm_lib)
+```
+
+The `subproject` method is almost identical to the normal Meson
+subproject function. The only difference is that a CMake project
+instead of a Meson project is configured.
+
+The returned `sub_proj` supports the same options as a "normal"
+subproject. Meson automatically detects CMake build targets, which can
+be accessed with the methods listed below(#subproject-object).
+
+It is usually enough to just use the dependency object returned by the
+`dependency()` method in the build targets. This is almost identical
+to using the declare_dependency object from a normal Meson subproject.
+
+It is also possible to use executables defined in the CMake project as code
+generators with the `target()` method:
+
+```cmake
+add_executable(cm_exe ${EXE_SRC})
+```
+
+```meson
+cmake = import('cmake')
+
+# Subproject with the "code generator"
+sub_pro = cmake.subproject('cmCodeGen')
+
+# Fetch the code generator exe
+sub_exe = sub_pro.target('cm_exe')
+
+# Use the code generator
+generated = custom_target(
+  'cmake-generated',
+  input: ,
+  output: 'test.cpp',
+  command: sub_exe, '@OUTPUT@'
+)
+```
+
+It should be noted that not all projects are guaranteed to work. The
+safest approach would still be to create a `meson.build` for the
+subprojects in question.
+
+### Configuration options
+
+*New in meson 0.55.0*
+
+Meson also supports passing configuration options to CMake and overriding
+certain build details extracted from the CMake subproject.
+
+```meson
+cmake   = import('cmake')
+opt_var = cmake.subproject_options()
+
+# Call CMake with `-DSOME_OTHER_VAR=ON`
+opt_var.add_cmake_defines({'SOME_OTHER_VAR': true})
+
+# Globally override the C++ standard to c++11
+opt_var.set_override_option('cpp_std', 'c++11')
+
+# Override the previous global C++ standard
+# with c++14 only for the CMake target someLib
+opt_var.set_override_option('cpp_std', 'c++14', target: 'someLib')
+
+sub_pro = cmake.subproject('someLibProject', options: opt_var)
+
+# Further changes to opt_var have no effect
+```
+
+See the CMake options object(#cmake-options-object) for a complete
+reference of all supported functions.
+
+The CMake configuration options object is very similar to the
+@cfg_data object object returned
+by configuration_data. It
+is generated by the `subproject_options` method.
+
+All configuration options have to be set *before* the subproject is
+configured and must be passed to the `subproject` method via the
+`options` key. Altering the configuration object won't have any effect
+on previous `cmake.subproject` calls.
+
+In earlier Meson versions CMake command-line parameters could be set
+with the `cmake_options` kwarg. However, this feature is deprecated
+since 0.55.0 and only kept for compatibility. It will not work
+together with the `options` kwarg.
+
+### `subproject` object
+
+This object is returned by the `subproject` method described above
+and supports the following methods:
+
+ - `dependency(target)` returns a dependency object for any CMake target. The
+   `include_type` kwarg *(new in 0.56.0)* controls the include type of the
+   returned dependency object similar to the same kwarg in the
+   dependency function.
+ - `include_directories(target)` returns a Meson @inc
+   object for the specified target. Using this method is not necessary
+   if the dependency object is used.
+ - `target(target)` returns the raw build target.
+ - `target_type(target)` returns the type of the target as a string
+ - `target_list()` returns a list of all target *names*.
+ - `get_variable(name)` fetches the specified variable from inside
+   the subproject. Usually `dependency()` or `target()` should be
+   preferred to extract build targets.
+ - `found` returns true if the subproject is available, otherwise false
+   *new in Meson 0.53.2*
+
+### `cmake options` object
+
+This object is returned by the `subproject_options()` method and
+consumed by the `options` kwarg of the `subproject` method. The
+following methods are supported:
+
+ - `add_cmake_defines({'opt1': val1, ...})` add additional CMake commandline defines
+ - `set_override_option(opt, val)` set specific build options(Build-options.md)
+   for targets. This will effectively add `opt=val` to the `override_options`
+   array of the build_target
+ - `set_install(bool)` override whether targets should be installed or not
+ - `append_compile_args(lang, arg1, ...)` append compile flags for a specific
+   language to the targets
+ - `append_link_args(arg1, ...)` append linker args to the targets
+ - `clear()` reset all data in the `cmake options` object
+
+The methods `set_override_option`, `set_install`,
+`append_compile_args` and `append_link_args` support the optional
+`target` kwarg. If specified, the set options affect the specific
+target. The effect of the option is global for the subproject
+otherwise.
+
+If, for instance, `opt_var.set_install(false)` is called, no target
+will be installed regardless of what is set by CMake. However, it is
+still possible to install specific targets (here `foo`) by setting the
+`target` kwarg: `opt_var.set_install(true, target: 'foo')`
+
+Options that are not set won't affect the generated subproject. So, if
+for instance, `set_install` was not called then the values extracted
+from CMake will be used.
+
+### Cross compilation
+
+*New in 0.56.0*
+
+Meson will try to automatically guess most of the required CMake
+toolchain variables from existing entries in the cross and native
+files. These variables will be stored in an automatically generate
+CMake toolchain file in the build directory. The remaining variables
+that can't be guessed can be added by the user in the `cmake`
+cross/native file section (*new in 0.56.0*).
+
+Adding a manual CMake toolchain file is also supported with the
+`cmake_toolchain_file` setting in the `properties` section. Directly
+setting a CMake toolchain file with
+`-DCMAKE_TOOLCHAIN_FILE=/path/to/some/Toolchain.cmake` in the
+`meson.build` is **not** supported since the automatically generated
+toolchain file is also used by Meson to inject arbitrary code into
+CMake to enable the CMake subproject support.
+
+The closest configuration to only using a manual CMake toolchain file
+would be to set these options in the machine file:
+
+```ini
+properties
+
+cmake_toolchain_file = '/path/to/some/Toolchain.cmake'
+cmake_defaults       = false
+
+cmake
+
+# No entries in this section
+```
+
+This will result in a toolchain file with just the bare minimum to
+enable the CMake subproject support and `include()` the
+`cmake_toolchain_file` as the last instruction.
+
+For more information see the cross and native file
+specification(Machine-files.md).
+
+## CMake configuration files
+
+### cmake.write_basic_package_version_file()
+
+This method is the equivalent of the corresponding CMake
+function(https://cmake.org/cmake/help/latest/module/CMakePackageConfigHelpers.html#command:write_basic_package_version_file),
+it generates a `name` package version file.
+
+* `name`: the name of the package.
+* `version`: the version of the generated package file.
+* `compatibility`: a string indicating the kind of compatibility, the accepted values are
+`AnyNewerVersion`, `SameMajorVersion`, `SameMinorVersion` or `ExactVersion`.
+It defaults to `AnyNewerVersion`. Depending on your cmake installation some kind of
+compatibility may not be available.
+* `arch_independent`: *new in 0.62.0*, if true the generated package file
+  will skip architecture checks. Useful for header-only libraries.
+* `install_dir`: optional installation directory, it defaults to `$(libdir)/cmake/$(name)`
+
+
+Example:
+
+```meson
+cmake = import('cmake')
+
+cmake.write_basic_package_version_file(name: 'myProject', version: '1.0.0')
+```
+
+### cmake.configure_package_config_file()
+
+This method is the equivalent of the corresponding CMake
+function(https://cmake.org/cmake/help/v3.11/module/CMakePackageConfigHelpers.html#generating-a-package-configuration-file),
+it generates a `name` package configuration file from the `input`
+template file. Just like the cmake function in this file the
+`@PACKAGE_INIT@` statement will be replaced by the appropriate piece
+of cmake code. The equivalent `PATH_VARS` argument is given through
+the `configuration` parameter.
+
+* `name`: the name of the package.
+* `input`: the template file where that will be treated for variable substitutions contained in `configuration`.
+* `install_dir`: optional installation directory, it defaults to `$(libdir)/cmake/$(name)`.
+* `configuration`: a `configuration_data` object that will be used for variable substitution in the template file.
+  *Since 0.62.0* it can take a dictionary instead.
+
+
+Example:
+
+meson.build:
+
+```meson
+cmake = import('cmake')
+
+conf = configuration_data()
+conf.set_quoted('VAR', 'variable value')
+
+cmake.configure_package_config_file(
+    name: 'myProject',
+    input: 'myProject.cmake.in',
+    configuration: conf
+)
+```
+
+myProject.cmake.in:
+
+```text
+@PACKAGE_INIT@
+
+set(MYVAR VAR)
+```

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/Code-formatting.md Added

@@ -0,0 +1,63 @@
+---
+short-description: Code formatting
+...
+
+# clang-format
+
+*Since 0.50.0*
+
+When `clang-format` is installed and a `.clang-format` file is found at the main
+project's root source directory, Meson automatically adds a `clang-format` target
+that reformat all C and C++ files (currently only with Ninja backend).
+
+```sh
+ninja -C builddir clang-format
+```
+
+*Since 0.58.0*
+
+It is possible to restrict files to be reformatted with optional
+`.clang-format-include` and `.clang-format-ignore` files.
+
+The file `.clang-format-include` contains a list of patterns matching the files
+that will be reformatted. The `**` pattern matches this directory and all
+subdirectories recursively. Empty lines and lines starting with `#` are ignored.
+If `.clang-format-include` is not found, the pattern defaults to `**/*` which
+means all files recursively in the source directory but has the disadvantage to
+walk the whole source tree which could be slow in the case it contains lots of
+files.
+
+Example of `.clang-format-include` file:
+```
+# All files in src/ and its subdirectories
+src/**/*
+
+# All files in include/ but not its subdirectories
+include/*
+```
+
+The file `.clang-format-ignore` contains a list of patterns matching the files
+that will be excluded. Files matching the include list (see above) that match
+one of the ignore pattern will not be reformatted. Unlike include patterns, ignore
+patterns does not support `**` and a single `*` match any characters including
+path separators. Empty lines and lines starting with `#` are ignored.
+
+The build directory and file without a well known C or C++ suffix are always
+ignored.
+
+Example of `.clang-format-ignore` file:
+```
+# Skip C++ files in src/ directory
+src/*.cpp
+```
+
+Note that `.clang-format-ignore` has the same format as used by
+`run-clang-format.py`(https://github.com/Sarcasm/run-clang-format).
+
+A new target `clang-format-check` has been added. It returns an error code if
+any file needs to be reformatted. This is intended to be used by CI.
+
+*Since 0.60.0*
+
+If `.clang-format-include` file is missing and source files are in a git
+repository, only files tracked by git will be included.

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/Commands.md Added

@@ -0,0 +1,367 @@
+# Command-line commands
+
+There are two different ways of invoking Meson. First, you can run it
+directly from the source tree with the command
+`/path/to/source/meson.py`. Meson may also be installed in which case
+the command is simply `meson`. In this manual we only use the latter
+format for simplicity.
+
+Meson is invoked using the following syntax:
+`meson COMMAND COMMAND_OPTIONS`
+
+This section describes all available commands and some of their
+Optional arguments. The most common workflow is to run
+`setup`(#setup), followed by `compile`(#compile), and then
+`install`(#install).
+
+For the full list of all available options for a specific command use
+the following syntax: `meson COMMAND --help`
+
+### configure
+
+{{ configure_usage.inc }}
+
+Changes options of a configured meson project.
+
+{{ configure_arguments.inc }}
+
+Most arguments are the same as in `setup`(#setup).
+
+Note: reconfiguring project will not reset options to their default
+values (even if they were changed in `meson.build`).
+
+#### Examples:
+
+List all available options:
+```
+meson configure builddir
+```
+
+Change value of a single option:
+```
+meson configure builddir -Doption=new_value
+```
+
+### compile
+
+*(since 0.54.0)*
+
+{{ compile_usage.inc }}
+
+Builds a default or a specified target of a configured Meson project.
+
+{{ compile_arguments.inc }}
+
+`--verbose` argument is available since 0.55.0.
+
+#### Targets
+
+*(since 0.55.0)*
+
+`TARGET` has the following syntax `PATH/NAME:TYPE`, where:
+- `NAME`: name of the target from `meson.build` (e.g. `foo` from `executable('foo', ...)`).
+- `PATH`: path to the target relative to the root `meson.build` file. Note: relative path for a target specified in the root `meson.build` is `./`.
+- `TYPE`: type of the target. Can be one of the following: 'executable', 'static_library', 'shared_library', 'shared_module', 'custom', 'run', 'jar'.
+
+`PATH` and/or `TYPE` can be omitted if the resulting `TARGET` can be
+used to uniquely identify the target in `meson.build`.
+
+#### Backend specific arguments
+
+*(since 0.55.0)*
+
+`BACKEND-args` use the following syntax:
+
+If you only pass a single string, then it is considered to have all
+values separated by commas. Thus invoking the following command:
+
+```
+$ meson compile --ninja-args=-n,-d,explain
+```
+
+would add `-n`, `-d` and `explain` arguments to ninja invocation.
+
+If you need to have commas or spaces in your string values, then you
+need to pass the value with proper shell quoting like this:
+
+```
+$ meson compile "--ninja-args='a,b', 'c d'"
+```
+
+#### Examples:
+
+Build the project:
+```
+meson compile -C builddir
+```
+
+Execute a dry run on ninja backend with additional debug info:
+
+```
+meson compile --ninja-args=-n,-d,explain
+```
+
+Build three targets: two targets that have the same `foo` name, but
+different type, and a `bar` target:
+
+```
+meson compile foo:shared_library foo:static_library bar
+```
+
+Produce a coverage html report (if available):
+
+```
+meson compile coverage-html
+```
+
+### dist
+
+*(since 0.52.0)*
+
+{{ dist_usage.inc }}
+
+Generates a release archive from the current source tree.
+
+{{ dist_arguments.inc }}
+
+See notes about creating releases(Creating-releases.md) for more info.
+
+#### Examples:
+
+Create a release archive:
+```
+meson dist -C builddir
+```
+
+### init
+
+*(since 0.45.0)*
+
+{{ init_usage.inc }}
+
+Creates a basic set of build files based on a template.
+
+{{ init_arguments.inc }}
+
+#### Examples:
+
+Create a project in `sourcedir`:
+```
+meson init -C sourcedir
+```
+
+### env2mfile
+
+*This command is experimental and subject to change.*
+
+*{Since 0.62.0}*
+
+{{ env2mfile_usage.inc }}
+
+Create native and cross files from the current environment, typically
+by sniffing environment variables like `CC` and `CFLAGS`.
+
+{{ env2mfile_arguments.inc }}
+
+#### Examples:
+
+Autodetect the current cross build environment:
+
+```
+meson env2mfile --cross -o current_cross.txt --cpu=arm7a --cpu-family=arm --system=linux
+```
+
+Generate a cross build using Debian system information:
+
+```
+meson env2mfile --cross --debarch=armhf -o deb_arm_cross.txt
+```
+
+
+
+### introspect
+
+{{ introspect_usage.inc }}
+
+Displays information about a configured Meson project.
+
+{{ introspect_arguments.inc }}
+
+#### Examples:
+
+Display basic information about a configured project in `builddir`:
+
+```
+meson introspect builddir --projectinfo
+```
+
+### install
+
+*(since 0.47.0)*
+
+{{ install_usage.inc }}
+
+Installs the project to the prefix specified in `setup`(#setup).
+
+{{ install_arguments.inc }}
+
+See the installation documentation(Installing.md) for more info.
+
+#### Examples:
+
+Install project to `prefix`:
+```
+meson install -C builddir
+```
+
+Install project to `$DESTDIR/prefix`:
+```
+DESTDIR=/path/to/staging/area meson install -C builddir
+```
+
+Since *0.60.0* `DESTDIR` and `--destdir` can be a path relative to build
+directory. An absolute path will be set into environment when executing scripts.
+
+### rewrite
+
+*(since 0.50.0)*
+
+{{ rewrite_usage.inc }}
+
+Modifies the Meson project.
+
+{{ rewrite_arguments.inc }}
+
+See the Meson file rewriter documentation(Rewriter.md) for more info.
+
+### setup
+
+{{ setup_usage.inc }}
+
+Configures a build directory for the Meson project.
+
+*Deprecated since 0.64.0*: This is the default Meson command (invoked if there
+was no COMMAND supplied). However, supplying the command is necessary to avoid
+clashes with future added commands, so "setup" should be used explicitly.
+
+{{ setup_arguments.inc }}
+
+See Meson introduction
+page(Running-Meson.md#configuring-the-build-directory) for more info.
+
+#### Examples:
+
+Configures `builddir` with default values:
+```
+meson setup builddir
+```
+
+### subprojects
+
+*(since 0.49.0)*
+
+{{ subprojects_usage.inc }}
+
+Manages subprojects of the Meson project. *Since 0.59.0* commands are run on
+multiple subprojects in parallel by default, use `--num-processes=1` if it is
+not desired.
+
+Since *0.64.0* the `update` subcommand will not download new wrap files
+from WrapDB any more. Use `meson wrap update` command for that instead.
+
+{{ subprojects_arguments.inc }}
+
+### test
+
+{{ test_usage.inc }}
+
+Run tests for the configure Meson project.
+
+{{ test_arguments.inc }}
+
+See the unit test documentation(Unit-tests.md) for more info.
+
+#### Examples:
+
+Run tests for the project:
+```
+meson test -C builddir
+```
+
+Run only `specific_test_1` and `specific_test_2`:
+```
+meson test -C builddir specific_test_1 specific_test_2
+```
+
+### wrap
+
+{{ wrap_usage.inc }}
+
+An utility to manage WrapDB dependencies.
+
+{{ wrap_arguments.inc }}
+
+See the WrapDB tool documentation(Using-wraptool.md) for more info.
+
+### devenv
+
+*(since 0.58.0)*
+
+{{ devenv_usage.inc }}
+
+Runs a command, or open interactive shell if no command is provided, with
+environment setup to run project from the build directory, without installation.
+
+We automatically handle `bash` and set `$PS1` accordingly. If the automatic `$PS1`
+override is not desired (maybe you have a fancy custom prompt), set the
+`$MESON_DISABLE_PS1_OVERRIDE` environment variable and use `$MESON_PROJECT_NAME`
+when setting the custom prompt, for example with a snippet like the following:
+
+```bash
+...
+if  -n "${MESON_PROJECT_NAME-}" ;
+then
+  PS1+=" ${MESON_PROJECT_NAME} "
+fi
+...
+```
+
+These variables are set in environment in addition to those set using meson.add_devenv:
+- `MESON_DEVENV` is defined to `'1'`.
+- `MESON_PROJECT_NAME` is defined to the main project's name.
+- `PKG_CONFIG_PATH` includes the directory where Meson generates `-uninstalled.pc`
+  files.
+- `PATH` includes every directory where there is an executable that would be
+  installed into `bindir`. On windows it also includes every directory where there
+  is a DLL needed to run those executables.
+- `LD_LIBRARY_PATH` includes every directory where there is a shared library that
+  would be installed into `libdir`. This allows to run system application using
+  custom build of some libraries. For example running system GEdit when building
+  GTK from git. On OSX the environment variable is `DYLD_LIBRARY_PATH` and
+  `PATH` on Windows.
+- `GI_TYPELIB_PATH` includes every directory where a GObject Introspection
+  typelib is built. This is automatically set when using `gnome.generate_gir()`.
+- `GSETTINGS_SCHEMA_DIR` *Since 0.59.0* includes every directory where a GSettings
+  schemas is compiled. This is automatically set when using `gnome.compile_schemas()`.
+  Note that this requires GLib >= 2.64 when `gnome.compile_schemas()` is used in
+  more than one directory.
+- `QEMU_LD_PREFIX` *Since 1.0.0* is set to the `sys_root` value from cross file
+  when cross compiling and that property is defined.
+
+Since *Since 0.62.0* if bash-completion scripts are being installed and the
+shell is bash, they will be automatically sourced.
+
+Since *Since 0.62.0* when GDB helper scripts (*-gdb.py, *-gdb.gdb, and *-gdb.csm)
+are installed with a library name that matches one being built, Meson adds the
+needed auto-load commands into `<builddir>/.gdbinit` file. When running gdb from
+top build directory, that file is loaded by gdb automatically. In the case of
+python scripts that needs to load other python modules, `PYTHONPATH` may need
+to be modified using `meson.add_devenv()`.
+
+Since *Since 0.63.0* when cross compiling for Windows `WINEPATH` is used instead
+of `PATH` which allows running Windows executables using wine. Note that since
+`WINEPATH` size is currently limited to 1024 characters, paths relative to the
+root of build directory are used. That means current workdir must be the root of
+build directory when running wine.
+
+{{ devenv_arguments.inc }}

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/Comparisons.md Added

@@ -0,0 +1,78 @@
+---
+title: Comparisons
+...
+
+# Comparing Meson with other build systems
+
+A common question is *Why should I choose Meson over a different build
+system X?* There is no one true answer to this as it depends on the
+use case. Almost all build systems have all the functionality needed
+to build medium-to-large projects so the decision is usually made on
+other points. Here we list some pros and cons of various build systems
+to help you do the decision yourself.
+
+## GNU Autotools
+
+### Pros
+
+Excellent support for legacy Unix platforms, large selection of
+existing modules.
+
+### Cons
+
+Needlessly slow, complicated, hard to use correctly, unreliable,
+painful to debug, incomprehensible for most people, poor support for
+non-Unix platforms (especially Windows).
+
+## CMake
+
+### Pros
+
+Great support for multiple backends (Visual Studio, XCode, etc).
+
+### Cons
+
+The scripting language is cumbersome to work with. Some simple things
+are more complicated than necessary.
+
+## SCons
+
+### Pros
+
+Full power of Python available for defining your build.
+
+### Cons
+
+Slow. Requires you to pass your configuration settings on every
+invocation. That is, if you do `scons OPT1 OPT2` and then just
+`scons`, it will reconfigure everything without settings `OPT1` and
+`OPT2`. Every other build system remembers build options from the
+previous invocation.
+
+## Bazel
+
+### Pros
+
+Proven to scale to very large projects.
+
+### Cons
+
+Implemented in Java. Poor Windows support. Heavily focused on Google's
+way of doing things (which may be a good or a bad thing). Contributing
+code requires signing a CLA(https://bazel.build/contributing.html).
+
+## Meson
+
+### Pros
+
+The fastest build system see
+measurements(Performance-comparison.md), user friendly, designed to
+be as invisible to the developer as possible, native support for
+modern tools (precompiled headers, coverage, Valgrind etc). Not Turing
+complete so build definition files are easy to read and understand.
+
+### Cons
+
+Relatively new so it does not have a large user base yet, and may thus
+contain some unknown bugs. Visual Studio and XCode backends not as
+high quality as Ninja one.

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/Compiler-properties.md Added

@@ -0,0 +1,231 @@
+# Compiler properties
+
+Not all compilers and platforms are alike. Therefore Meson provides
+the tools to detect properties of the system during configure time. To
+get most of this information, you first need to extract the *compiler
+object(Reference-manual_returned_compiler.html)* from the main
+*meson* variable.
+
+```meson
+compiler = #meson.get_compiler('c')
+```
+
+Here we extract the C compiler. We could also have given the argument
+`cpp` to get the C++ compiler, `objc` to get the objective C compiler
+and so on. The call is valid for all languages specified in the
+*project* declaration. Trying to obtain some other compiler will lead
+to an unrecoverable error.
+
+## System information
+
+This is a bit complex and more thoroughly explained on the page on
+cross compilation(Cross-compilation.md). But if you just want to
+know the operating system your code will run on, issue this command:
+
+```meson
+host_machine.system()
+```
+
+## Compiler id
+
+The compiler object method compiler.get_id returns a
+lower case string describing the "family" of the compiler. Since 0.53.0
+compiler.get_linker_id returns a lower case string with the linker name. Since
+compilers can often choose from multiple linkers depending on operating
+system, `get_linker_id` can be useful for handling or mitigating effects
+of particular linkers.
+
+The compiler object also has a method compiler.get_argument_syntax which
+returns a lower case string of `gcc`, `msvc`, or another undefined string
+value; identifying whether the compiler arguments use the same syntax as
+either `gcc` or `msvc`, or that its arguments are not like either. This should
+only be used to select the syntax of the arguments, such as those to test
+with compiler.has_argument.
+
+See reference tables(Reference-tables.md#compiler-ids) for a list of
+supported compiler ids and their argument type.
+
+## Does code compile?
+
+Sometimes the only way to test the system is to try to compile some
+sample code and see if it works. For example, this can test that a
+"C++17" compiler actually supports a particular C++17 feature,
+without resorting to maintaining a feature list vs. compiler vendor,
+compiler version and operating system.
+Testing that a code snippet runs is a two-phase operation. First
+we define some code using the multiline string operator:
+
+```meson
+code = '''#include<stdio.h>
+void func() { printf("Compile me.\n"); }
+'''
+```
+
+Then we can run the test.
+
+```meson
+result = #compiler.compiles(code, name : 'basic check')
+```
+
+The variable *result* will now contain either `true` or `false`
+depending on whether the compilation succeeded or not. The keyword
+argument `name` is optional. If it is specified, Meson will write the
+result of the check to its log.
+
+## Does code compile and link?
+
+Sometimes it is necessary to check whether a certain code fragment not
+only compiles, but also links successfully, e.g. to check if a symbol
+is actually present in a library. This can be done using the
+compiler.links method like this:
+
+```meson
+code = '''#include<stdio.h>
+void func() { printf("Compile me.\n"); }
+'''
+```
+
+Then we can run the test.
+
+```meson
+result = #compiler.links(code, args : '-lfoo', name : 'link check')
+```
+
+The variable *result* will now contain either `true` or `false`
+depending on whether the compilation and linking succeeded or not. The
+keyword argument `name` is optional. If it is specified, Meson will
+write the result of the check to its log.
+
+## Compile and run test application
+
+Here is how you would compile and run a small test application.
+Testing if a code snippets **runs** versus merely that it links
+is particularly important for some dependencies such as MPI.
+
+```meson
+code = '''#include<stdio.h>
+int main(int argc, char **argv) {
+  printf("%s\n", "stdout");
+  fprintf(stderr, "%s\n", "stderr");
+  return 0;
+}
+'''
+result = #compiler.run(code, name : 'basic check')
+```
+
+The `result` variable encapsulates the state of the test, which can be
+extracted with the following methods. The `name` keyword argument
+works the same as with `compiles`.
+
+| Method     | Return value                                                                                |
+| ------     | ------------                                                                                |
+| compiled   | `True` if compilation succeeded. If `false` then all other methods return undefined values. |
+| returncode | The return code of the application as an integer                                            |
+| stdout     | Program's standard out as text.                                                             |
+| stderr     | Program's standard error as text.                                                           |
+
+Here is an example usage:
+
+```meson
+if result.stdout().strip() == 'some_value'
+  # do something
+endif
+```
+
+## Does a header exist?
+
+Header files provided by different platforms vary quite a lot. Meson
+has functionality to detect whether a given header file is available
+on the system. The test is done by trying to compile a simple test
+program that includes the specified header. The following snippet
+describes how this feature can be used.
+
+```meson
+if #compiler.has_header('sys/fstat.h')
+  # header exists, do something
+endif
+```
+
+## Expression size
+
+Often you need to determine the size of a particular element (such as
+`int`, `wchar_t` or `char*`). Using the `compiler` variable mentioned
+above, the check can be done like this.
+
+```meson
+wcharsize = #compiler.sizeof('wchar_t', prefix : '#include<wchar.h>')
+```
+
+This will put the size of `wchar_t` as reported by sizeof into
+variable `wcharsize`. The keyword argument `prefix` is optional. If
+specified its contents is put at the top of the source file. This
+argument is typically used for setting `#include` directives in
+configuration files.
+
+In older versions (<= 0.30) Meson would error out if the size could
+not be determined. Since version 0.31 it returns -1 if the size could
+not be determined.
+
+## Does a function exist?
+
+Just having a header doesn't say anything about its contents.
+Sometimes you need to explicitly check if some function exists. This
+is how we would check whether the function `open_memstream` exists in
+header `stdio.h`
+
+```meson
+if #compiler.has_function('open_memstream', prefix : '#include <stdio.h>')
+  # function exists, do whatever is required.
+endif
+```
+
+Note that, on macOS programs can be compiled targeting older macOS
+versions than the one that the program is compiled on. It can't be
+assumed that the OS version that is compiled on matches the OS version
+that the binary will run on.
+
+Therefore when detecting function availability with compiler.has_function, it
+is important to specify the correct header in the prefix argument.
+
+In the example above, the function `open_memstream` is detected, which
+was introduced in macOS 10.13. When the user builds on macOS 10.13,
+but targeting macOS 10.11 (`-mmacosx-version-min=10.11`), this will
+correctly report the function as missing. Without the header however,
+it would lack the necessary availability information and incorrectly
+report the function as available.
+
+## Does a structure contain a member?
+
+Some platforms have different standard structures. Here's how one
+would check if a struct called `mystruct` from header `myheader.h`
+contains a member called `some_member`.
+
+```meson
+if #compiler.has_member('struct mystruct', 'some_member', prefix : '#include<myheader.h>')
+  # member exists, do whatever is required
+endif
+```
+
+## Type alignment
+
+Most platforms can't access some data types at any address. For
+example it is common that a `char` can be at any address but a 32 bit
+integer only at locations which are divisible by four. Determining the
+alignment of data types is simple.
+
+```meson
+int_alignment = #compiler.alignment('int') # Will most likely contain the value 4.
+```
+
+## Has argument
+
+This method tests if the compiler supports a given command line
+argument. This is implemented by compiling a small file with the given
+argument.
+
+```meson
+has_special_flags = #compiler.has_argument('-Wspecialthing')
+```
+
+*Note*: some compilers silently swallow command line arguments they do
+not understand. Thus this test can not be made 100% reliable.

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/Conference-presentations.md Added

@@ -0,0 +1,31 @@
+# Conference presentations on Meson
+
+- FOSDEM 2014, Introducing the Meson build
+  system(https://video.fosdem.org/2014/H2215_Ferrer/Sunday/Introducing_the_Meson_build_system.webm)
+  (jpakkane)
+
+- LCA 2015, Making build systems not
+  suck(https://www.youtube.com/watch?v=KPi0AuVpxLI) (jpakkane)
+
+- GUADEC 2015, Improving the way Gnome apps are
+  built(https://www.youtube.com/watch?v=wTf0NjjNwTU) (jpakkane)
+
+- GStreamer conference 2015, Done in 6.0
+  seconds(https://gstconf.ubicast.tv/videos/done-in-60-seconds-a-new-build-system-for-gstreamer)
+  (jpakkane)
+
+- LCA 2016, Builds, dependencies and deployment in the modern
+  multiplatform world(https://www.youtube.com/watch?v=CTJtKtQ8R5k)
+  (jpakkane)
+
+- GUADEC 2016, Making your GNOME app compile 2.4x
+  faster(https://media.ccc.de/v/44-making_your_gnome_app_compile_24x_faster)
+  (nirbheek)
+
+- Libre Application Summit 2016, New world, new
+  tools(https://youtu.be/0-gx1qU2pPo) (jpakkane)
+
+- GStreamer conference 2016, GStreamer Development on Windows and
+  faster builds everywhere with
+  Meson(https://gstconf.ubicast.tv/videos/gstreamer-development-on-windows-ans-faster-builds-everywhere-with-meson/)
+  (tpm)

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/Configuration.md Added

@@ -0,0 +1,198 @@
+---
+short-description: Build-time configuration options
+...
+
+# Configuration
+
+If there are multiple configuration options, passing them through
+compiler flags becomes very burdensome. It also makes the
+configuration settings hard to inspect. To make things easier, Meson
+supports the generation of configure files. This feature is similar to
+one found in other build systems such as CMake.
+
+Suppose we have the following Meson snippet:
+
+```meson
+conf_data = #configuration_data
+conf_data.set('version', '1.2.3')
+#configure_file(input : 'config.h.in',
+               output : 'config.h',
+               configuration : conf_data)
+```
+
+and that the contents of `config.h.in` are
+
+```c
+#define VERSION_STR "@version@"
+```
+
+Meson will then create a file called `config.h` in the corresponding
+build directory whose contents are the following.
+
+```c
+#define VERSION_STR "1.2.3"
+```
+
+More specifically, Meson will find all strings of the type `@varname@`
+and replace them with respective values set in `conf_data`. You can
+use a single `configuration_data` object as many times as you like,
+but it becomes immutable after being passed to the `configure_file`
+function. That is, after it has been used once to generate output the
+`set` function becomes unusable and trying to call it causes an error.
+Copy of immutable `configuration_data` is still immutable.
+
+For more complex configuration file generation Meson provides a second
+form. To use it, put a line like this in your configuration file.
+
+    #mesondefine TOKEN
+
+The replacement that happens depends on what the value and type of TOKEN is:
+
+```c
+#define TOKEN     // If TOKEN is set to boolean true.
+#undef TOKEN      // If TOKEN is set to boolean false.
+#define TOKEN 4   // If TOKEN is set to an integer or string value.
+/* undef TOKEN */ // If TOKEN has not been set to any value.
+```
+
+Note that if you want to define a C string, you need to do the quoting
+yourself like this:
+
+```meson
+conf_data.set('TOKEN', '"value"')
+```
+
+Since this is such a common operation, Meson provides a convenience
+method:
+
+```meson
+plain_var = 'value'
+conf_data.set_quoted('TOKEN', plain_var) # becomes #define TOKEN "value"
+```
+
+Often you have a boolean value in Meson but need to define the C/C++
+token as 0 or 1. Meson provides a convenience function for this use
+case.
+
+```meson
+conf_data.set10(token, boolean_value)
+# The line above is equivalent to this:
+if boolean_value
+  conf_data.set(token, 1)
+else
+  conf_data.set(token, 0)
+endif
+```
+
+## Configuring without an input file
+
+If the input file is not defined then Meson will generate a header
+file all the entries in the configuration data object. The
+replacements are the same as when generating `#mesondefine` entries:
+
+```meson
+conf_data.set('FOO', '"string"') => #define FOO "string"
+conf_data.set('FOO', 'a_token')  => #define FOO a_token
+conf_data.set('FOO', true)       => #define FOO
+conf_data.set('FOO', false)      => #undef FOO
+conf_data.set('FOO', 1)          => #define FOO 1
+conf_data.set('FOO', 0)          => #define FOO 0
+```
+
+In this mode, you can also specify a comment which will be placed
+before the value so that your generated files are self-documenting.
+
+```meson
+conf_data.set('BAR', true, description : 'Set BAR if it is available')
+```
+
+Will produce:
+
+```c
+/* Set BAR if it is available */
+#define BAR
+```
+
+## Dealing with file encodings
+
+The default Meson file encoding to configure files is utf-8. If you
+need to configure a file that is not utf-8 encoded the encoding
+keyword will allow you to specify which file encoding to use. It is
+however strongly advised to convert your non utf-8 file to utf-8
+whenever possible. Supported file encodings are those of python3, see
+standard-encodings(https://docs.python.org/3/library/codecs.html#standard-encodings).
+
+## Using dictionaries
+
+Since *0.49.0* configuration_data takes an optional dictionary as
+first argument. If provided, each key/value pair is added into the
+`configuration_data` as if `set()` method was called for each of them.
+configure_file's `configuration` kwarg also accepts a dictionary
+instead of a configuration_data object.
+
+Example:
+```meson
+cdata = configuration_data({
+  'STRING' : '"foo"',
+  'INT' : 42,
+  'DEFINED' : true,
+  'UNDEFINED' : false,
+})
+
+configure_file(output : 'config1.h',
+  configuration : cdata,
+)
+
+configure_file(output : 'config2.h',
+  configuration : {
+    'STRING' : '"foo"',
+    'INT' : 42,
+    'DEFINED' : true,
+    'UNDEFINED' : false,
+  }
+)
+
+```
+
+# A full example
+
+Generating and using a configuration file requires the following steps:
+
+ - generate the file
+ - create an include directory object for the directory that holds the file
+ - use it in a target
+
+We are going to use the traditional approach of generating a header
+file in the top directory. The common name is `config.h` but we're
+going to use an unique name. This avoids the problem of accidentally
+including the wrong header file when building a project with many
+subprojects.
+
+At the top level we generate the file:
+
+```meson
+conf_data = configuration_data()
+# Set data
+configure_file(input : 'projconfig.h.in',
+  output : 'projconfig.h',
+  configuration : conf_data)
+```
+
+Immediately afterwards we generate the include object.
+
+```meson
+configuration_inc = include_directories('.')
+```
+
+Finally we specify this in a target that can be in any subdirectory.
+
+```meson
+executable(..., include_directories : configuration_inc)
+```
+
+Now any source file in this target can include the configuration
+header like this:
+
+```c
+#include<projconfig.h>
+```

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/Configuring-a-build-directory.md Added

@@ -0,0 +1,121 @@
+---
+short-description: Configuring a pre-generated build directory
+...
+
+# Configuring a build directory
+
+Often you want to change the settings of your build after it has been
+generated. For example you might want to change from a debug build
+into a release build, set custom compiler flags, change the build
+options provided in your `meson_options.txt` file and so on.
+
+The main tool for this is the `meson configure` command.
+
+You invoke `meson configure` by giving it the location of your build
+dir. If omitted, the current working directory is used instead. Here's
+a sample output for a simple project.
+
+    Core properties
+
+    Source dir /home/jpakkane/clangdemo/2_address
+    Build dir  /home/jpakkane/clangdemo/2_address/buildmeson
+
+    Core options:
+      Option          Current Value Possible Values                                            Description
+      ------          ------------- ---------------                                            -----------
+      auto_features   auto          enabled, disabled, auto                                  Override value of all 'auto' features
+      backend         ninja         ninja, vs, vs2010, vs2015, vs2017, vs2019, vs2022, xcode Backend to use
+      buildtype       release       plain, debug, debugoptimized, release, minsize, custom   Build type to use
+      debug           false         true, false                                              Debug
+      default_library shared        shared, static, both                                     Default library type
+      install_umask   0022          preserve, 0000-0777                                      Default umask to apply on permissions of installed files
+      layout          mirror        mirror, flat                                             Build directory layout
+      optimization    3             plain, 0, g, 1, 2, 3, s                                  Optimization level
+      prefer_static   false         true, false                                              Whether to try static linking before shared linking
+      strip           false         true, false                                              Strip targets on install
+      unity           off           on, off, subprojects                                     Unity build
+      warning_level   1             0, 1, 2, 3, everything                                   Compiler warning level to use
+      werror          false         true, false                                              Treat warnings as errors
+
+    Backend options:
+      Option            Current Value Possible Values Description
+      ------            ------------- --------------- -----------
+      backend_max_links 0             >=0             Maximum number of linker processes to run or 0 for no limit
+
+    Base options:
+      Option      Current Value Possible Values                                               Description
+      ------      ------------- ---------------                                               -----------
+      b_asneeded  true          true, false                                                 Use -Wl,--as-needed when linking
+      b_colorout  always        auto, always, never                                         Use colored output
+      b_coverage  false         true, false                                                 Enable coverage tracking.
+      b_lto       false         true, false                                                 Use link time optimization
+      b_lundef    true          true, false                                                 Use -Wl,--no-undefined when linking
+      b_ndebug    false         true, false, if-release                                     Disable asserts
+      b_pch       true          true, false                                                 Use precompiled headers
+      b_pgo       off           off, generate, use                                          Use profile guided optimization
+      b_sanitize  none          none, address, thread, undefined, leak, memory, address,undefined Code sanitizer to use
+      b_staticpic true          true, false                                                 Build static libraries as position independent
+
+    Compiler options:
+      Option        Current Value Possible Values                                                                                               Description
+      ------        ------------- ---------------                                                                                               -----------
+      c_args                                                                                                                                  Extra arguments passed to the C compiler
+      c_link_args                                                                                                                             Extra arguments passed to the C linker
+      c_std         c99           none, c89, c99, c11, c17, c18, c2x, gnu89, gnu99, gnu11, gnu17, gnu18, gnu2x                                C language standard to use
+      cpp_args                                                                                                                                Extra arguments passed to the C++ compiler
+      cpp_debugstl  false         true, false                                                                                                 STL debug mode
+      cpp_link_args                                                                                                                           Extra arguments passed to the C++ linker
+      cpp_std       c++11         none, c++98, c++03, c++11, c++14, c++17, c++1z, c++2a, c++20, gnu++03, gnu++11, gnu++14, gnu++17, gnu++1z, gnu++2a, gnu++20 C++ language standard to use
+      fortran_std               none, legacy, f95, f2003, f2008, f2018                                                                      language standard to use
+
+    Directories:
+      Option         Current Value        Description
+      ------         -------------        -----------
+      bindir         bin                  Executable directory
+      datadir        share                Data file directory
+      includedir     include              Header file directory
+      infodir        share/info           Info page directory
+      libdir         lib/x86_64-linux-gnu Library directory
+      libexecdir     libexec              Library executable directory
+      localedir      share/locale         Locale data directory
+      localstatedir  /var/local           Localstate data directory
+      mandir         share/man            Manual page directory
+      prefix         /usr/local           Installation prefix
+      sbindir        sbin                 System executable directory
+      sharedstatedir /var/local/lib       Architecture-independent data directory
+      sysconfdir     etc                  Sysconf data directory
+
+    Project options:
+      Option         Current Value Possible Values           Description
+      ------         ------------- ---------------           -----------
+      array_opt      one, two    one, two, three         array_opt
+      combo_opt      three         one, two, three         combo_opt
+      free_array_opt one, two                              free_array_opt
+      integer_opt    3             >=0, <=5                  integer_opt
+      other_one      false         true, false             other_one
+      some_feature   enabled       enabled, disabled, auto some_feature
+      someoption     optval                                  An option
+
+    Testing options:
+      Option    Current Value Possible Values Description
+      ------    ------------- --------------- -----------
+      errorlogs true          true, false   Whether to print the logs from failing tests
+      stdsplit  true          true, false   Split stdout and stderr in test logs
+
+These are all the options available for the current project arranged
+into related groups. The first column in every field is the name of
+the option. To set an option you use the `-D` option. For example,
+changing the installation prefix from `/usr/local` to `/tmp/testroot`
+you would issue the following command.
+
+    meson configure -Dprefix=/tmp/testroot
+
+Then you would run your build command (usually `meson compile`), which
+would cause Meson to detect that the build setup has changed and do
+all the work required to bring your build tree up to date.
+
+Since 0.50.0, it is also possible to get a list of all build options
+by invoking `meson configure`(Commands.md#configure) with the
+project source directory or the path to the root `meson.build`. In
+this case, Meson will print the default values of all options similar
+to the example output from above.

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/Contact-information.md Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/Continuous-Integration.md Added

@@ -0,0 +1,279 @@
+# Continuous Integration
+
+Here you will find snippets to use Meson with various CI such as
+Travis and AppVeyor.
+
+Please file an issue(https://github.com/mesonbuild/meson/issues/new)
+if these instructions don't work for you.
+
+## Travis-CI with Docker
+
+Travis with Docker gives access to newer non-LTS Ubuntu versions with
+pre-installed libraries of your choice.
+
+This `yml` file is derived from the
+configuration used by Meson(https://github.com/mesonbuild/meson/blob/master/.travis.yml)
+for running its own tests.
+
+```yaml
+os:
+  - linux
+  - osx
+
+language:
+  - cpp
+
+services:
+  - docker
+
+before_install:
+  - if  "$TRAVIS_OS_NAME" == "osx" ; then brew update; fi
+  - if  "$TRAVIS_OS_NAME" == "osx" ; then brew install python3 ninja; fi
+  - if  "$TRAVIS_OS_NAME" == "osx" ; then pip3 install meson; fi
+  - if  "$TRAVIS_OS_NAME" == "linux" ; then docker pull YOUR/REPO:eoan; fi
+
+script:
+  - if  "$TRAVIS_OS_NAME" == "linux" ; then echo FROM YOUR/REPO:eoan > Dockerfile; fi
+  - if  "$TRAVIS_OS_NAME" == "linux" ; then echo ADD . /root >> Dockerfile; fi
+  - if  "$TRAVIS_OS_NAME" == "linux" ; then docker build -t withgit .; fi
+  - if  "$TRAVIS_OS_NAME" == "linux" ; then docker run withgit /bin/sh -c "cd /root && TRAVIS=true CC=$CC CXX=$CXX meson setup builddir && meson test -C builddir"; fi
+  - if  "$TRAVIS_OS_NAME" == "osx" ; then SDKROOT=$(xcodebuild -version -sdk macosx Path) meson setup builddir && meson test -C builddir; fi
+```
+
+## CircleCi for Linux (with Docker)
+
+CircleCi(https://circleci.com/) can work for spinning all of the
+Linux images you wish. Here's a sample `yml` file for use with that.
+
+```yaml
+version: 2.1
+
+executors:
+  # Your dependencies would go in the docker images that represent
+  # the Linux distributions you are supporting
+  meson_ubuntu_builder:
+    docker:
+      - image: your_dockerhub_username/ubuntu-sys
+
+  meson_debian_builder:
+    docker:
+      - image: your_dockerhub_username/debian-sys
+
+  meson_fedora_builder:
+    docker:
+      - image: your_dockerhub_username/fedora-sys
+
+jobs:
+  meson_ubuntu_build:
+    executor: meson_ubuntu_builder
+    steps:
+      - checkout
+      - run: meson setup builddir --backend ninja
+      - run: meson compile -C builddir
+      - run: meson test -C builddir
+
+  meson_debian_build:
+    executor: meson_debian_builder
+    steps:
+      - checkout
+      - run: meson setup builddir --backend ninja
+      - run: meson compile -C builddir
+      - run: meson test -C builddir
+
+  meson_fedora_build:
+    executor: meson_fedora_builder
+    steps:
+      - checkout
+      - run: meson setup builddir --backend ninja
+      - run: meson compile -C builddir
+      - run: meson test -C builddir
+
+workflows:
+  version: 2
+  linux_workflow:
+    jobs:
+      - meson_ubuntu_build
+      - meson_debian_build
+      - meson_fedora_build
+```
+
+## AppVeyor for Windows
+
+For CI on Windows, AppVeyor(https://www.appveyor.com/) has a wide
+selection of default
+configurations(https://www.appveyor.com/docs/windows-images-software/).
+AppVeyor also has
+MacOS(https://www.appveyor.com/docs/macos-images-software/) and
+Linux(https://www.appveyor.com/docs/linux-images-software/) CI
+images. This is a sample `appveyor.yml` file for Windows with Visual
+Studio 2015 and 2017.
+
+```yaml
+image: Visual Studio 2017
+
+environment:
+  matrix:
+    - arch: x86
+      compiler: msvc2015
+    - arch: x64
+      compiler: msvc2015
+    - arch: x86
+      compiler: msvc2017
+    - arch: x64
+      compiler: msvc2017
+
+platform:
+  - x64
+
+install:
+  # Set paths to dependencies (based on architecture)
+  - cmd: if %arch%==x86 (set PYTHON_ROOT=C:\python37) else (set PYTHON_ROOT=C:\python37-x64)
+  # Print out dependency paths
+  - cmd: echo Using Python at %PYTHON_ROOT%
+  # Add necessary paths to PATH variable
+  - cmd: set PATH=%cd%;%PYTHON_ROOT%;%PYTHON_ROOT%\Scripts;%PATH%
+  # Install meson and ninja
+  - cmd: pip install ninja meson
+  # Set up the build environment
+  - cmd: if %compiler%==msvc2015 ( call "C:\Program Files (x86)\Microsoft Visual Studio 14.0\VC\vcvarsall.bat" %arch% )
+  - cmd: if %compiler%==msvc2017 ( call "C:\Program Files (x86)\Microsoft Visual Studio\2017\Community\VC\Auxiliary\Build\vcvarsall.bat" %arch% )
+
+build_script:
+  - cmd: echo Building on %arch% with %compiler%
+  - cmd: meson --backend=ninja builddir
+  - cmd: meson compile -C builddir
+
+test_script:
+  - cmd: meson test -C builddir
+```
+
+### Qt
+
+For Qt 5, add the following line near the `PYTHON_ROOT` assignment:
+
+```yaml
+ - cmd: if %arch%==x86 (set QT_ROOT=C:\Qt\5.11\%compiler%) else (set QT_ROOT=C:\Qt\5.11\%compiler%_64)
+```
+
+And afterwards add `%QT_ROOT%\bin` to the `PATH` variable.
+
+You might have to adjust your build matrix as there are, for example,
+no msvc2017 32-bit builds. Visit the Build
+Environment(https://www.appveyor.com/docs/build-environment/) page in
+the AppVeyor docs for more details.
+
+### Boost
+
+The following statement is sufficient for Meson to find Boost:
+
+```yaml
+ - cmd: set BOOST_ROOT=C:\Libraries\boost_1_67_0
+```
+
+## Travis without Docker
+
+Non-Docker Travis-CI builds can use Linux, MacOS or Windows.
+Set the desired compiler(s) in the build **matrix**.
+This example is for **Linux** (Ubuntu 18.04) and **C**.
+
+```yaml
+dist: bionic
+group: travis_latest
+
+os: linux
+language: python
+
+matrix:
+  include:
+    - env: CC=gcc
+    - env: CC=clang
+
+install:
+  - pip install meson ninja
+
+script:
+  - meson setup builddir
+  - meson compile -C builddir
+  - meson test -C builddir
+```
+
+## GitHub Actions
+
+GitHub Actions are distinct from Azure Pipelines in their workflow
+syntax. It can be easier to setup specific CI tasks in Actions than
+Pipelines, depending on the particular task. This is an example file:
+.github/workflows/ci_meson.yml supposing the project is C-based, using
+GCC on Linux, Mac and Windows. The optional `on:` parameters only run
+this CI when the C code is changed--corresponding ci_python.yml might
+run only on "**.py" file changes.
+
+```yaml
+name: ci_meson
+
+on:
+  push:
+    paths:
+      - "**.c"
+      - "**.h"
+  pull_request:
+    paths:
+      - "**.c"
+      - "**.h"
+
+jobs:
+
+  linux:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v1
+    - uses: actions/setup-python@v1
+      with:
+        python-version: '3.x'
+    - run: pip install meson ninja
+    - run: meson setup builddir/
+      env:
+        CC: gcc
+    - run: meson test -C builddir/ -v
+    - uses: actions/upload-artifact@v1
+      if: failure()
+      with:
+        name: Linux_Meson_Testlog
+        path: builddir/meson-logs/testlog.txt
+
+  macos:
+    runs-on: macos-latest
+    steps:
+    - uses: actions/checkout@v1
+    - uses: actions/setup-python@v1
+      with:
+        python-version: '3.x'
+    - run: brew install gcc
+    - run: pip install meson ninja
+    - run: meson setup builddir/
+      env:
+        CC: gcc
+    - run: meson test -C builddir/ -v
+    - uses: actions/upload-artifact@v1
+      if: failure()
+      with:
+        name: MacOS_Meson_Testlog
+        path: builddir/meson-logs/testlog.txt
+
+  windows:
+    runs-on: windows-latest
+    steps:
+    - uses: actions/checkout@v1
+    - uses: actions/setup-python@v1
+      with:
+        python-version: '3.x'
+    - run: pip install meson ninja
+    - run: meson setup builddir/
+      env:
+        CC: gcc
+    - run: meson test -C builddir/ -v
+    - uses: actions/upload-artifact@v1
+      if: failure()
+      with:
+        name: Windows_Meson_Testlog
+        path: builddir/meson-logs/testlog.txt
+```

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/Contributing.md Added

@@ -0,0 +1,585 @@
+---
+short-description: Contributing to Meson
+...
+
+# Contributing to Meson
+
+A large fraction of Meson is contributed by people outside the core
+team. This documentation explains some of the design rationales of
+Meson as well as how to create and submit your patches for inclusion
+to Meson.
+
+Thank you for your interest in participating to the development.
+
+## Submitting patches
+
+All changes must be submitted as pull requests to
+Github(https://github.com/mesonbuild/meson/pulls). This causes them
+to be run through the CI system. All submissions must pass a full CI
+test run before they are even considered for submission.
+
+## Keeping pull requests up to date
+
+It is possible that while your pull request is being reviewed, other
+changes are committed to master that cause merge conflicts that must
+be resolved. The basic rule for this is very simple: keep your pull
+request up to date using rebase _only_.
+
+Do not merge head back to your branch. Any merge commits in your pull
+request make it not acceptable for merging into master and you must
+remove them.
+
+## Special procedure for new features
+
+Every new feature requires some extra steps, namely:
+
+- Must include a project test under `test cases/`, or if that's not
+  possible or if the test requires a special environment, it must go
+  into `run_unittests.py`.
+- Must be registered with the FeatureChecks
+  framework(Release-notes-for-0.47.0.md#feature-detection-based-on-meson_version-in-project)
+  that will warn the user if they try to use a new feature while
+  targeting an older Meson version.
+- Needs a release note snippet inside `docs/markdown/snippets/` with
+  a heading and a brief paragraph explaining what the feature does
+  with an example.
+
+## Acceptance and merging
+
+The kind of review and acceptance any merge proposal gets depends on
+the changes it contains. All pull requests must be reviewed and
+accepted by someone with commit rights who is not the original
+submitter. Merge requests can be roughly split into three different
+categories.
+
+The first one consists of MRs that only change the markdown
+documentation under `docs/markdown`. Anyone with access rights can
+push changes to these directly to master. For major changes it is
+still recommended to create a MR so other people can comment on it.
+
+The second group consists of merges that don't change any
+functionality, fixes to the CI system and bug fixes that have added
+regression tests (see below) and don't change existing
+functionality. Once successfully reviewed anyone with merge rights can
+merge these to master.
+
+The final kind of merges are those that add new functionality or
+change existing functionality in a backwards incompatible way. These
+require the approval of the project lead.
+
+In a simplified list form the split would look like the following:
+
+- members with commit access can do:
+  - documentation changes (directly to master if warranted)
+  - bug fixes that don't change functionality
+  - refactorings
+  - new dependency types
+  - new tool support (e.g. a new Doxygen-kind of tool)
+  - support for new compilers to existing languages
+- project leader decision is needed for:
+  - new modules
+  - new functions in the Meson language
+  - syntax changes for Meson files
+  - changes breaking backwards compatibility
+  - support for new languages
+
+## A green CI run is mandatory for merging
+
+No merge request may be merged until it has a fully green CI run. It
+does not matter why CI fails, it is a hard blocker. Even if the MR
+could possibly not have anything to do with the failure and clearly
+should be permitted, it may not be merged. Only MRs that fix the CI
+issue are allowed to land in trunk.
+
+There is one, and only one, exception to this. At the time of writing
+the Apple CI is unreliable and sometimes fails with clock skew errors.
+
+If a merge causes CI failure any developer can revert it out of
+master. It is then the responsibility of the original submitter to
+resubmit a fixed version.
+
+## Strategy for merging pull requests to trunk
+
+Meson's merge strategy should fulfill the following guidelines:
+
+- preserve as much history as possible
+
+- have as little junk in the repo as possible
+
+- everything in the "master lineage" should always pass all tests
+
+These goals are slightly contradictory so the correct thing to do
+often requires some judgement on part of the person doing the
+merge. Github provides three different merge options, The rules of
+thumb for choosing between them goes like this:
+
+- single commit pull requests should always be rebased
+
+- a pull request with one commit and one "fixup" commit (such as
+  testing something to see if it passes CI) should be squashed
+
+- large branches with many commits should be merged with a merge
+  commit, especially if one of the commits does not pass all tests
+  (which happens in e.g. large and difficult refactorings)
+
+If in doubt, ask for guidance on IRC.
+
+## Tests
+
+All new features must come with automatic tests that thoroughly prove
+that the feature is working as expected. Similarly bug fixes must come
+with a unit test that demonstrates the bug, proves that it has been
+fixed and prevents the feature from breaking in the future.
+
+Sometimes it is difficult to create a unit test for a given bug. If
+this is the case, note this in your pull request. We may permit bug
+fix merge requests in these cases. This is done on a case by case
+basis. Sometimes it may be easier to write the test than convince the
+maintainers that one is not needed. Exercise judgment and ask for help
+in problematic cases.
+
+The tests are split into two different parts: unit tests and full
+project tests. To run all tests, execute `./run_tests.py`. Unit tests
+can be run with `./run_unittests.py` and project tests with
+`./run_project_tests.py`.
+
+### Project tests
+
+Subsets of project tests can be selected with
+`./run_project_tests.py --only` option. This can save a great deal of
+time when only a certain part of Meson is being tested.
+For example, a useful and easy contribution to Meson is making
+sure the full set of compilers is supported. One could for example test
+various Fortran compilers by setting `FC=ifort` or `FC=flang` or similar
+with `./run_project_test.py --only fortran`.
+Some families of tests require a particular backend to run.
+For example, all the CUDA project tests run and pass on Windows via
+`./run_project_tests.py --only cuda --backend ninja`
+
+Each project test is a standalone project that can be compiled on its
+own. They are all in the `test cases` subdirectory. The simplest way to
+run a single project test is to do something like `./meson.py test\
+cases/common/1\ trivial builddir`. The one exception to this is `test
+cases/unit` directory discussed below.
+
+The test cases in the `common` subdirectory are meant to be run always
+for all backends. They should only depend on C and C++, without any
+external dependencies such as libraries. Tests that require those are
+in the `test cases/frameworks` directory. If there is a need for an
+external program in the common directory, such as a code generator, it
+should be implemented as a Python script. The goal of test projects is
+also to provide sample projects that end users can use as a base for
+their own projects.
+
+All project tests follow the same pattern: they are configured,
+compiled, tests are run and finally install is run. Passing means that
+configuring, building and tests succeed and that installed files match
+those expected.
+
+Any tests that require more thorough analysis, such as checking that
+certain compiler arguments can be found in the command line or that
+the generated pkg-config files actually work should be done with a
+unit test.
+
+Additionally:
+
+* `crossfile.ini` and `nativefile.ini` are passed to the configure step with
+`--cross-file` and `--native-file` options, respectively.
+
+* `mlog.cmd_ci_include()` can be called from anywhere inside Meson to
+capture the contents of an additional file into the CI log on failure.
+
+Projects needed by unit tests are in the `test cases/unit`
+subdirectory. They are not run as part of `./run_project_tests.py`.
+
+### Configuring project tests
+
+The (optional) `test.json` file, in the root of a test case, is used
+for configuring the test. All of the following root entries in the `test.json`
+are independent of each other and can be combined as needed.
+
+Example `test.json`:
+
+```json
+{
+  "env": {
+    "VAR": "VAL"
+  },
+  "installed": 
+    { "type": "exe", "file": "usr/bin/testexe" },
+    { "type": "pdb", "file": "usr/bin/testexe" },
+    { "type": "shared_lib", "file": "usr/lib/z", "version": "1.2.3" },
+  ,
+  "matrix": {
+    "options": {
+      "opt1": 
+        { "val": "abc"   },
+        { "val": "qwert" },
+        { "val": "bad"   }
+      ,
+      "opt2": 
+        { "val": null    },
+        { "val": "true"  },
+        { "val": "false" },
+      
+    },
+    "exclude": 
+      { "opt1": "qwert", "opt2": "false" },
+      { "opt1": "bad"                    }
+    
+  },
+  "tools": {
+    "cmake": ">=3.11"
+  }
+}
+```
+
+#### env
+
+The `env` key contains a dictionary which specifies additional
+environment variables to be set during the configure step of the test.
+
+There is some basic support for configuring the string with the `@<VAR>@` syntax:
+
+- `@ROOT@`: absolute path of the source directory
+- `@PATH@`: current value of the `PATH` env variable
+
+#### installed
+
+The `installed` dict contains a list of dicts, describing which files are expected
+to be installed. Each dict contains the following keys:
+
+- `file`
+- `type`
+- `platform` (optional)
+- `version` (optional)
+- `language` (optional)
+
+The `file` entry contains the relative path (from the install root) to the
+actually installed file.
+
+The `type` entry specifies how the `file` path should be interpreted based on the
+current platform. The following values are currently supported:
+
+| type          | Description                                                                                             |
+| ------------- | ------------------------------------------------------------------------------------------------------- |
+| `file`        | No postprocessing, just use the provided path                                                           |
+| `python_file` | Use the provided path while replacing the python directory.                                             |
+| `dir`         | To include all files inside the directory (for generated docs, etc). The path must be a valid directory |
+| `exe`         | For executables. On Windows the `.exe` suffix is added to the path in `file`                            |
+| `shared_lib`  | For shared libraries, always written as `name`. The appropriate suffix and prefix are added by platform |
+| `python_lib`  | For python libraries, while replacing the python directory. The appropriate suffix is added by platform |
+| `pdb`         | For Windows PDB files. PDB entries are ignored on non Windows platforms                                 |
+| `implib`      | For Windows import libraries. These entries are ignored on non Windows platforms                        |
+| `py_implib`   | For Windows import libraries. These entries are ignored on non Windows platforms                        |
+| `implibempty` | Like `implib`, but no symbols are exported in the library                                               |
+| `expr`        | `file` is an expression. This type should be avoided and removed if possible                            |
+
+Except for the `file`, `python_file` and `expr` types, all paths should be provided *without* a suffix.
+
+| Argument   | Applies to                 | Description                                                                   |
+| -----------|----------------------------|-------------------------------------------------------------------------------|
+| `version`  | `shared_lib`, `pdb`        | Sets the version to look for appropriately per-platform                       |
+| `language` | `pdb`                      | Determines which compiler/linker determines the existence of this file        |
+
+The `shared_lib` and `pdb` types takes an optional additional
+parameter, `version`, this is us a string in `X.Y.Z` format that will
+be applied to the library. Each version to be tested must have a
+single version. The harness will apply this correctly per platform:
+
+The `python_file`, `python_lib`, and `py_implib` types have basic support for configuring the string with the `@<VAR>@` syntax:
+
+- `@PYTHON_PLATLIB@`: python `get_install_dir` directory relative to prefix
+- `@PYTHON_PURELIB@`: python `get_install_dir(pure: true)` directory relative to prefix
+
+`pdb` takes an optional `language` argument. This determines which
+compiler/linker should generate the pdb file. Because it's possible to
+mix compilers that do and don't generate pdb files (dmd's optlink
+doesn't). Currently this is only needed when mixing D and C code.
+
+```json
+{
+  "type": "shared_lib", "file": "usr/lib/lib",
+  "type": "shared_lib", "file": "usr/lib/lib", "version": "1",
+  "type": "shared_lib", "file": "usr/lib/lib", "version": "1.2.3.",
+}
+```
+
+This will be applied appropriately per platform. On windows this
+expects `lib.dll` and `lib-1.dll`. on MacOS it expects `liblib.dylib`
+and `liblib.1.dylib`. On other Unices it expects `liblib.so`,
+`liblib.so.1`, and `liblib.so.1.2.3`.
+
+If the `platform` key is present, the installed file entry is only
+considered if the platform matches. The following values for
+`platform` are currently supported:
+
+| platform   | Description                                                          |
+| ---------- | -------------------------------------------------------------------- |
+| `msvc`     | Matches when a msvc like compiler is used (`msvc`, `clang-cl`, etc.) |
+| `gcc`      | Not `msvc`                                                           |
+| `cygwin`   | Matches when the platform is cygwin                                  |
+| `!cygwin`  | Not `cygwin`                                                         |
+
+#### matrix
+
+The `matrix` section can be used to define a test matrix to run
+project tests with different Meson options.
+
+In the `options` dict, all possible options and their values are
+specified. Each key in the `options` dict is a Meson option. It stores
+a list of all potential values in a dict format.
+
+Each value must contain the `val` key for the value of the option.
+`null` can be used for adding matrix entries without the current
+option.
+
+The `skip_on_env`, `skip_on_jobname` and `skip_on_os` keys (as described below)
+may be used in the value to skip that matrix entry, based on the current
+environment.
+
+Similarly, the `compilers` key can be used to define a mapping of
+compilers to languages that are required for this value.
+
+```json
+{
+  "compilers": {
+    "c": "gcc",
+    "cpp": "gcc",
+    "d": "gdc"
+  }
+}
+```
+
+Specific option combinations can be excluded with the `exclude`
+section. It should be noted that `exclude` does not require exact
+matches. Instead, any matrix entry containing all option value
+combinations in `exclude` will be excluded. Thus an empty dict (`{}`)
+to will match **all** elements in the test matrix.
+
+The above example will produce the following matrix entries:
+- `opt1=abc`
+- `opt1=abc opt2=true`
+- `opt1=abc opt2=false`
+- `opt1=qwert`
+- `opt1=qwert opt2=true`
+
+#### do_not_set_opts
+
+Currently supported values are:
+- `prefix`
+- `libdir`
+
+#### tools
+
+This section specifies a dict of tool requirements in a simple
+key-value format. If a tool is specified, it has to be present in the
+environment, and the version requirement must be fulfilled. Otherwise,
+the entire test is skipped (including every element in the test
+matrix).
+
+#### stdout
+
+The `stdout` key contains a list of dicts, describing the expected
+stdout.
+
+Each dict contains the following keys:
+
+- `line`
+- `match` (optional)
+- `count` (optional)
+
+Each item in the list is matched, in order, against the remaining
+actual stdout lines, after any previous matches. If the actual stdout
+is exhausted before every item in the list is matched, the expected
+output has not been seen, and the test has failed.
+
+The `match` element of the dict determines how the `line` element is
+matched:
+
+| Type      | Description             |
+| --------  | ----------------------- |
+| `literal` | Literal match (default) |
+| `re`      | regex match             |
+
+The `count` element determines how many times the line is expected, and allowed,
+to be in the output. If unspecified, it must appear "any number of times, but at
+least once".
+
+#### skip_on_env
+
+The `skip_on_env` key can be used to specify a list of environment variables. If
+at least one environment variable in the `skip_on_env` list is present, the test
+is skipped.
+
+#### skip_on_jobname
+
+The `skip_on_jobname` key contains a list of strings. If the `MESON_CI_JOBNAME`
+environment variable is set, and any of them are a sub-string of it, the test is
+expected to be skipped (that is, it is expected that the test will output
+`MESON_SKIP_TEST`, because the CI environment is not one in which it can run,
+for whatever reason).
+
+The test is failed if it skips or runs unexpectedly.
+
+#### skip_on_os
+
+The `skip_on_os` key can be used to specify a list of OS names (or their
+negations, prefixed with a `!`).  If at least one item in the `skip_on_os` list
+is matched, the test is expected to be skipped.
+
+The test is failed if it skips or runs unexpectedly.
+
+### Skipping integration tests
+
+Meson uses several continuous integration testing systems that have
+slightly different interfaces for indicating a commit should be
+skipped.
+
+Continuous integration systems currently used:
+- Azure Pipelines(https://docs.microsoft.com/en-us/azure/devops/pipelines/scripts/git-commands?view=vsts&tabs=yaml#how-do-i-avoid-triggering-a-ci-build-when-the-script-pushes)
+  allows `***NO_CI***` in the commit message.
+- Sider(https://sider.review)
+  runs Flake8 (see below(#python-coding-style))
+
+To promote consistent naming policy, use:
+
+- `skip ci` in the commit title if you want to disable all
+  integration tests
+
+## Documentation
+
+The `docs` directory contains the full documentation that will be used
+to generate the Meson web site(https://mesonbuild.com). Line length
+in most cases should not exceed 70 characters (lines containing links
+or examples are usually exempt). Every change in functionality must
+change the documentation pages. In most cases this means updating the
+reference documentation page but bigger changes might need changes in
+other documentation, too.
+
+All new functionality needs to have a mention in the release
+notes. These features should be written in standalone files in the
+`docs/markdown/snippets` directory. The release manager will combine
+them into one page when doing the release.
+
+## Python Coding style
+
+Meson follows the basic Python coding style. Additional rules are the
+following:
+
+- indent 4 spaces, no tabs ever
+- indent meson.build files with two spaces
+- try to keep the code as simple as possible
+- contact the mailing list before embarking on large scale projects
+  to avoid wasted effort
+
+Meson uses Flake8 for style guide enforcement. The Flake8 options for
+the project are contained in .flake8.
+
+To run Flake8 on your local clone of Meson:
+
+```console
+$ python3 -m pip install flake8
+$ cd meson
+$ flake8
+```
+
+To run it automatically before committing:
+
+```console
+$ flake8 --install-hook=git
+$ git config --bool flake8.strict true
+```
+
+## C/C++ coding style
+
+Meson has a bunch of test code in several languages. The rules for
+those are simple.
+
+- indent 4 spaces, no tabs ever
+- brace always on the same line as if/for/else/function definition
+
+## External dependencies
+
+The goal of Meson is to be as easily usable as possible. The user
+experience should be "get Python3 and Ninja, run", even on
+Windows. Unfortunately this means that we can't have dependencies on
+projects outside of Python's standard library. This applies only to
+core functionality, though. For additional helper programs etc the use
+of external dependencies may be ok. If you feel that you are dealing
+with this kind of case, please contact the developers first with your
+use case.
+
+## Turing completeness
+
+The main design principle of Meson is that the definition language is
+not Turing complete. Any change that would make Meson Turing complete
+is automatically rejected. In practice this means that defining your
+own functions inside `meson.build` files and generalised loops will
+not be added to the language.
+
+## Do I need to sign a CLA in order to contribute?
+
+No you don't. All contributions are welcome.
+
+## No lingering state
+
+Meson operates in much the same way as functional programming
+languages. It has inputs, which include `meson.build` files, values of
+options, compilers and so on. These are passed to a function, which
+generates output build definition. This function is pure, which means that:
+
+- for any given input the output is always the same
+- running Meson twice in a row _always_ produce the same output in both runs
+
+The latter one is important, because it enforces that there is no way
+for "secret state" to pass between consecutive invocations of
+Meson. This is the reason why, for example, there is no `set_option`
+function even though there is a `get_option` one.
+
+If this were not the case, we could never know if the build output is
+"stable". For example suppose there were a `set_option` function and a
+boolean variable `flipflop`. Then you could do this:
+
+```meson
+set_option('flipflop', not get_option('flipflop'))
+```
+
+This piece of code would never converge. Every Meson run would change
+the value of the option and thus the output you get out of this build
+definition would be random.
+
+Meson does not permit this by forbidding these sorts of covert
+channels.
+
+There is one exception to this rule. Users can call into external
+commands with `run_command`. If the output of that command does not
+behave like a pure function, this problem arises. Meson does not try
+to guard against this case, it is the responsibility of the user to
+make sure the commands they run behave like pure functions.
+
+## Environment variables
+
+Environment variables are like global variables, except that they are
+also hidden by default. Envvars should be avoided whenever possible,
+all functionality should be exposed in better ways such as command
+line switches.
+
+## Random design points that fit nowhere else
+
+- All features should follow the 90/9/1 rule. 90% of all use cases
+  should be easy, 9% should be possible and it is totally fine to not
+  support the final 1% if it would make things too complicated.
+
+- Any build directory will have at most two toolchains: one native and
+  one cross.
+
+- Prefer specific solutions to generic frameworks. Solve the end
+  user's problems rather than providing them tools to do it
+  themselves.
+
+- Never use features of the Unix shell (or Windows shell for that
+  matter). Doing things like forwarding output with `>` or invoking
+  multiple commands with `&&` are not permitted. Whenever these sorts
+  of requirements show up, write an internal Python script with the
+  desired functionality and use that instead.

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/Creating-Linux-binaries.md Added

@@ -0,0 +1,133 @@
+---
+short-description: Creating universal Linux binaries
+...
+
+# Creating Linux binaries
+
+Creating Linux binaries that can be downloaded and run on any distro
+(like .dmg packages for OSX or .exe installers for Windows) has
+traditionally been difficult. This is even more tricky if you want to
+use modern compilers and features, which is especially desired in game
+development. There is still no simple turn-key solution for this
+problem but with a bit of setup it can be relatively straightforward.
+
+## Installing system and GCC
+
+First you need to do a fresh operating system install. You can use
+spare hardware, VirtualBox, cloud or whatever you want. Note that the
+distro you install must be *at least as old* as the oldest release you
+wish to support. Debian stable is usually a good choice, though
+immediately after its release you might want to use Debian oldstable
+or the previous Ubuntu LTS. The oldest supported version of CentOS is
+also a good choice.
+
+Once you have installed the system, you need to install
+build-dependencies for GCC. In Debian-based distros this can be done
+with the following commands:
+
+```console
+$ apt-get build-dep g++
+$ apt-get install pkg-config libgmp-dev libmpfr-dev libmpc-dev
+```
+
+Then create a `src` subdirectory in your home directory. Copy-paste
+the following into `install_gcc.sh` and execute it.
+
+```bash
+#!/bin/sh
+
+wget ftp://ftp.fu-berlin.de/unix/languages/gcc/releases/gcc-4.9.2/gcc-4.9.2.tar.bz2
+tar xf gcc-4.9.2.tar.bz2
+
+mkdir objdir
+cd objdir
+../gcc-4.9.2/configure --disable-bootstrap --prefix=${HOME}/devroot \
+                       --disable-multilib --enable-languages=c,c++
+make -j 4
+make install-strip
+ln -s gcc ${HOME}/devroot/bin/cc
+```
+
+Then finally add the following lines to your `.bashrc`.
+
+```console
+$ export LD_LIBRARY_PATH=${HOME}/devroot/lib
+$ export PATH=${HOME}/devroot/bin:$PATH
+$ export PKG_CONFIG_PATH=${HOME}/devroot/lib/pkgconfig
+```
+
+Log out and back in and now your build environment is ready to use.
+
+## Adding other tools
+
+Old distros might have too old versions of some tools. For Meson this
+could include Python 3 and Ninja. If this is the case you need to
+download, build and install new versions into `~/devroot` in the usual
+way.
+
+## Adding dependencies
+
+You want to embed and statically link every dependency you can
+(especially C++ dependencies). Meson's Wrap package
+manager(Wrap-dependency-system-manual.md) might be of use here. This
+is equivalent to what you would do on Windows, OSX, Android etc.
+Sometimes static linking is not possible. In these cases you need to
+copy the .so files inside your package. Let's use SDL2 as an example.
+First we download and install it as usual giving it our custom install
+prefix (that is, `./configure --prefix=${HOME}/devroot`). This makes
+Meson's dependency detector pick it up automatically.
+
+## Building and installing
+
+Building happens in much the same way as normally. There are just two
+things to note. First, you must tell GCC to link the C++ standard
+library statically. If you don't then your app is guaranteed to break
+as different distros have binary-incompatible C++ libraries. The
+second thing is that you need to point your install prefix to some
+empty staging area. Here's the Meson command to do that:
+
+```console
+$ LDFLAGS=-static-libstdc++ meson --prefix=/tmp/myapp <other args>
+```
+
+The aim is to put the executable in `/tmp/myapp/bin` and shared
+libraries to `/tmp/myapp/lib`. The next thing you need is the
+embedder. It takes your dependencies (in this case only
+`libSDL2-2.0.so.0`) and copies them in the lib directory. Depending on
+your use case you can either copy the files by hand or write a script
+that parses the output of `ldd binary_file`. Be sure not to copy
+system libraries (`libc`, `libpthread`, `libm` etc). For an example,
+see the sample
+project(https://github.com/jpakkane/meson/tree/master/manual%20tests/4%20standalone%20binaries).
+
+Make the script run during install with this:
+
+```meson
+#meson.add_install_script('linux_bundler.sh')
+```
+
+## Final steps
+
+If you try to run the program now it will most likely fail to start or
+crashes. The reason for this is that the system does not know that the
+executable needs libraries from the `lib` directory. The solution for
+this is a simple wrapper script. Create a script called `myapp.sh`
+with the following content:
+
+```bash
+#!/bin/bash
+
+cd "${0%/*}"
+export LD_LIBRARY_PATH="$(pwd)/lib"
+bin/myapp
+```
+
+Install it with this Meson snippet:
+
+```meson
+#install_data('myapp.sh', install_dir : '.')
+```
+
+And now you are done. Zip up your `/tmp/myapp` directory and you have
+a working binary ready for deployment. To run the program, just unzip
+the file and run `myapp.sh`.

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/Creating-OSX-packages.md Added

@@ -0,0 +1,180 @@
+---
+short-description: Tools to create OS X packages
+...
+
+# Creating OSX packages
+
+Meson does not have native support for building OSX packages but it
+does provide all the tools you need to create one yourself. The reason
+for this is that it is a very hard task to write a system that
+provides for all the different ways to do that but it is very easy to
+write simple scripts for each application.
+
+Sample code for this can be found in the Meson manual test
+suite(https://github.com/jpakkane/meson/tree/master/manual%20tests/4%20standalone%20binaries).
+
+## Creating an app bundle
+
+OSX app bundles are actually extremely simple. They are just a
+directory of files in a certain format. All the details you need to
+know are on this
+page(https://stackoverflow.com/questions/1596945/building-osx-app-bundle)
+and it is highly recommended that you read it first.
+
+Let's assume that we are creating our app bundle into
+`/tmp/myapp.app`. Suppose we have one executable, so we need to
+install that into `Contents/MacOS`. If we define the executable like
+this:
+
+```meson
+executable('myapp', 'foo1.c', ..., install : true)
+```
+
+then we just need to initialize our build tree with this command:
+
+```console
+$ meson --prefix=/tmp/myapp.app \
+        --bindir=Contents/MacOS \
+        builddir \
+        <other flags you might need>
+```
+
+Now when we do `meson install` the bundle is properly staged. If you
+have any resource files or data, you need to install them into
+`Contents/Resources` either by custom install commands or specifying
+more install paths to the Meson command.
+
+Next we need to install an `Info.plist` file and an icon. For those we
+need the following two Meson definitions.
+
+```meson
+install_data('myapp.icns', install_dir : 'Contents/Resources')
+install_data('Info.plist', install_dir : 'Contents')
+```
+
+The format of `Info.plist` can be found in the link or the sample
+project linked above. The simplest way to get an icon in the `icns`
+format is to save your image as a tiff an then use the `tiff2icns` helper
+application that comes with XCode.
+
+Some applications assume that the working directory of the app process
+is the same where the binary executable is. If this is the case for
+you, then you need to create a wrapper script that looks like this:
+
+```bash
+#!/bin/bash
+
+cd "${0%/*}"
+./myapp
+```
+
+install it with this:
+
+```meson
+install_data('myapp.sh', install_dir : 'Contents/MacOS')
+```
+
+and make sure that you specify `myapp.sh` as the executable to run in
+your `Info.plist`.
+
+If you are not using any external libraries, this is all you need to
+do. You now have a full app bundle in `/tmp/myapp.app` that you can
+use.
+
+### External libraries 
+
+Most applications use third party frameworks and libraries.
+If it is the case for your project, you need to add them to 
+the bundle so it will work on other peoples' machines.
+
+As an example we are going to use the SDL2(https://libsdl.org/)
+framework. In order to bundle it in our app, we first specify an
+installer script to run.
+
+```meson
+#meson.add_install_script('install_script.sh')
+```
+
+The install script does two things. First it copies the whole
+framework into our bundle.
+
+```console
+$ mkdir -p ${MESON_INSTALL_PREFIX}/Contents/Frameworks
+$ cp -R /Library/Frameworks/SDL2.framework \
+        ${MESON_INSTALL_PREFIX}/Contents/Frameworks
+```
+
+Then it needs to alter the library search path of our
+executable(s). This tells OSX that the libraries your app needs are
+inside your bundle. In the case of SDL2, the invocation goes like
+this:
+
+```console
+$ install_name_tool -change @rpath/SDL2.framework/Versions/A/SDL2 \
+    @executable_path/../FrameWorks/SDL2.framework/Versions/A/SDL2 \
+    ${MESON_INSTALL_PREFIX}/Contents/MacOS/myapp
+```
+
+This is the part of OSX app bundling that you must always do
+manually. OSX dependencies come in many shapes and forms and
+unfortunately there is no reliable automatic way to determine how each
+dependency should be handled. Frameworks go to the `Frameworks`
+directory while plain `.dylib` files usually go to
+`Contents/Resources/lib` (but you can put them wherever you like). To
+get this done you have to check what your program links against with
+`otool -L /path/to/binary` and manually add the copy and fix steps to
+your install script. Do not copy system libraries inside your bundle,
+though.
+
+After this you have a fully working, self-contained OSX app bundle
+ready for distribution.
+
+#### Qt
+
+Qt offers a deployment tool(https://doc.qt.io/qt-5/macos-deployment.html#macdeploy),
+called `macdeployqt`, that automates bundling Qt's libraries in your application folder and
+optionally create the final `.dmg` installer
+
+```console
+# cd into the folder that contains the `myapp.app` folder
+macdeployqt myapp.app -executable=myapp.app/Contents/MacOS/myapp
+```
+
+This copies the needed Qt libraries to the correct subfolders within `myapp.app`.
+The `-executable=myapp.app/Contents/MacOS/myapp` argument is
+to automatically alter the search path of the executable 
+`myapp.app/Contents/MacOS/myapp` for the Qt libraries. One can also pass the `-dmg`
+argument to create a `.dmg` installer from the updated `myapp.app` folder.
+More information is available on the tool's documentation page.
+
+## Creating a .dmg installer
+
+A .dmg installer is similarly quite simple, at its core it is
+basically a fancy compressed archive. A good description can be found
+on this page(https://el-tramo.be/guides/fancy-dmg/). Please read it
+and create a template image file according to its instructions.
+
+The actual process of creating the installer is very simple: you mount
+the template image, copy your app bundle in it, unmount it and convert
+the image into a compressed archive. The actual commands to do this
+are not particularly interesting, feel free to steal them from either
+the linked page above or from the sample script in Meson's test suite.
+
+## Putting it all together
+
+There are many ways to put the .dmg installer together and different
+people will do it in different ways. The linked sample code does it by
+having two different scripts. This separates the different pieces
+generating the installer into logical pieces.
+
+`install_script.sh` only deals with embedding dependencies and fixing
+the library paths.
+
+`build_osx_installer.sh` sets up the build with the proper paths,
+compiles, installs and generates the .dmg package.
+
+The main reasoning here is that in order to build a complete OSX
+installer package from source, all you need to do is to cd into the
+source tree and run `./build_osx_installer.sh`. To build packages on
+other platforms you would write scripts such as
+`build_windows_installer.bat` and so on.

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/Creating-releases.md Added

@@ -0,0 +1,88 @@
+---
+short-description: Creating releases
+...
+
+# Creating releases
+
+In addition to development, almost all projects provide periodical
+source releases. These are standalone packages (usually either in
+tar or zip format) of the source code. They do not contain any
+revision control metadata, only the source code.  Meson provides
+a simple way of generating these, with the `meson dist` command.
+
+Meson provides a simple way of generating these. It consists of a
+single command *(available since 0.52.0)*:
+
+```sh
+meson dist
+```
+
+or alternatively (on older Meson versions with `ninja` backend):
+
+```sh
+ninja dist
+```
+
+This creates a file called `projectname-version.tar.xz` in the build
+tree subdirectory `meson-dist`. This archive contains the full
+contents of the latest commit in revision control including all the
+submodules (recursively). All revision control metadata is removed.
+Meson then takes this archive and tests that it works by doing a full
+`compile` + `test` + `install` cycle. If all these pass, Meson will
+then create a `SHA-256` checksum file next to the archive.
+
+
+## Autotools dist VS Meson dist
+
+Meson behaviour is different from Autotools. The Autotools "dist"
+target packages up the current source tree. Meson packages the latest
+revision control commit. The reason for this is that it prevents
+developers from doing accidental releases where the distributed
+archive does not match any commit in revision control (especially the
+one tagged for the release).
+
+
+## Include subprojects in your release
+
+The `meson dist` command has `--include-subprojects` command line
+option. When enabled, the source tree of all subprojects used by the
+current build will also be included in the final tarball. This is
+useful to distribute self contained tarball that can be built offline
+(i.e. `--wrap-mode=nodownload`).
+
+
+## Skip build and test with `--no-tests`
+
+The `meson dist` command has a `--no-tests` option to skip build and
+tests steps of generated packages. It can be used to not waste time
+for example when done in CI that already does its own testing.
+
+So with `--no-tests` you can tell Meson "Do not build and test generated
+packages.".
+
+## Use `--allow-dirty` to override error when git repository contains uncommitted changes
+
+*Since 0.62.0* Instead of emitting a warning when a repository contains
+uncommitted changes, Meson will produce an error message notifying the
+user and immediately exit. If `--allow-dirty` is given as an option to
+`meson dist`, a warning will be emitted instead and Meson will proceed
+as usual.
+
+## Release a subproject separately
+
+*Since 0.57.0* the `meson dist` command can now create a distribution tarball
+for a subproject in the same git repository as the main project. This can be
+useful if parts of the project (e.g. libraries) can be built and distributed
+separately. In that case they can be moved into `subprojects/mysub` and running
+`meson dist` in that directory will now create a tarball containing only the
+source code from that subdir and not the rest of the main project or other
+subprojects.
+
+For example:
+```sh
+git clone https://github.com/myproject
+cd myproject/subprojects/mysubproject
+meson setup builddir
+meson dist -C builddir
+```
+This produces `builddir/meson-dist/mysubproject-1.0.tar.xz` tarball.

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/Cross-compilation.md Added

@@ -0,0 +1,375 @@
+---
+short-description: Setting up cross-compilation
+...
+
+# Cross compilation
+
+Meson has full support for cross compilation through the use of
+a cross build definition file.  An minimal example of one such
+file `x86_64-w64-mingw32.txt` for a GCC/MinGW cross compiler
+targeting 64-bit Windows could be:
+
+```ini
+binaries
+c = 'x86_64-w64-mingw32-gcc'
+cpp = 'x86_64-w64-mingw32-g++'
+ar = 'x86_64-w64-mingw32-ar'
+strip = 'x86_64-w64-mingw32-strip'
+exe_wrapper = 'wine64'
+
+host_machine
+system = 'windows'
+cpu_family = 'x86_64'
+cpu = 'x86_64'
+endian = 'little'
+```
+
+Which is then used during the `setup` phase.
+
+```sh
+meson setup --cross-file x86_64-w64-mingw32.txt build-mingw
+meson compile -C build-mingw
+```
+
+Since cross compiling is
+more complicated than native building, let's first go over some
+nomenclature. The three most important definitions are traditionally
+called *build*, *host* and *target*. This is confusing because those
+terms are used for quite many different things. To simplify the issue,
+we are going to call these the *build machine*, *host machine* and
+*target machine*. Their definitions are the following:
+
+* *build machine* is the computer that is doing the actual compiling.
+* *host machine* is the machine on which the compiled binary will run.
+* *target machine* is the machine on which the compiled binary's
+  output will run, *only meaningful* if the program produces
+  machine-specific output.
+
+The `tl/dr` summary is the following: if you are doing regular cross
+compilation, you only care about @build_machine and
+@host_machine. Just ignore @target_machine altogether and you will
+be correct 99% of the time. Only compilers and similar tools care
+about the target machine. In fact, for so-called "multi-target" tools
+the target machine need not be fixed at build-time like the others but
+chosen at runtime, so `target_machine` *still* doesn't matter. If your
+needs are more complex or you are interested in the actual details, do
+read on.
+
+This might be easier to understand through examples. Let's start with
+the regular, not cross-compiling case. In these cases all of these
+three machines are the same. Simple so far.
+
+Let's next look at the most common cross-compilation setup. Let's
+suppose you are on a 64 bit OSX machine and you are cross compiling a
+binary that will run on a 32 bit ARM Linux board. In this case your
+*build machine* is 64 bit OSX, your *host machine* is 32 bit ARM Linux
+and your *target machine* is irrelevant (but defaults to the same
+value as the *host machine*). This should be quite understandable as
+well.
+
+The usual mistake in this case is to call the OSX system the *host*
+and the ARM Linux board the *target*. That's because these were their
+actual names when the cross-compiler itself was compiled! Let's assume
+the cross-compiler was created on OSX too. When that happened the
+*build* and *host machines* were the same OSX and different from the
+ARM Linux *target machine*.
+
+In a nutshell, the typical mistake assumes that the terms *build*,
+*host* and *target* refer to some fixed positions whereas they're
+actually relative to where the current compiler is running. Think of
+*host* as a *child* of the current compiler and *target* as an
+optional *grand-child*. Compilers don't change their terminology when
+they're creating another compiler, that would at the very least make
+their user interface much more complex.
+
+The most complicated case is when you cross-compile a cross compiler.
+As an example you can, on a Linux machine, generate a cross compiler
+that runs on Windows but produces binaries on MIPS Linux. In this case
+*build machine* is x86 Linux, *host machine* is x86 Windows and
+*target machine* is MIPS Linux. This setup is known as the Canadian
+Cross(https://en.wikipedia.org/wiki/Cross_compiler#Canadian_Cross).
+As a side note, be careful when reading cross compilation articles on
+Wikipedia or the net in general. It is very common for them to get
+build, host and target mixed up, even in consecutive sentences, which
+can leave you puzzled until you figure it out.
+
+Again note that when you cross-compile something, the 3 systems
+(*build*, *host*, and *target*) used when building the cross compiler
+don't align with the ones used when building something with that
+newly-built cross compiler. To take our Canadian Cross scenario from
+above (for full generality), since its *host machine* is x86 Windows,
+the *build machine* of anything we build with it is *x86 Windows*. And
+since its *target machine* is MIPS Linux, the *host machine* of
+anything we build with it is *MIPS Linux*. Only the *target machine*
+of whatever we build with it can be freely chosen by us, say if we
+want to build another cross compiler that runs on MIPS Linux and
+targets Aarch64 iOS. As this example hopefully makes clear to you, the
+machine names are relative and shifted over to the left by one
+position.
+
+If you did not understand all of the details, don't worry. For most
+people it takes a while to wrap their head around these concepts.
+Don't panic, it might take a while to click, but you will get the hang
+of it eventually.
+
+## Defining the environment
+
+Meson requires you to write a cross build definition file. It defines
+various properties of the cross build environment. The cross file
+consists of different sections.
+
+There are a number of options shared by cross and native files,
+here(Machine-files.md). It is assumed that you have read that
+section already, as this documentation will only call out options
+specific to cross files.
+
+### Binaries
+
+```ini
+binaries
+exe_wrapper = 'wine' # A command used to run generated executables.
+```
+
+The `exe_wrapper` option defines a *wrapper command* that can be used
+to run executables for this host. In this case we can use Wine, which
+runs Windows applications on Linux. Other choices include running the
+application with qemu or a hardware simulator. If you have this kind
+of a wrapper, these lines are all you need to write. Meson will
+automatically use the given wrapper when it needs to run host
+binaries. This happens e.g. when running the project's test suite.
+
+### Properties
+
+In addition to the properties allowed in all machine
+files(Machine-files.md#properties), the cross file may contain
+specific information about the cross compiler or the host machine. It
+looks like this:
+
+```ini
+properties
+sizeof_int = 4
+sizeof_wchar_t = 4
+sizeof_void* = 4
+
+alignment_char = 1
+alignment_void* = 4
+alignment_double = 4
+
+has_function_printf = true
+
+sys_root = '/some/path'
+pkg_config_libdir = '/some/path/lib/pkgconfig'
+```
+
+In most cases you don't need the size and alignment settings, Meson
+will detect all these by compiling and running some sample programs.
+If your build requires some piece of data that is not listed here,
+Meson will stop and write an error message describing how to fix the
+issue. If you need extra compiler arguments to be used during cross
+compilation you can set them with `langname_args = args`. Just
+remember to specify the args as an array and not as a single string
+(i.e. not as `'-DCROSS=1 -DSOMETHING=3'`).
+
+*Since 0.52.0* The `sys_root` property may point to the root of the
+host system path (the system that will run the compiled binaries).
+This is used internally by Meson to set the PKG_CONFIG_SYSROOT_DIR
+environment variable for pkg-config. If this is unset the host system
+is assumed to share a root with the build system.
+
+*Since 0.54.0* The pkg_config_libdir property may point to a list of
+path used internally by Meson to set the PKG_CONFIG_LIBDIR environment
+variable for pkg-config. This prevents pkg-config from searching cross
+dependencies in system directories.
+
+One important thing to note, if you did not define an `exe_wrapper` in
+the previous section, is that Meson will make a best-effort guess at
+whether it can run the generated binaries on the build machine. It
+determines whether this is possible by looking at the `system` and
+`cpu_family` of build vs host. There will however be cases where they
+do match up, but the build machine is actually not compatible with the
+host machine. Typically this will happen if the libc used by the build
+and host machines are incompatible, or the code relies on kernel
+features not available on the build machine. One concrete example is a
+macOS build machine producing binaries for an iOS Simulator x86-64
+host. They're both `darwin` and the same architecture, but their
+binaries are not actually compatible. In such cases you may use the
+`needs_exe_wrapper` property to override the auto-detection:
+
+```ini
+properties
+needs_exe_wrapper = true
+```
+
+### Machine Entries
+
+The next bit is the definition of host and target machines. Every
+cross build definition must have one or both of them. If it had
+neither, the build would not be a cross build but a native build. You
+do not need to define the build machine, as all necessary information
+about it is extracted automatically. The definitions for host and
+target machines look the same. Here is a sample for host machine.
+
+```ini
+host_machine
+system = 'windows'
+cpu_family = 'x86'
+cpu = 'i686'
+endian = 'little'
+```
+
+These values define the machines sufficiently for cross compilation
+purposes. The corresponding target definition would look the same but
+have `target_machine` in the header. These values are available in
+your Meson scripts. There are three predefined variables called,
+surprisingly, @build_machine, @host_machine and @target_machine.
+Determining the operating system of your host machine is simply a
+matter of calling `host_machine.system()`.
+
+There are two different values for the CPU. The first one is
+`cpu_family`. It is a general type of the CPU. This should have a
+value from the CPU Family table(Reference-tables.md#cpu-families).
+*Note* that Meson does not add `el` to end cpu_family value for little
+endian systems. Big endian and little endian mips are both just
+`mips`, with the `endian` field set appropriately.
+
+The second value is `cpu` which is a more specific subtype for the
+CPU. Typical values for a `x86` CPU family might include `i386` or
+`i586` and for `arm` family `armv5` or `armv7hl`. Note that CPU type
+strings are very system dependent. You might get a different value if
+you check its value on the same machine but with different operating
+systems.
+
+If you do not define your host machine, it is assumed to be the build
+machine. Similarly if you do not specify target machine, it is assumed
+to be the host machine.
+
+
+## Starting a cross build
+
+
+Once you have the cross file, starting a build is simple
+
+```console
+$ meson srcdir builddir --cross-file cross_file.txt
+```
+
+Once configuration is done, compilation is started by invoking `meson compile`
+in the usual way.
+
+## Introspection and system checks
+
+The main *meson* object provides two functions to determine cross
+compilation status.
+
+```meson
+#meson.is_cross_build        # returns true when cross compiling
+#meson.can_run_host_binaries # returns true if the host binaries can be run, either with a wrapper or natively
+```
+
+You can run system checks on both the system compiler or the cross
+compiler. You just have to specify which one to use.
+
+```meson
+build_compiler = #meson.get_compiler('c', native : true)
+host_compiler = #meson.get_compiler('c', native : false)
+
+build_int_size = build_compiler.sizeof('int')
+host_int_size  = host_compiler.sizeof('int')
+```
+
+## Mixing host and build targets
+
+Sometimes you need to build a tool which is used to generate source
+files. These are then compiled for the actual target. For this you
+would want to build some targets with the system's native compiler.
+This requires only one extra keyword argument.
+
+```meson
+native_exe = executable('mygen', 'mygen.c', native : true)
+```
+
+You can then take `native_exe` and use it as part of a generator rule or anything else you might want.
+
+## Using a custom standard library
+
+Sometimes in cross compilation you need to build your own standard
+library instead of using the one provided by the compiler. Meson has
+built-in support for switching standard libraries transparently. The
+invocation to use in your cross file is the following:
+
+```ini
+properties
+c_stdlib = 'mylibc', 'mylibc_dep' # Subproject name, variable name
+```
+
+This specifies that C standard library is provided in the Meson
+subproject `mylibc` in internal dependency variable `mylibc_dep`. It
+is used on every cross built C target in the entire source tree
+(including subprojects) and the standard library is disabled. The
+build definitions of these targets do not need any modification.
+
+Note that it is supported for any language, not only `c`, using `<lang>_stdlib`
+property.
+
+Since *0.56.0* the variable name parameter is no longer required as long as the
+subproject calls `meson.override_dependency('c_stdlib', mylibc_dep)`.
+The above example becomes:
+
+```ini
+properties
+c_stdlib = 'mylibc'
+```
+
+## Changing cross file settings
+
+Cross file settings are only read when the build directory is set up
+the first time. Any changes to them after the fact will be ignored.
+This is the same as regular compiles where you can't change the
+compiler once a build tree has been set up. If you need to edit your
+cross file, then you need to wipe your build tree and recreate it from
+scratch.
+
+## Custom data
+
+You can store arbitrary data in `properties` and access them from your
+Meson files. As an example if you cross file has this:
+
+```ini
+properties
+somekey = 'somevalue'
+```
+
+then you can access that using the `meson` object like this:
+
+```meson
+myvar = meson.get_external_property('somekey')
+# myvar now has the value 'somevalue'
+```
+
+## Cross file locations
+
+As of version 0.44.0 Meson supports loading cross files from system
+locations (except on Windows). This will be
+$XDG_DATA_DIRS/meson/cross, or if XDG_DATA_DIRS is undefined, then
+/usr/local/share/meson/cross and /usr/share/meson/cross will be tried
+in that order, for system wide cross files. User local files can be
+put in $XDG_DATA_HOME/meson/cross, or ~/.local/share/meson/cross if
+that is undefined.
+
+The order of locations tried is as follows:
+ - A file relative to the local dir
+ - The user local location
+ - The system wide locations in order
+
+Distributions are encouraged to ship cross files either with their
+cross compiler toolchain packages or as a standalone package, and put
+them in one of the system paths referenced above.
+
+These files can be loaded automatically without adding a path to the
+cross file. For example, if a ~/.local/share/meson/cross contains a
+file called x86-linux, then the following command would start a cross
+build using that cross files:
+
+```sh
+meson setup builddir/ --cross-file x86-linux
+```

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/Cuda-module.md Added

@@ -0,0 +1,186 @@
+---
+short-description: CUDA module
+authors:
+    - name: Olexa Bilaniuk
+      years: 2019
+      has-copyright: false
+...
+
+# Unstable CUDA Module
+_Since: 0.50.0_
+
+This module provides helper functionality related to the CUDA Toolkit and
+building code using it.
+
+
+**Note**: this module is unstable. It is only provided as a technology preview.
+Its API may change in arbitrary ways between releases or it might be removed
+from Meson altogether.
+
+
+## Importing the module
+
+The module may be imported as follows:
+
+``` meson
+cuda = #import('unstable-cuda')
+```
+
+It offers several useful functions that are enumerated below.
+
+
+## Functions
+
+### `nvcc_arch_flags()`
+_Since: 0.50.0_
+
+``` meson
+cuda.nvcc_arch_flags(cuda_version_string, ...,
+                     detected: string_or_array)
+```
+
+Returns a list of `-gencode` flags that should be passed to `cuda_args:` in
+order to compile a "fat binary" for the architectures/compute capabilities
+enumerated in the positional argument(s). The flags shall be acceptable to
+an NVCC with CUDA Toolkit version string `cuda_version_string`.
+
+A set of architectures and/or compute capabilities may be specified by:
+
+- The single positional argument `'All'`, `'Common'` or `'Auto'`
+- As (an array of)
+  - Architecture names (`'Kepler'`, `'Maxwell+Tegra'`, `'Turing'`) and/or
+  - Compute capabilities (`'3.0'`, `'3.5'`, `'5.3'`, `'7.5'`)
+
+A suffix of `+PTX` requests PTX code generation for the given architecture.
+A compute capability given as `A.B(X.Y)` requests PTX generation for an older
+virtual architecture `X.Y` before binary generation for a newer architecture
+`A.B`.
+
+Multiple architectures and compute capabilities may be passed in using
+
+- Multiple positional arguments
+- Lists of strings
+- Space (` `), comma (`,`) or semicolon (`;`)-separated strings
+
+The single-word architectural sets `'All'`, `'Common'` or `'Auto'`
+cannot be mixed with architecture names or compute capabilities. Their
+interpretation is:
+
+| Name              | Compute Capability |
+|-------------------|--------------------|
+| `'All'`           | All CCs supported by given NVCC compiler. |
+| `'Common'`        | Relatively common CCs supported by given NVCC compiler. Generally excludes Tegra and Tesla devices. |
+| `'Auto'`          | The CCs provided by the `detected:` keyword, filtered for support by given NVCC compiler. |
+
+The supported architecture names and their corresponding compute capabilities
+are:
+
+| Name              | Compute Capability |
+|-------------------|--------------------|
+| `'Fermi'`         | 2.0, 2.1(2.0)      |
+| `'Kepler'`        | 3.0, 3.5           |
+| `'Kepler+Tegra'`  | 3.2                |
+| `'Kepler+Tesla'`  | 3.7                |
+| `'Maxwell'`       | 5.0, 5.2           |
+| `'Maxwell+Tegra'` | 5.3                |
+| `'Pascal'`        | 6.0, 6.1           |
+| `'Pascal+Tegra'`  | 6.2                |
+| `'Volta'`         | 7.0                |
+| `'Xavier'`        | 7.2                |
+| `'Turing'`        | 7.5                |
+| `'Ampere'`        | 8.0, 8.6           |
+
+
+Examples:
+
+    cuda.nvcc_arch_flags('10.0', '3.0', '3.5', '5.0+PTX')
+    cuda.nvcc_arch_flags('10.0', '3.0', '3.5', '5.0+PTX')
+    cuda.nvcc_arch_flags('10.0', '3.0', '3.5', '5.0+PTX')
+    cuda.nvcc_arch_flags('10.0', '3.0 3.5 5.0+PTX')
+    cuda.nvcc_arch_flags('10.0', '3.0,3.5,5.0+PTX')
+    cuda.nvcc_arch_flags('10.0', '3.0;3.5;5.0+PTX')
+    cuda.nvcc_arch_flags('10.0', 'Kepler 5.0+PTX')
+    # Returns '-gencode', 'arch=compute_30,code=sm_30',
+    #          '-gencode', 'arch=compute_35,code=sm_35',
+    #          '-gencode', 'arch=compute_50,code=sm_50',
+    #          '-gencode', 'arch=compute_50,code=compute_50'
+
+    cuda.nvcc_arch_flags('10.0', '3.5(3.0)')
+    # Returns '-gencode', 'arch=compute_30,code=sm_35'
+
+    cuda.nvcc_arch_flags('8.0', 'Common')
+    # Returns '-gencode', 'arch=compute_30,code=sm_30',
+    #          '-gencode', 'arch=compute_35,code=sm_35',
+    #          '-gencode', 'arch=compute_50,code=sm_50',
+    #          '-gencode', 'arch=compute_52,code=sm_52',
+    #          '-gencode', 'arch=compute_60,code=sm_60',
+    #          '-gencode', 'arch=compute_61,code=sm_61',
+    #          '-gencode', 'arch=compute_61,code=compute_61'
+
+    cuda.nvcc_arch_flags('9.2', 'Auto', detected: '6.0 6.0 6.0 6.0')
+    cuda.nvcc_arch_flags('9.2', 'Auto', detected: '6.0', '6.0', '6.0', '6.0')
+    # Returns '-gencode', 'arch=compute_60,code=sm_60'
+
+    cuda.nvcc_arch_flags(nvcc, 'All')
+    # Returns '-gencode', 'arch=compute_20,code=sm_20',
+    #          '-gencode', 'arch=compute_20,code=sm_21',
+    #          '-gencode', 'arch=compute_30,code=sm_30',
+    #          '-gencode', 'arch=compute_32,code=sm_32',
+    #          '-gencode', 'arch=compute_35,code=sm_35',
+    #          '-gencode', 'arch=compute_37,code=sm_37',
+    #          '-gencode', 'arch=compute_50,code=sm_50', # nvcc.version()  <  7.0
+    #          '-gencode', 'arch=compute_52,code=sm_52',
+    #          '-gencode', 'arch=compute_53,code=sm_53', # nvcc.version() >=  7.0
+    #          '-gencode', 'arch=compute_60,code=sm_60',
+    #          '-gencode', 'arch=compute_61,code=sm_61', # nvcc.version() >=  8.0
+    #          '-gencode', 'arch=compute_70,code=sm_70',
+    #          '-gencode', 'arch=compute_72,code=sm_72', # nvcc.version() >=  9.0
+    #          '-gencode', 'arch=compute_75,code=sm_75' # nvcc.version() >= 10.0
+
+_Note:_ This function is intended to closely replicate CMake's FindCUDA module
+function `CUDA_SELECT_NVCC_ARCH_FLAGS(out_variable, list of CUDA compute architectures)`
+
+
+
+### `nvcc_arch_readable()`
+_Since: 0.50.0_
+
+``` meson
+cuda.nvcc_arch_readable(cuda_version_string, ...,
+                        detected: string_or_array)
+```
+
+Has precisely the same interface as `nvcc_arch_flags()`(#nvcc_arch_flags),
+but rather than returning a list of flags, it returns a "readable" list of
+architectures that will be compiled for. The output of this function is solely
+intended for informative message printing.
+
+    archs    = '3.0 3.5 5.0+PTX'
+    readable = cuda.nvcc_arch_readable('10.0', archs)
+    message('Building for architectures ' + ' '.join(readable))
+
+This will print
+
+    Message: Building for architectures sm30 sm35 sm50 compute50
+
+_Note:_ This function is intended to closely replicate CMake's
+FindCUDA module function `CUDA_SELECT_NVCC_ARCH_FLAGS(out_variable,
+list of CUDA compute architectures)`
+
+
+
+### `min_driver_version()`
+_Since: 0.50.0_
+
+``` meson
+cuda.min_driver_version(cuda_version_string)
+```
+
+Returns the minimum NVIDIA proprietary driver version required, on the
+host system, by kernels compiled with a CUDA Toolkit with the given
+version string.
+
+The output of this function is generally intended for informative
+message printing, but could be used for assertions or to conditionally
+enable features known to exist within the minimum NVIDIA driver
+required.

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/Custom-build-targets.md Added

@@ -0,0 +1,46 @@
+---
+short-description: Build targets for custom languages or corner-cases
+...
+
+# Custom build targets
+
+While Meson tries to support as many languages and tools as possible,
+there is no possible way for it to cover all corner cases. For these
+cases it permits you to define custom build targets. Here is how one
+would use it.
+
+```meson
+comp = find_program('custom_compiler')
+
+infile = 'source_code.txt'
+outfile = 'output.bin'
+
+mytarget = custom_target('targetname',
+  output : outfile,
+  input : infile,
+  command : comp, '@INPUT@', '@OUTPUT@',
+  install : true,
+  install_dir : 'subdir')
+```
+
+This would generate the binary `output.bin` and install it to
+`${prefix}/subdir/output.bin`. Variable substitution works just like
+it does for source generation.
+
+See Generating Sources(Generating-sources.md) for more information on this topic.
+
+## Details on command invocation
+
+Meson only permits you to specify one command to run. This is by
+design as writing shell pipelines into build definition files leads to
+code that is very hard to maintain. If your command requires multiple
+steps you need to write a wrapper script that does all the necessary
+work.
+
+When doing this you need to be mindful of the following issues:
+
+* do not assume that the command is invoked in any specific directory
+* a target called `target` file `outfile` defined in subdir `subdir`
+  must be written to `build_dir/subdir/foo.dat`
+* if you need a subdirectory for temporary files, use
+  `build_dir/subdir/target.dir`

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/Cython.md Added

@@ -0,0 +1,62 @@
+---
+title: Cython
+short-description: Support for Cython in Meson
+...
+
+# Cython
+
+Meson provides native support for cython programs starting with version 0.59.0.
+This means that you can include it as a normal language, and create targets like
+any other supported language:
+
+```meson
+lib = static_library(
+    'foo',
+    'foo.pyx',
+)
+```
+
+Generally Cython is most useful when combined with the python module's
+extension_module method:
+
+```meson
+project('my project', 'cython')
+
+py = import('python').find_installation()
+dep_py = py.dependency()
+
+py.extension_module(
+    'foo',
+    'foo.pyx',
+    dependencies : dep_py,
+)
+```
+
+## C++ intermediate support
+
+*(New in 0.60.0)*
+
+An option has been added to control this, called `cython_language`. This can be
+either `'c'` or `'cpp'`.
+
+For those coming from setuptools/distutils, they will find two things. First,
+meson ignores `# distutils: language = c++` inline directives. Second that Meson
+allows options only on a per-target granularity. This means that if you need to mix
+cython files being transpiled to C and to C++ you need two targets:
+
+```meson
+project('my project', 'cython')
+
+cython_cpp_lib = static_library(
+    'helper_lib',
+    'foo_cpp.pyx',  # will be transpiled to C++
+    override_options : 'cython_language=cpp',
+)
+
+py.extension_module(
+    'foo',
+    'foo.pyx',  # will be transpiled to C
+    link_with : cython_cpp_lib,
+    dependencies : dep_py,
+)
+```

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/D.md Added

@@ -0,0 +1,144 @@
+---
+title: D
+short-description: Compiling D sources
+...
+
+# Compiling D applications
+
+Meson has support for compiling D programs. A minimal `meson.build`
+file for D looks like this:
+
+```meson
+project('myapp', 'd')
+
+executable('myapp', 'app.d')
+```
+
+## Conditional compilation(https://dlang.org/spec/version.html)
+
+If you are using the
+version()(https://dlang.org/spec/version.html#version-specification)
+feature for conditional compilation, you can use it using the
+`d_module_versions` target property:
+
+```meson
+project('myapp', 'd')
+executable('myapp', 'app.d', d_module_versions: 'Demo', 'FeatureA')
+```
+
+For debugging, debug()(https://dlang.org/spec/version.html#debug)
+conditions are compiled automatically in debug builds, and extra
+identifiers can be added with the `d_debug` argument:
+
+```meson
+project('myapp', 'd')
+executable('myapp', 'app.d', d_debug: 3, 'DebugFeatureA')
+```
+
+## In `declare_dependency`
+
+*Since 0.62.0*, when declaring your own dependency using `declare_dependency`,
+it is possible to add parameters for D specific features, e.g. to propagate
+conditional compilation versions:
+
+```meson
+my_dep = declare_dependency(
+    # ...
+    d_module_versions: 'LUA_53',
+    d_import_dirs: include_directories('my_lua_folder'),
+)
+```
+
+Accepted D specific parameters are `d_module_versions` and `d_import_dirs`
+(DMD `-J` switch).
+
+## Using embedded unittests
+
+If you are using embedded unittest
+functions(https://dlang.org/spec/unittest.html), your source code
+needs to be compiled twice, once in regular mode, and once with
+unittests active. This is done by setting the `d_unittest` target
+property to `true`. Meson will only ever pass the respective
+compiler's `-unittest` flag, and never have the compiler generate an
+empty main function. If you need that feature in a portable way,
+create an empty `main()` function for unittests yourself, since the
+GNU D compiler does not have this feature.
+
+This is an example for using D unittests with Meson:
+```meson
+project('myapp_tested', 'd')
+
+myapp_src = 'app.d', 'alpha.d', 'beta.d'
+executable('myapp', myapp_src)
+
+test_exe = executable('myapp_test', myapp_src, d_unittest: true)
+test('myapptest', test_exe)
+```
+
+# Compiling D libraries and installing them
+
+Building D libraries is a straightforward process, not different from
+how C libraries are built in Meson. You should generate a pkg-config
+file and install it, in order to make other software on the system
+find the dependency once it is installed.
+
+This is an example on how to build a D shared library:
+```meson
+project('mylib', 'd', version: '1.2.0')
+
+project_soversion = 0
+glib_dep = dependency('glib-2.0')
+
+my_lib = library('mylib',
+    'src/mylib/libfunctions.d',
+    dependencies: glib_dep,
+    install: true,
+    version: meson.project_version(),
+    soversion: project_soversion,
+    d_module_versions: 'FeatureA', 'featureB', 1
+)
+
+pkgc = import('pkgconfig')
+pkgc.generate(name: 'mylib',
+              libraries: my_lib,
+              subdirs: 'd/mylib',
+              version: meson.project_version(),
+              description: 'A simple example D library.',
+              d_module_versions: 'FeatureA', 1
+)
+install_subdir('src/mylib/', install_dir: 'include/d/mylib/')
+```
+
+It is important to make the D sources install in a subdirectory in the
+include path, in this case `/usr/include/d/mylib/mylib`. All D
+compilers include the `/usr/include/d` directory by default, and if
+your library would be installed into `/usr/include/d/mylib`, there is
+a high chance that, when you compile your project again on a machine
+where you installed it, the compiler will prefer the old installed
+include over the new version in the source tree, leading to very
+confusing errors.
+
+This is an example of how to use the D library we just built and
+installed in an application:
+```meson
+project('myapp', 'd')
+
+mylib_dep = dependency('mylib', version: '>= 1.2.0')
+myapp_src = 'app.d', 'alpha.d', 'beta.d'
+executable('myapp', myapp_src, dependencies: mylib_dep)
+```
+
+Please keep in mind that the library and executable would both need to
+be built with the exact same D compiler and D compiler version. The D
+ABI is not stable across compilers and their versions, and mixing
+compilers will lead to problems.
+
+# Integrating with DUB
+
+DUB is a fully integrated build system for D, but it is also a way to
+provide dependencies. Adding dependencies from the D package
+registry(https://code.dlang.org/) is pretty straight forward. You can
+find how to do this in
+Dependencies(Dependencies.md#some-notes-on-dub). You can also
+automatically generate a `dub.json` file as explained in
+Dlang(Dlang-module.md#generate_dub_file).

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/Dependencies.md Added

@@ -0,0 +1,809 @@
+---
+short-description: Dependencies for external libraries and frameworks
+...
+
+# Dependencies
+
+Very few applications are fully self-contained, but rather they use
+external libraries and frameworks to do their work. Meson makes it
+very easy to find and use external dependencies. Here is how one would
+use the zlib compression library.
+
+```meson
+zdep = dependency('zlib', version : '>=1.2.8')
+exe = executable('zlibprog', 'prog.c', dependencies : zdep)
+```
+
+First Meson is told to find the external library `zlib` and error out
+if it is not found. The `version` keyword is optional and specifies a
+version requirement for the dependency. Then an executable is built
+using the specified dependency. Note how the user does not need to
+manually handle compiler or linker flags or deal with any other
+minutiae.
+
+If you have multiple dependencies, pass them as an array:
+
+```meson
+executable('manydeps', 'file.c', dependencies : dep1, dep2, dep3, dep4)
+```
+
+If the dependency is optional, you can tell Meson not to error out if
+the dependency is not found and then do further configuration.
+
+```meson
+opt_dep = dependency('somedep', required : false)
+if opt_dep.found()
+  # Do something.
+else
+  # Do something else.
+endif
+```
+
+You can pass the `opt_dep` variable to target construction functions
+whether the actual dependency was found or not. Meson will ignore
+non-found dependencies.
+
+Meson also allows to get variables that are defined in the
+`pkg-config` file. This can be done by using the
+dep.get_pkgconfig_variable function.
+
+```meson
+zdep_prefix = zdep.get_pkgconfig_variable('prefix')
+```
+
+These variables can also be redefined by passing the `define_variable`
+parameter, which might be useful in certain situations:
+
+```meson
+zdep_prefix = zdep.get_pkgconfig_variable('libdir', define_variable: 'prefix', '/tmp')
+```
+
+The dependency detector works with all libraries that provide a
+`pkg-config` file. Unfortunately several packages don't provide
+pkg-config files. Meson has autodetection support for some of these,
+and they are described later in this
+page(#dependencies-with-custom-lookup-functionality).
+
+# Arbitrary variables from dependencies that can be found multiple ways
+
+*Note* new in 0.51.0
+*new in 0.54.0, the `internal` keyword*
+
+When you need to get an arbitrary variables from a dependency that can
+be found multiple ways and you don't want to constrain the type you
+can use the generic `get_variable` method. This currently supports
+cmake, pkg-config, and config-tool based variables.
+
+```meson
+foo_dep = dependency('foo')
+var = foo_dep.get_variable(cmake : 'CMAKE_VAR', pkgconfig : 'pkg-config-var', configtool : 'get-var', default_value : 'default')
+```
+
+It accepts the keywords 'cmake', 'pkgconfig', 'pkgconfig_define',
+'configtool', 'internal', and 'default_value'. 'pkgconfig_define'
+works just like the 'define_variable' argument to
+`get_pkgconfig_variable`. When this method is invoked the keyword
+corresponding to the underlying type of the dependency will be used to
+look for a variable. If that variable cannot be found or if the caller
+does not provide an argument for the type of dependency, one of the
+following will happen: If 'default_value' was provided that value will
+be returned, if 'default_value' was not provided then an error will be
+raised.
+
+## Dependencies that provide resource files
+
+Sometimes a dependency provides installable files which other projects then
+need to use. For example, wayland-protocols XML files.
+
+```meson
+foo_dep = dependency('foo')
+foo_datadir = foo_dep.get_variable('pkgdatadir')
+custom_target(
+    'foo-generated.c',
+    input: foo_datadir / 'prototype.xml',
+    output: 'foo-generated.c',
+    command: generator, '@INPUT@', '@OUTPUT@'
+)
+```
+
+*Since 0.63.0* these actually work as expected, even when they come from a
+(well-formed) internal dependency. This only works when treating the files to
+be obtained as interchangeable with a system dependency -- e.g. only public
+files may be used, and leaving the directory pointed to by the dependency is
+not allowed.
+
+# Declaring your own
+
+You can declare your own dependency objects that can be used
+interchangeably with dependency objects obtained from the system. The
+syntax is straightforward:
+
+```meson
+my_inc = include_directories(...)
+my_lib = static_library(...)
+my_dep = declare_dependency(link_with : my_lib,
+  include_directories : my_inc)
+```
+
+This declares a dependency that adds the given include directories and
+static library to any target you use it in.
+
+# Building dependencies as subprojects
+
+Many platforms do not provide a system package manager. On these
+systems dependencies must be compiled from source. Meson's subprojects
+make it simple to use system dependencies when they are available and
+to build dependencies manually when they are not.
+
+To make this work, the dependency must have Meson build definitions
+and it must declare its own dependency like this:
+
+```meson
+    foo_dep = declare_dependency(...)
+```
+
+Then any project that wants to use it can write out the following
+declaration in their main `meson.build` file.
+
+```meson
+    foo_dep = dependency('foo', fallback : 'foo', 'foo_dep')
+```
+
+What this declaration means is that first Meson tries to look up the
+dependency from the system (such as by using pkg-config). If it is not
+available, then it builds subproject named `foo` and from that
+extracts a variable `foo_dep`. That means that the return value of
+this function is either an external or an internal dependency object.
+Since they can be used interchangeably, the rest of the build
+definitions do not need to care which one it is. Meson will take care
+of all the work behind the scenes to make this work.
+
+# Dependency detection method
+
+You can use the keyword `method` to let Meson know what method to use
+when searching for the dependency. The default value is `auto`.
+Additional methods are `pkg-config`, `config-tool`, `cmake`,
+`builtin`, `system`, `sysconfig`, `qmake`, `extraframework` and `dub`.
+
+```meson
+cups_dep = dependency('cups', method : 'pkg-config')
+```
+
+For dependencies without specific detection
+logic(#dependencies-with-custom-lookup-functionality), the dependency method
+order for `auto` is:
+
+  1. `pkg-config`
+  2. `cmake`
+  3. `extraframework` (OSX only)
+
+## System
+
+Some dependencies provide no valid methods for discovery, or do so only in
+some cases. Some examples of this are Zlib, which provides both pkg-config
+and cmake, except when it is part of the base OS image (such as in FreeBSD
+and macOS); OpenGL which has pkg-config on Unices from glvnd or mesa, but has
+no pkg-config on macOS and Windows.
+
+In these cases Meson provides convenience wrappers in the form of `system`
+dependencies. Internally these dependencies do exactly what a user would do
+in the build system DSL or with a script, likely calling
+compiler.find_library, setting `link_with` and `include_directories`. By
+putting these in Meson upstream the barrier of using them is lowered, as
+projects using Meson don't have to re-implement the logic.
+
+## Builtin
+
+Some dependencies provide no valid methods for discovery on some systems,
+because they are provided internally by the language. One example of this is
+intl, which is built into GNU or musl libc but otherwise comes as a `system`
+dependency.
+
+In these cases Meson provides convenience wrappers for the `system` dependency,
+but first checks if the functionality is usable by default.
+
+## CMake
+
+Meson can use the CMake `find_package()` function to detect
+dependencies with the builtin `Find<NAME>.cmake` modules and exported
+project configurations (usually in `/usr/lib/cmake`). Meson is able to
+use both the old-style `<NAME>_LIBRARIES` variables as well as
+imported targets.
+
+It is possible to manually specify a list of CMake targets that should
+be used with the `modules` property. However, this step is optional
+since Meson tries to automatically guess the correct target based on
+the name of the dependency.
+
+Depending on the dependency it may be necessary to explicitly specify
+a CMake target with the `modules` property if Meson is unable to guess
+it automatically.
+
+```meson
+    cmake_dep = dependency('ZLIB', method : 'cmake', modules : 'ZLIB::ZLIB')
+```
+
+Support for adding additional `COMPONENTS` for the CMake
+`find_package` lookup is provided with the `components` kwarg
+(*introduced in 0.54.0*). All specified components will be passed
+directly to `find_package(COMPONENTS)`.
+
+Support for packages which require a specified version for CMake
+`find_package` to succeed is provided with the `cmake_package_version`
+kwarg (*introduced in 0.57.0*). The specified `cmake_package_version`
+will be passed directly as the second parameter to `find_package`.
+
+It is also possible to reuse existing `Find<name>.cmake` files with the
+`cmake_module_path` property (*since 0.50.0*). Using this property is
+equivalent to setting the `CMAKE_MODULE_PATH` variable in CMake. The
+path(s) given to `cmake_module_path` should all be relative to the
+project source directory. Absolute paths should only be used if the
+CMake files are not stored in the project itself.
+
+Additional CMake parameters can be specified with the `cmake_args`
+property (*since 0.50.0*).
+
+## Dub
+
+Please understand that Meson is only able to find dependencies that
+exist in the local Dub repository. You need to manually fetch and
+build the target dependencies.
+
+For `urld`.
+```
+dub fetch urld
+dub build urld
+```
+
+Other thing you need to keep in mind is that both Meson and Dub need
+to be using the same compiler. This can be achieved using Dub's
+`-compiler` argument and/or manually setting the `DC` environment
+variable when running Meson.
+```
+dub build urld --compiler=dmd
+DC="dmd" meson setup builddir
+```
+
+## Config tool
+
+CUPS(#cups), LLVM(#llvm), pcap(#pcap), WxWidgets(#wxwidgets),
+libwmf(#libwmf), GCrypt(#libgcrypt), GPGME(#gpgme), and GnuStep either do not provide pkg-config
+modules or additionally can be detected via a config tool
+(cups-config, llvm-config, libgcrypt-config, etc). Meson has native support for these
+tools, and they can be found like other dependencies:
+
+```meson
+pcap_dep = dependency('pcap', version : '>=1.0')
+cups_dep = dependency('cups', version : '>=1.4')
+llvm_dep = dependency('llvm', version : '>=4.0')
+libgcrypt_dep = dependency('libgcrypt', version: '>= 1.8')
+gpgme_dep = dependency('gpgme', version: '>= 1.0')
+```
+
+*Since 0.55.0* Meson won't search $PATH any more for a config tool
+binary when cross compiling if the config tool did not have an entry
+in the cross file.
+
+# Dependencies with custom lookup functionality
+
+Some dependencies have specific detection logic.
+
+Generic dependency names are case-sensitive<sup>1(#footnote1)</sup>,
+but these dependency names are matched case-insensitively. The
+recommended style is to write them in all lower-case.
+
+In some cases, more than one detection method exists, and the `method`
+keyword may be used to select a detection method to use. The `auto`
+method uses any checking mechanisms in whatever order Meson thinks is
+best.
+
+e.g. libwmf and CUPS provide both pkg-config and config-tool support.
+You can force one or another via the `method` keyword:
+
+```meson
+cups_dep = dependency('cups', method : 'pkg-config')
+wmf_dep = dependency('libwmf', method : 'config-tool')
+```
+
+## AppleFrameworks
+
+Use the `modules` keyword to list frameworks required, e.g.
+
+```meson
+dep = dependency('appleframeworks', modules : 'foundation')
+```
+
+These dependencies can never be found for non-OSX hosts.
+
+## Blocks
+
+Enable support for Clang's blocks extension.
+
+```meson
+dep = dependency('blocks')
+```
+
+*(added 0.52.0)*
+
+## Boost
+
+Boost is not a single dependency but rather a group of different
+libraries. To use Boost headers-only libraries, simply add Boost as a
+dependency.
+
+```meson
+boost_dep = dependency('boost')
+exe = executable('myprog', 'file.cc', dependencies : boost_dep)
+```
+
+To link against boost with Meson, simply list which libraries you
+would like to use.
+
+```meson
+boost_dep = dependency('boost', modules : 'thread', 'utility')
+exe = executable('myprog', 'file.cc', dependencies : boost_dep)
+```
+
+You can call dependency multiple times with different modules and
+use those to link against your targets.
+
+If your boost headers or libraries are in non-standard locations you
+can set the `BOOST_ROOT`, or the `BOOST_INCLUDEDIR` and
+`BOOST_LIBRARYDIR` environment variables. *(added in 0.56.0)* You can
+also set these parameters as `boost_root`, `boost_include`, and
+`boost_librarydir` in your native or cross machine file. Note that
+machine file variables are preferred to environment variables, and
+that specifying any of these disables system-wide search for boost.
+
+You can set the argument `threading` to `single` to use boost
+libraries that have been compiled for single-threaded use instead.
+
+## CUDA
+
+*(added 0.53.0)*
+
+Enables compiling and linking against the CUDA Toolkit. The `version`
+and `modules` keywords may be passed to request the use of a specific
+CUDA Toolkit version and/or additional CUDA libraries, correspondingly:
+
+```meson
+dep = dependency('cuda', version : '>=10', modules : 'cublas')
+```
+
+Note that explicitly adding this dependency is only necessary if you are
+using CUDA Toolkit from a C/C++ file or project, or if you are utilizing
+additional toolkit libraries that need to be explicitly linked to. If the
+CUDA Toolkit cannot be found in the default paths on your system, you can
+set the path using `CUDA_PATH` explicitly.
+
+## CUPS
+
+`method` may be `auto`, `config-tool`, `pkg-config`, `cmake` or `extraframework`.
+
+## Curses
+
+*(Since 0.54.0)*
+
+Curses (and ncurses) are a cross platform pain in the butt. Meson
+wraps up these dependencies in the `curses` dependency. This covers
+both `ncurses` (preferred) and other curses implementations.
+
+`method` may be `auto`, `pkg-config`, `config-tool`, or `system`.
+
+*New in 0.56.0* The `config-tool` and `system` methods.
+
+To define some of the preprocessor symbols mentioned in the
+curses autoconf documentation(http://git.savannah.gnu.org/gitweb/?p=autoconf-archive.git;a=blob_plain;f=m4/ax_with_curses.m4):
+
+```meson
+conf = configuration_data()
+check_headers = 
+  'ncursesw/menu.h', 'HAVE_NCURSESW_MENU_H',
+  'ncurses/menu.h', 'HAVE_NCURSES_MENU_H',
+  'menu.h', 'HAVE_MENU_H',
+  'ncursesw/curses.h', 'HAVE_NCURSESW_CURSES_H',
+  'ncursesw.h', 'HAVE_NCURSESW_H',
+  'ncurses/curses.h', 'HAVE_NCURSES_CURSES_H',
+  'ncurses.h', 'HAVE_NCURSES_H',
+  'curses.h', 'HAVE_CURSES_H',
+
+
+foreach h : check_headers
+  if compiler.has_header(h.get(0))
+    conf.set(h.get(1), 1)
+  endif
+endforeach
+```
+
+## dl (libdl)
+
+*(added 0.62.0)*
+
+Provides access to the dynamic link interface (functions: dlopen,
+dlclose, dlsym and others). On systems where this is not built
+into libc (mostly glibc < 2.34), tries to find an external library
+providing them instead.
+
+`method` may be `auto`, `builtin` or `system`.
+
+## Fortran Coarrays
+
+*(added 0.50.0)*
+
+ Coarrays are a Fortran language intrinsic feature, enabled by
+`dependency('coarray')`.
+
+GCC will use OpenCoarrays if present to implement coarrays, while Intel and NAG
+use internal coarray support.
+
+## GPGME
+
+*(added 0.51.0)*
+
+`method` may be `auto`, `config-tool` or `pkg-config`.
+
+## GL
+
+This finds the OpenGL library in a way appropriate to the platform.
+
+`method` may be `auto`, `pkg-config` or `system`.
+
+## GTest and GMock
+
+GTest and GMock come as sources that must be compiled as part of your
+project. With Meson you don't have to care about the details, just
+pass `gtest` or `gmock` to `dependency` and it will do everything for
+you. If you want to use GMock, it is recommended to use GTest as well,
+as getting it to work standalone is tricky.
+
+You can set the `main` keyword argument to `true` to use the `main()`
+function provided by GTest:
+
+```meson
+gtest_dep = dependency('gtest', main : true, required : false)
+e = executable('testprog', 'test.cc', dependencies : gtest_dep)
+test('gtest test', e)
+```
+
+## HDF5
+
+*(added 0.50.0)*
+
+HDF5 is supported for C, C++ and Fortran. Because dependencies are
+language-specific, you must specify the requested language using the
+`language` keyword argument, i.e.,
+ * `dependency('hdf5', language: 'c')` for the C HDF5 headers and libraries
+ * `dependency('hdf5', language: 'cpp')` for the C++ HDF5 headers and libraries
+ * `dependency('hdf5', language: 'fortran')` for the Fortran HDF5 headers and libraries
+
+Meson uses pkg-config to find HDF5. The standard low-level HDF5
+function and the `HL` high-level HDF5 functions are linked for each
+language.
+
+`method` may be `auto`, `config-tool` or `pkg-config`.
+
+*New in 0.56.0* the `config-tool` method.
+*New in 0.56.0* the dependencies now return proper dependency types
+ and `get_variable` and similar methods should work as expected.
+
+## iconv
+
+*(added 0.60.0)*
+
+Provides access to the `iconv` family of C functions. On systems where this is
+not built into libc, tries to find an external library providing them instead.
+
+`method` may be `auto`, `builtin` or `system`.
+
+## intl
+
+*(added 0.59.0)*
+
+Provides access to the `*gettext` family of C functions. On systems where this
+is not built into libc, tries to find an external library providing them
+instead.
+
+`method` may be `auto`, `builtin` or `system`.
+
+## JDK
+
+*(added 0.58.0)*
+*(deprecated 0.62.0)*
+
+Deprecated name for JNI. `dependency('jdk')` instead of `dependency('jni')`.
+
+## JNI
+
+*(added 0.62.0)*
+
+`modules` is an optional list of strings containing any of `jvm` and `awt`.
+
+Provides access to compiling with the Java Native Interface (JNI). The lookup
+will first check if `JAVA_HOME` is set in the environment, and if not will use
+the resolved path of `javac`. Systems will usually link your preferred JDK to
+well known paths like `/usr/bin/javac` on Linux for instance. Using the path
+from `JAVA_HOME` or the resolved `javac`, this dependency will place the JDK
+installation's `include` directory and its platform-dependent subdirectory on
+the compiler's include path. If `modules` is non-empty, then the proper linker
+arguments will also be added.
+
+```meson
+dep = dependency('jni', version: '>= 1.8.0', modules: 'jvm')
+```
+
+**Note**: Due to usage of a resolved path, upgrading the JDK may cause the
+various paths to not be found. In that case, please reconfigure the build
+directory. One workaround is to explicitly set `JAVA_HOME` instead of relying on
+the fallback `javac` resolved path behavior.
+
+**Note**: Include paths might be broken on platforms other than `linux`,
+`windows`, `darwin`, and `sunos`. Please submit a PR or open an issue in this
+case.
+
+**Note**: Use of the `modules` argument on a JDK `<= 1.8` may be broken if your
+system is anything other than `x86_64`. Please submit a PR or open an issue in
+this case.
+
+## libgcrypt
+
+*(added 0.49.0)*
+
+`method` may be `auto`, `config-tool` or `pkg-config`.
+
+## libwmf
+
+*(added 0.44.0)*
+
+`method` may be `auto`, `config-tool` or `pkg-config`.
+
+## LLVM
+
+Meson has native support for LLVM going back to version LLVM version
+3.5. It supports a few additional features compared to other
+config-tool based dependencies.
+
+As of 0.44.0 Meson supports the `static` keyword argument for LLVM.
+Before this LLVM >= 3.9 would always dynamically link, while older
+versions would statically link, due to a quirk in `llvm-config`.
+
+`method` may be `auto`, `config-tool`, or `cmake`.
+
+### Modules, a.k.a. Components
+
+Meson wraps LLVM's concept of components in its own modules concept.
+When you need specific components you add them as modules as Meson
+will do the right thing:
+
+```meson
+llvm_dep = dependency('llvm', version : '>= 4.0', modules : 'amdgpu')
+```
+
+As of 0.44.0 it can also take optional modules (these will affect the arguments
+generated for a static link):
+
+```meson
+llvm_dep = dependency(
+  'llvm', version : '>= 4.0', modules : 'amdgpu', optional_modules : 'inteljitevents',
+)
+```
+
+### Using LLVM tools
+
+When using LLVM as library but also needing its tools, it is often
+beneficial to use the same version. This can partially be achieved
+with the `version` argument of `find_program()`. However,
+distributions tend to package different LLVM versions in rather
+different ways. Therefore, it is often better to use the llvm
+dependency directly to retrieve the tools:
+
+```meson
+llvm_dep = dependency('llvm', version : '>= 8', '< 9')
+llvm_link = find_program(llvm_dep.get_variable(configtool: 'bindir') / 'llvm-link')
+```
+
+## MPI
+
+*(added 0.42.0)*
+
+MPI is supported for C, C++ and Fortran. Because dependencies are
+language-specific, you must specify the requested language using the
+`language` keyword argument, i.e.,
+ * `dependency('mpi', language: 'c')` for the C MPI headers and libraries
+ * `dependency('mpi', language: 'cpp')` for the C++ MPI headers and libraries
+ * `dependency('mpi', language: 'fortran')` for the Fortran MPI headers and libraries
+
+Meson prefers pkg-config for MPI, but if your MPI implementation does
+not provide them, it will search for the standard wrapper executables,
+`mpic`, `mpicxx`, `mpic++`, `mpifort`, `mpif90`, `mpif77`. If these
+are not in your path, they can be specified by setting the standard
+environment variables `MPICC`, `MPICXX`, `MPIFC`, `MPIF90`, or
+`MPIF77`, during configuration. It will also try to use the Microsoft
+implementation on windows via the `system` method.
+
+`method` may be `auto`, `config-tool`, `pkg-config` or `system`.
+
+*New in 0.54.0* The `config-tool` and `system` method values. Previous
+versions would always try `pkg-config`, then `config-tool`, then `system`.
+
+## NetCDF
+
+*(added 0.50.0)*
+
+NetCDF is supported for C, C++ and Fortran. Because NetCDF dependencies are
+language-specific, you must specify the requested language using the
+`language` keyword argument, i.e.,
+ * `dependency('netcdf', language: 'c')` for the C NetCDF headers and libraries
+ * `dependency('netcdf', language: 'cpp')` for the C++ NetCDF headers and libraries
+ * `dependency('netcdf', language: 'fortran')` for the Fortran NetCDF headers and libraries
+
+Meson uses pkg-config to find NetCDF.
+
+## OpenMP
+
+*(added 0.46.0)*
+
+This dependency selects the appropriate compiler flags and/or libraries to use
+for OpenMP support.
+
+The `language` keyword may used.
+
+## OpenSSL
+
+*(added 0.62.0)*
+
+`method` may be `auto`, `pkg-config`, `system` or `cmake`.
+
+## pcap
+
+*(added 0.42.0)*
+
+`method` may be `auto`, `config-tool` or `pkg-config`.
+
+## Python3
+
+Python3 is handled specially by Meson:
+1. Meson tries to use `pkg-config`.
+2. If `pkg-config` fails Meson uses a fallback:
+    - On Windows the fallback is the current `python3` interpreter.
+    - On OSX the fallback is a framework dependency from `/Library/Frameworks`.
+
+Note that `python3` found by this dependency might differ from the one
+used in `python3` module because modules uses the current interpreter,
+but dependency tries `pkg-config` first.
+
+`method` may be `auto`, `extraframework`, `pkg-config` or `sysconfig`
+
+## Qt4 & Qt5
+
+Meson has native Qt support. Its usage is best demonstrated with an
+example.
+
+```meson
+qt5_mod = import('qt5')
+qt5widgets = dependency('qt5', modules : 'Widgets')
+
+processed = qt5_mod.preprocess(
+  moc_headers : 'mainWindow.h',   # Only headers that need moc should be put here
+  moc_sources : 'helperFile.cpp', # must have #include"moc_helperFile.cpp"
+  ui_files    : 'mainWindow.ui',
+  qresources  : 'resources.qrc',
+)
+
+q5exe = executable('qt5test',
+  sources     : 'main.cpp',
+                 'mainWindow.cpp',
+                 processed,
+  dependencies: qt5widgets)
+```
+
+Here we have an UI file created with Qt Designer and one source and
+header file each that require preprocessing with the `moc` tool. We
+also define a resource file to be compiled with `rcc`. We just have to
+tell Meson which files are which and it will take care of invoking all
+the necessary tools in the correct order, which is done with the
+`preprocess` method of the `qt5` module. Its output is simply put in
+the list of sources for the target. The `modules` keyword of
+`dependency` works just like it does with Boost. It tells which
+subparts of Qt the program uses.
+
+You can set the `main` keyword argument to `true` to use the
+`WinMain()` function provided by qtmain static library (this argument
+does nothing on platforms other than Windows).
+
+Setting the optional `private_headers` keyword to true adds the
+private header include path of the given module(s) to the compiler
+flags. (since v0.47.0)
+
+**Note** using private headers in your project is a bad idea, do so at
+your own risk.
+
+`method` may be `auto`, `pkg-config` or `qmake`.
+
+## SDL2
+
+SDL2 can be located using `pkg-confg`, the `sdl2-config` config tool,
+or as an OSX framework.
+
+`method` may be `auto`, `config-tool`, `extraframework` or
+`pkg-config`.
+
+## Shaderc
+
+*(added 0.51.0)*
+
+Meson will first attempt to find shaderc using `pkg-config`. Upstream
+currently ships three different `pkg-config` files and by default will
+check them in this order: `shaderc`, `shaderc_combined`, and
+`shaderc_static`. If the `static` keyword argument is `true`, then
+Meson instead checks in this order: `shaderc_combined`, `shaderc_static`,
+and `shaderc`.
+
+If no `pkg-config` file is found, then Meson will try to detect the
+library manually. In this case, it will try to link against either
+`-lshaderc_shared` or `-lshaderc_combined`, preferring the latter
+if the static keyword argument is true. Note that it is not possible
+to obtain the shaderc version using this method.
+
+`method` may be `auto`, `pkg-config` or `system`.
+
+## Threads
+
+This dependency selects the appropriate compiler flags and/or
+libraries to use for thread support.
+
+See threads(Threads.md).
+
+## Valgrind
+
+Meson will find valgrind using `pkg-config`, but only uses the
+compilation flags and avoids trying to link with its non-PIC static
+libs.
+
+## Vulkan
+
+*(added 0.42.0)*
+
+Vulkan can be located using `pkg-config`, or the `VULKAN_SDK`
+environment variable.
+
+`method` may be `auto`, `pkg-config` or `system`.
+
+## WxWidgets
+
+Similar to Boost(#boost), WxWidgets is not a single library but rather
+a collection of modules. WxWidgets is supported via `wx-config`.
+Meson substitutes `modules` to `wx-config` invocation, it generates
+- `compile_args` using `wx-config --cxxflags $modules...`
+- `link_args` using `wx-config --libs $modules...`
+
+### Example
+
+```meson
+wx_dep = dependency(
+  'wxwidgets', version : '>=3.0.0', modules : 'std', 'stc',
+)
+```
+
+```shell
+# compile_args:
+$ wx-config --cxxflags std stc
+
+# link_args:
+$ wx-config --libs std stc
+```
+
+## Zlib
+
+Zlib ships with pkg-config and cmake support, but on some operating
+systems (windows, macOs, FreeBSD, dragonflybsd, android), it is provided as
+part of the base operating system without pkg-config support. The new
+System finder can be used on these OSes to link with the bundled
+version.
+
+`method` may be `auto`, `pkg-config`, `cmake`, or `system`.
+
+*New in 0.54.0* the `system` method.
+
+<hr>
+<a name="footnote1">1</a>: They may appear to be case-insensitive, if the
+    underlying file system happens to be case-insensitive.

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/Design-rationale.md Added

@@ -0,0 +1,261 @@
+---
+title: Design rationale
+...
+
+This is the original design rationale for Meson. The syntax it
+describes does not match the released version
+==
+
+A software developer's most important tool is the editor. If you talk
+to coders about the editors they use, you are usually met with massive
+enthusiasm and praise. You will hear how Emacs is the greatest thing
+ever or how vi is so elegant or how Eclipse's integration features
+make you so much more productive. You can sense the enthusiasm and
+affection that the people feel towards these programs.
+
+The second most important tool, even more important than the compiler,
+is the build system.
+
+Those are pretty much universally despised.
+
+The most positive statement on build systems you can usually get (and
+it might require some coaxing) is something along the lines of *well,
+it's a terrible system, but all other options are even worse*. It is
+easy to see why this is the case. For starters, commonly used free
+build systems have obtuse syntaxes. They use for the most part global
+variables that are set in random locations so you can never really be
+sure what a given line of code does. They do strange and unpredictable
+things at every turn.
+
+Let's illustrate this with a simple example. Suppose we want to run a
+program built with GNU Autotools under GDB. The instinctive thing to
+do is to just run `gdb programname`. The problem is that this may or
+may not work. In some cases the executable file is a binary whereas at
+other times it is a wrapper shell script that invokes the real binary
+which resides in a hidden subdirectory. GDB invocation fails if the
+binary is a script but succeeds if it is not. The user has to remember
+the type of each one of his executables (which is an implementation
+detail of the build system) just to be able to debug them. Several
+other such pain points can be found in this blog
+post(http://voices.canonical.com/jussi.pakkanen/2011/09/13/autotools/).
+
+Given these idiosyncrasies it is no wonder that most people don't want
+to have anything to do with build systems. They'll just copy-paste
+code that works (somewhat) in one place to another and hope for the
+best. They actively go out of their way not to understand the system
+because the mere thought of it is repulsive. Doing this also provides
+a kind of inverse job security. If you don't know tool X, there's less
+chance of finding yourself responsible for its use in your
+organisation. Instead you get to work on more enjoyable things.
+
+This leads to a vicious circle. Since people avoid the tools and don't
+want to deal with them, very few work on improving them. The result is
+apathy and stagnation.
+
+Can we do better?
+--
+
+At its core, building C and C++ code is not a terribly difficult
+task. In fact, writing a text editor is a lot more complicated and
+takes more effort. Yet we have lots of very high quality editors but
+only few build systems with questionable quality and usability.
+
+So, in the grand tradition of own-itch-scratching, I decided to run a
+scientific experiment. The purpose of this experiment was to explore
+what would it take to build a "good" build system. What kind of syntax
+would suit this problem? What sort of problems would this application
+need to solve? What sort of solutions would be the most appropriate?
+
+To get things started, here is a list of requirements any modern
+cross-platform build system needs to provide.
+
+### 1. Must be simple to use
+
+One of the great virtues of Python is the fact that it is very
+readable. It is easy to see what a given block of code does. It is
+concise, clear and easy to understand. The proposed build system must
+be syntactically and semantically clean. Side effects, global state
+and interrelations must be kept at a minimum or, if possible,
+eliminated entirely.
+
+### 2. Must do the right thing by default
+
+Most builds are done by developers working on the code. Therefore the
+defaults must be tailored towards that use case. As an example the
+system shall build objects without optimization and with debug
+information. It shall make binaries that can be run directly from the
+build directory without linker tricks, shell scripts or magic
+environment variables.
+
+### 3. Must enforce established best practices
+
+There really is no reason to compile source code without the
+equivalent of `-Wall`. So enable it by default. A different kind of
+best practice is the total separation of source and build
+directories. All build artifacts must be stored in the build
+directory. Writing stray files in the source directory is not
+permitted under any circumstances.
+
+### 4. Must have native support for platforms that are in common use
+
+A lot of free software projects can be used on non-free platforms such
+as Windows or OSX. The system must provide native support for the
+tools of choice on those platforms. In practice this means native
+support for Visual Studio and XCode. Having said IDEs invoke external
+builder binaries does not count as native support.
+
+### 5. Must not add complexity due to obsolete platforms
+
+Work on this build system started during the Christmas holidays of 2012.
+This provides a natural hard cutoff line of 2012/12/24. Any
+platform, tool or library that was not in active use at that time is
+explicitly not supported. These include Unixes such as IRIX, SunOS,
+OSF-1, Ubuntu versions older than 12/10, GCC versions older than 4.7
+and so on. If these old versions happen to work, great. If they don't,
+not a single line of code will be added to the system to work around
+their bugs.
+
+### 6. Must be fast
+
+Running the configuration step on a moderate sized project must not
+take more than five seconds. Running the compile command on a fully up
+to date tree of 1000 source files must not take more than 0.1 seconds.
+
+### 7. Must provide easy to use support for modern sw development features
+
+An example is precompiled headers. Currently no free software build
+system provides native support for them. Other examples could include
+easy integration of Valgrind and unit tests, test coverage reporting
+and so on.
+
+### 8. Must allow override of default values
+
+Sometimes you just have to compile files with only given compiler
+flags and no others, or install files in weird places. The system must
+allow the user to do this if he really wants to.
+
+Overview of the solution
+--
+
+Going over these requirements it becomes quite apparent that the only
+viable approach is roughly the same as taken by CMake: having a domain
+specific language to declare the build system. Out of this declaration
+a configuration is generated for the backend build system. This can be
+a Makefile, Visual Studio or XCode project or anything else.
+
+The difference between the proposed DSL and existing ones is that the
+new one is declarative. It also tries to work on a higher level of
+abstraction than existing systems. As an example, using external
+libraries in current build systems means manually extracting and
+passing around compiler flags and linker flags. In the proposed system
+the user just declares that a given build target uses a given external
+dependency. The build system then takes care of passing all flags and
+settings to their proper locations. This means that the user can focus
+on his own code rather than marshalling command line arguments from
+one place to another.
+
+A DSL is more work than the approach taken by SCons, which is to
+provide the system as a Python library. However it allows us to make
+the syntax more expressive and prevent certain types of bugs by
+e.g. making certain objects truly immutable. The end result is again
+the same: less work for the user.
+
+The backend for Unix requires a bit more thought. The default choice
+would be Make. However it is extremely slow. It is not uncommon on
+large code bases for Make to take several minutes just to determine
+that nothing needs to be done. Instead of Make we use
+Ninja(https://ninja-build.org/), which is extremely fast. The
+backend code is abstracted away from the core, so other backends can
+be added with relatively little effort.
+
+Sample code
+--
+
+Enough design talk, let's get to the code. Before looking at the
+examples we would like to emphasize that this is not in any way the
+final code. It is proof of concept code that works in the system as it
+currently exists (February 2013), but may change at any time.
+
+Let's start simple. Here is the code to compile a single executable
+binary.
+
+```meson
+project('compile one', 'c')
+executable('program', 'prog.c')
+```
+
+This is about as simple as one can get. First you declare the project
+name and the languages it uses. Then you specify the binary to build
+and its sources. The build system will do all the rest. It will add
+proper suffixes (e.g. '.exe' on Windows), set the default compiler
+flags and so on.
+
+Usually programs have more than one source file. Listing them all in
+the function call can become unwieldy. That is why the system supports
+keyword arguments. They look like this.
+
+```meson
+project('compile several', 'c')
+sourcelist = 'main.c', 'file1.c', 'file2.c', 'file3.c'
+executable('program', sources : sourcelist)
+```
+
+External dependencies are simple to use.
+
+```meson
+project('external lib', 'c')
+libdep = find_dep('extlibrary', required : true)
+sourcelist = 'main.c', 'file1.c', 'file2.c', 'file3.c'
+executable('program', sources : sourcelist, dep : libdep)
+```
+
+In other build systems you have to manually add the compile and link
+flags from external dependencies to targets. In this system you just
+declare that extlibrary is mandatory and that the generated program
+uses that. The build system does all the plumbing for you.
+
+Here's a slightly more complicated definition. It should still be
+understandable.
+
+```meson
+project('build library', 'c')
+foolib = shared_library('foobar', sources : 'foobar.c',\
+install : true)
+exe = executable('testfoobar', 'tester.c', link : foolib)
+add_test('test library', exe)
+```
+
+First we build a shared library named foobar. It is marked
+installable, so running `meson install` installs it to the library
+directory (the system knows which one so the user does not have to
+care). Then we build a test executable which is linked against the
+library. It will not be installed, but instead it is added to the list
+of unit tests, which can be run with the command `meson test`.
+
+Above we mentioned precompiled headers as a feature not supported by
+other build systems. Here's how you would use them.
+
+```meson
+project('pch demo', 'cxx')
+executable('myapp', 'myapp.cpp', pch : 'pch/myapp.hh')
+```
+
+The main reason other build systems can not provide pch support this
+easily is because they don't enforce certain best practices. Due to
+the way include paths work, it is impossible to provide pch support
+that always works with both in-source and out-of-source
+builds. Mandating separate build and source directories makes this and
+many other problems a lot easier.
+
+Get the code
+--
+
+The code for this experiment can be found at the Meson
+repository(https://github.com/mesonbuild/meson). It should be noted
+that (at the time of writing) it is not a build system. It is only
+a proposal for one. It does not work reliably yet. You probably
+should not use it as the build system of your project.
+
+All that said I hope that this experiment will eventually turn into a
+full blown build system. For that I need your help. Comments and
+especially patches are more than welcome.

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/Disabler.md Added

@@ -0,0 +1,68 @@
+---
+short-description: Disabling options
+...
+
+# Disabling parts of the build
+
+*This feature is available since version 0.44.0.*
+
+The following is a common fragment found in many projects:
+
+```meson
+dep = dependency('foo')
+
+# In some different directory
+
+lib = shared_library('mylib', 'mylib.c',
+  dependencies : dep)
+
+# And ín a third directory
+
+exe = executable('mytest', 'mytest.c',
+  link_with : lib)
+test('mytest', exe)
+```
+
+This works fine but gets a bit inflexible when you want to make this
+part of the build optional. Basically it reduces to adding `if/else`
+statements around all target invocations. Meson provides a simpler way
+of achieving the same with a disabler object.
+
+A disabler object is created with the `disabler` function:
+
+```meson
+d = disabler()
+```
+
+The only thing you can do to a disabler object is to ask if it has
+been found:
+
+```meson
+f = d.found() # returns false
+```
+
+Any other statement that uses a disabler object will immediately
+return a disabler. For example assuming that `d` contains a disabler
+object then
+
+```meson
+d2 = some_func(d) # value of d2 will be disabler
+d3 = true or d2   # value of d3 will be true because of short-circuiting
+d4 = false or d2  # value of d4 will be disabler
+if d              # neither branch is evaluated
+```
+
+Thus to disable every target that depends on the dependency given
+above, you can do something like this:
+
+```meson
+if use_foo_feature
+  d = dependency('foo')
+else
+  d = disabler()
+endif
+```
+
+This concentrates the handling of this option in one place and other
+build definition files do not need to be sprinkled with `if`
+statements.

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/Dlang-module.md Added

@@ -0,0 +1,44 @@
+# Dlang module
+
+This module provides tools related to the D programming language.
+
+## Usage
+
+To use this module, just do: **`dlang = import('dlang')`**.
+You can, of course, replace the name `dlang` with anything else.
+
+The module only exposes one function, `generate_dub_file`, used to
+automatically generate Dub configuration files.
+
+### generate_dub_file()
+This method only has two required arguments, the project name and the
+source folder. You can pass other arguments with additional keywords,
+they will be automatically translated to json and added to the
+`dub.json` file.
+
+**Structure**
+```meson
+generate_dub_file("project name", "source/folder", key: "value" ...)
+```
+
+**Example**
+```meson
+dlang = import('dlang')
+dlang.generate_dub_file(meson.project_name().to_lower(), meson.source_root(),
+                        authors: 'Meson Team',
+                        description: 'Test executable',
+                        copyright: 'Copyright © 2018, Meson Team',
+                        license: 'MIT',
+                        sourceFiles: 'test.d',
+                        targetType: 'executable',
+                        dependencies: my_dep
+)
+```
+
+You can manually edit a Meson generated `dub.json` file or provide a
+initial one. The module will only update the values specified in
+`generate_dub_file()`.
+
+Although not required, you will need to have a `description` and
+`license` if you want to publish the package in the D package
+registry(https://code.dlang.org/).

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/External-Project-module.md Added

@@ -0,0 +1,138 @@
+# External Project module
+
+**Note**: the functionality of this module is governed by Meson's
+  rules on mixing build systems(Mixing-build-systems.md).
+
+*This is an experimental module, API could change.*
+
+This module allows building code that uses build systems other than
+Meson. This module is intended to be used to build Autotools
+subprojects as fallback if the dependency couldn't be found on the
+system (e.g. too old distro version).
+
+The project will be compiled out-of-tree inside Meson's build
+directory. The project will also be installed inside Meson's build
+directory using make's
+`DESTDIR`(https://www.gnu.org/prep/standards/html_node/DESTDIR.html)
+feature. During project installation step, that DESTDIR will be copied
+verbatim into the desired location.
+
+External subprojects can use libraries built by Meson (main project,
+or other subprojects) using pkg-config, thanks to `*-uninstalled.pc`
+files generated by `pkg.generate()`(Pkgconfig-module.md).
+
+External build system requirements:
+
+- Must support out-of-tree build. The configure script will be invoked with the
+  current workdir inside Meson's build directory and not subproject's top source
+  directory.
+- Configure script must generate a `Makefile` in the current workdir.
+- Configure script must take common directories like prefix, libdir, etc, as
+  command line arguments.
+- Configure script must support common environment variable like CFLAGS, CC, etc.
+- Compilation step must detect when a reconfigure is needed, and do it
+  transparently.
+
+Known limitations:
+
+- Executables from external projects cannot be used uninstalled, because they
+  would need its libraries to be installed in the final location. This is why
+  there is no `find_program()` method.
+- The configure script must generate a `Makefile`, other build systems are not
+  yet supported.
+- When cross compiling, if `PKG_CONFIG_SYSROOT_DIR` is set in environment or
+  `sys_root` in the cross file properties, the external subproject will not be
+  able to find dependencies built by Meson using pkg-config. The reason is
+  pkg-config and pkgconf both prepend the sysroot path to `-I` and `-L` arguments
+  from `-uninstalled.pc` files. This is arguably a bug that could be fixed in
+  future version of pkg-config/pkgconf.
+
+*Added 0.56.0*
+
+## Functions
+
+### `add_project()`
+
+This function should be called at the root directory of a project
+using another build system. Usually in a `meson.build` file placed in
+the top directory of a subproject, but could be also in any subdir.
+
+Its first positional argument is the name of the configure script to
+be executed (e.g. `configure`), that file must be in the current
+directory and executable. Note that if a bootstrap script is required
+(e.g. `autogen.sh` when building from git instead of tarball), it can
+be done using `run_command()` before calling `add_project()` method.
+
+*Since 0.60.0* If the first positional argument is `'waf'`, special treatment
+is done for the waf(https://waf.io/) build system. The waf executable must be
+found either in the current directory, or in system `PATH`.
+
+Keyword arguments:
+
+- `configure_options`: An array of strings to be passed as arguments to the
+  configure script. Some special tags will be replaced by Meson before passing
+  them to the configure script: `@PREFIX@`, `@LIBDIR@` and `@INCLUDEDIR@`.
+  Note that `libdir` and `includedir` paths are relative to `prefix` in Meson
+  but some configure scripts requires absolute path, in that case they can be
+  passed as `'--libdir=@PREFIX@/@LIBDIR@'`. *Since 0.57.0* default arguments are
+  added in case some tags are not found in `configure_options`:
+  `'--prefix=@PREFIX@'`, `'--libdir=@PREFIX@/@LIBDIR@'`, and
+  `'--includedir=@PREFIX@/@INCLUDEDIR@'`. It was previously considered a fatal
+  error to not specify them.
+- `cross_configure_options`: Extra options appended to `configure_options` only
+  when cross compiling. special tag `@HOST@` will be replaced by
+  `'{}-{}-{}'.format(host_machine.cpu_family(), build_machine.system(), host_machine.system()`.
+  If omitted it defaults to `'--host=@HOST@'`.
+- `verbose`: If set to `true` the output of sub-commands ran to configure, build
+  and install the project will be printed onto Meson's stdout.
+- `env` : environment variables to set, such as `'NAME1=value1', 'NAME2=value2'`,
+  a dictionary, or an @env object.
+- `depends` : *Since 0.63.0* Specifies that this project depends on the specified
+  target(s) that must be built before running `make` to build this external
+  project. This should be used for example when the external project links to a
+  Meson `library()` that the `configure` script will find using the
+  `-uninstalled.pc` pkg-config file generated by Meson.
+
+Returns an `ExternalProject`(#ExternalProject_object) object
+
+## `ExternalProject` object
+
+### Methods
+
+#### `dependency(libname)`
+
+Return a dependency object that can be used to build targets against a library
+from the external project.
+
+Keyword arguments:
+- `subdir` path relative to `includedir` to be added to the header search path.
+
+## Example `meson.build` file for a subproject
+
+```meson
+project('My Autotools Project', 'c',
+  meson_version : '>=0.56.0',
+)
+
+mod = import('unstable-external_project')
+
+p = mod.add_project('configure',
+  configure_options : '--prefix=@PREFIX@',
+                       '--libdir=@LIBDIR@',
+                       '--incdir=@INCLUDEDIR@',
+                       '--enable-foo',
+                      ,
+)
+
+mylib_dep = p.dependency('mylib')
+meson.override_dependency('mylib', mylib_dep)
+```
+
+## Using wrap file
+
+Most of the time the project will be built as a subproject, and
+fetched using a `.wrap` file. In that case the simple `meson.build`
+file needed to build the subproject can be provided by adding
+`patch_directory=mysubproject` line in the wrap file, and place the
+build definition file at
+`subprojects/packagefiles/mysubproject/meson.build`.

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/External-commands.md Added

@@ -0,0 +1,52 @@
+---
+short-description: Running external commands
+...
+
+# External commands
+
+As a part of the software configuration, you may want to get extra
+data by running external commands. The basic syntax is the following.
+
+```meson
+r = run_command('command', 'arg1', 'arg2', 'arg3', check: true)
+output = r.stdout().strip()
+errortxt = r.stderr().strip()
+```
+
+If `check: true` is given, meson will error out if `command` returns with a
+non-zero exit code. Alternatively, you can set `check: false` and get the exit
+code with `r.returncode()`.
+
+Since 0.52.0, you can pass the command environment as a dictionary:
+
+```meson
+run_command('command', 'arg1', 'arg2', env: {'FOO': 'bar'}, check: true)
+```
+
+Since 0.50.0, you can also pass the command @env object:
+
+```meson
+env = environment()
+env.set('FOO', 'bar')
+run_command('command', 'arg1', 'arg2', env: env)
+```
+
+The `run_command` function returns an object that can be queried for
+return value and text written to stdout and stderr. The `strip` method
+call is used to strip trailing and leading whitespace from strings.
+Usually output from command line programs ends in a newline, which is
+unwanted in string variables. The first argument can be either a
+string or an executable you have detected earlier with `find_program`.
+
+Meson will autodetect scripts with a shebang line and run them with
+the executable/interpreter specified in it both on Windows and on
+Unixes.
+
+Note that you can not pass your command line as a single string. That
+is, calling `run_command('do_something foo bar')` will not work. You
+must either split up the string into separate arguments or pass the
+split command as an array. It should also be noted that Meson will not
+pass the command to the shell, so any command lines that try to use
+things such as environment variables, backticks or pipelines will not
+work. If you require shell semantics, write your command into a script
+file and call that with `run_command`.

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/FAQ.md Added

@@ -0,0 +1,694 @@
+---
+title: FAQ
+...
+# Meson Frequently Asked Questions
+
+See also How do I do X in Meson(howtox.md).
+
+## Why is it called Meson?
+
+When the name was originally chosen, there were two main limitations:
+there must not exist either a Debian package or a Sourceforge project
+of the given name. This ruled out tens of potential project names. At
+some point the name Gluon was considered. Gluons are elementary
+particles that hold protons and neutrons together, much like a build
+system's job is to take pieces of source code and a compiler and bind
+them to a complete whole.
+
+Unfortunately this name was taken, too. Then the rest of subatomic
+particles were examined and Meson was found to be available.
+
+## What is the correct way to use threads (such as pthreads)?
+
+```meson
+thread_dep = dependency('threads')
+```
+
+This will set up everything on your behalf. People coming from
+Autotools or CMake want to do this by looking for `libpthread.so`
+manually. Don't do that, it has tricky corner cases especially when
+cross compiling.
+
+## How to use Meson on a host where it is not available in system packages?
+
+Starting from version 0.29.0, Meson is available from the Python
+Package Index(https://pypi.python.org/pypi/meson/), so installing it
+simply a matter of running this command:
+
+```console
+$ pip3 install <your options here> meson
+```
+
+If you don't have access to PyPI, that is not a problem either. Meson
+has been designed to be easily runnable from an extracted source
+tarball or even a git checkout. First you need to download Meson. Then
+use this command to set up you build instead of plain `meson`.
+
+```console
+$ /path/to/meson.py <options>
+```
+
+After this you don't have to care about invoking Meson any more. It
+remembers where it was originally invoked from and calls itself
+appropriately. As a user the only thing you need to do is to `cd` into
+your build directory and invoke `meson compile`.
+
+## Why can't I specify target files with a wildcard?
+
+Instead of specifying files explicitly, people seem to want to do this:
+
+```meson
+executable('myprog', sources : '*.cpp') # This does NOT work!
+```
+
+Meson does not support this syntax and the reason for this is simple.
+This can not be made both reliable and fast. By reliable we mean that
+if the user adds a new source file to the subdirectory, Meson should
+detect that and make it part of the build automatically.
+
+One of the main requirements of Meson is that it must be fast. This
+means that a no-op build in a tree of 10 000 source files must take no
+more than a fraction of a second. This is only possible because Meson
+knows the exact list of files to check. If any target is specified as
+a wildcard glob, this is no longer possible. Meson would need to
+re-evaluate the glob every time and compare the list of files produced
+against the previous list. This means inspecting the entire source
+tree (because the glob pattern could be `src/\*/\*/\*/\*.cpp` or
+something like that). This is impossible to do efficiently.
+
+The main backend of Meson is Ninja, which does not support wildcard
+matches either, and for the same reasons.
+
+Because of this, all source files must be specified explicitly.
+
+## But I really want to use wildcards!
+
+If the tradeoff between reliability and convenience is acceptable to
+you, then Meson gives you all the tools necessary to do wildcard
+globbing. You are allowed to run arbitrary commands during
+configuration. First you need to write a script that locates the files
+to compile. Here's a simple shell script that writes all `.c` files in
+the current directory, one per line.
+
+
+```bash
+#!/bin/sh
+
+for i in *.c; do
+  echo $i
+done
+```
+
+Then you need to run this script in your Meson file, convert the
+output into a string array and use the result in a target.
+
+```meson
+c = run_command('grabber.sh', check: true)
+sources = c.stdout().strip().split('\n')
+e = executable('prog', sources)
+```
+
+The script can be any executable, so it can be written in shell,
+Python, Lua, Perl or whatever you wish.
+
+As mentioned above, the tradeoff is that just adding new files to the
+source directory does *not* add them to the build automatically. To
+add them you need to tell Meson to reinitialize itself. The simplest
+way is to touch the `meson.build` file in your source root. Then Meson
+will reconfigure itself next time the build command is run. Advanced
+users can even write a small background script that utilizes a
+filesystem event queue, such as
+inotify(https://en.wikipedia.org/wiki/Inotify), to do this
+automatically.
+
+## Should I use `subdir` or `subproject`?
+
+The answer is almost always `subdir`. Subproject exists for a very
+specific use case: embedding external dependencies into your build
+process. As an example, suppose we are writing a game and wish to use
+SDL. Let us further suppose that SDL comes with a Meson build
+definition. Let us suppose even further that we don't want to use
+prebuilt binaries but want to compile SDL for ourselves.
+
+In this case you would use `subproject`. The way to do it would be to
+grab the source code of SDL and put it inside your own source
+tree. Then you would do `sdl = subproject('sdl')`, which would cause
+Meson to build SDL as part of your build and would then allow you to
+link against it or do whatever else you may prefer.
+
+For every other use you would use `subdir`. As an example, if you
+wanted to build a shared library in one dir and link tests against it
+in another dir, you would do something like this:
+
+```meson
+project('simple', 'c')
+subdir('src')   # library is built here
+subdir('tests') # test binaries would link against the library here
+```
+
+## Why is there not a Make backend?
+
+Because Make is slow. This is not an implementation issue, Make simply
+can not be made fast. For further info we recommend you read this
+post(http://neugierig.org/software/chromium/notes/2011/02/ninja.html)
+by Evan Martin, the author of Ninja. Makefiles also have a syntax that
+is very unpleasant to write which makes them a big maintenance burden.
+
+The only reason why one would use Make instead of Ninja is working on
+a platform that does not have a Ninja port. Even in this case it is an
+order of magnitude less work to port Ninja than it is to write a Make
+backend for Meson.
+
+Just use Ninja, you'll be happier that way. I guarantee it.
+
+## Why is Meson not just a Python module so I could code my build setup in Python?
+
+A related question to this is *Why is Meson's configuration language
+not Turing-complete?*
+
+There are many good reasons for this, most of which are summarized on
+this web page: Against The Use Of Programming Languages in
+Configuration Files(https://taint.org/2011/02/18/001527a.html).
+
+In addition to those reasons, not exposing Python or any other "real"
+programming language makes it possible to port Meson's implementation
+to a different language. This might become necessary if, for example,
+Python turns out to be a performance bottleneck. This is an actual
+problem that has caused complications for GNU Autotools and SCons.
+
+## How do I do the equivalent of Libtools export-symbol and export-regex?
+
+Either by using GCC symbol
+visibility(https://gcc.gnu.org/wiki/Visibility) or by writing a
+linker
+script(https://sourceware.org/binutils/docs/ld.html). This
+has the added benefit that your symbol definitions are in a standalone
+file instead of being buried inside your build definitions. An example
+can be found
+here(https://github.com/jpakkane/meson/tree/master/test%20cases/linuxlike/3%20linker%20script).
+
+## My project works fine on Linux and MinGW but fails to link with MSVC due to a missing .lib file (fatal error LNK1181). Why?
+
+With GCC, all symbols on shared libraries are exported automatically
+unless you specify otherwise. With MSVC no symbols are exported by
+default. If your shared library exports no symbols, MSVC will silently
+not produce an import library file leading to failures. The solution
+is to add symbol visibility definitions as specified in GCC
+wiki(https://gcc.gnu.org/wiki/Visibility).
+
+## I added some compiler flags and now the build fails with weird errors. What is happening?
+
+You probably did the equivalent to this:
+
+```meson
+executable('foobar', ...
+           c_args : '-some_arg -other_arg')
+```
+
+Meson is *explicit*. In this particular case it will **not**
+automatically split your strings at whitespaces, instead it will take
+it as is and work extra hard to pass it to the compiler unchanged,
+including quoting it properly over shell invocations. This is
+mandatory to make e.g. files with spaces in them work flawlessly. To
+pass multiple command line arguments, you need to explicitly put them
+in an array like this:
+
+```meson
+executable('foobar', ...
+           c_args : '-some_arg', '-other_arg')
+```
+
+## Why are changes to default project options ignored?
+
+You probably had a project that looked something like this:
+
+```meson
+project('foobar', 'cpp')
+```
+
+This defaults to `c++11` on GCC compilers. Suppose you want to use
+`c++14` instead, so you change the definition to this:
+
+```meson
+project('foobar', 'cpp', default_options : 'cpp_std=c++14')
+```
+
+But when you recompile, it still uses `c++11`. The reason for this is
+that default options are only looked at when you are setting up a
+build directory for the very first time. After that the setting is
+considered to have a value and thus the default value is ignored. To
+change an existing build dir to `c++14`, either reconfigure your build
+dir with `meson configure` or delete the build dir and recreate it
+from scratch.
+
+The reason we don't automatically change the option value when the
+default is changed is that it is impossible to know to do that
+reliably. The actual question that we need to solve is "if the
+option's value is foo and the default value is bar, should we change
+the option value to bar also". There are many choices:
+
+ - if the user has changed the value themselves from the default, then
+   we must not change it back
+
+ - if the user has not changed the value, but changes the default
+   value, then this section's premise would seem to indicate that the
+   value should be changed
+
+ - suppose the user changes the value from the default to foo, then
+   back to bar and then changes the default value to bar, the correct
+   step to take is ambiguous by itself
+
+In order to solve the latter question we would need to remember not
+only the current and old value, but also all the times the user has
+changed the value and from which value to which other value. Since
+people don't remember their own actions that far back, toggling
+between states based on long history would be confusing.
+
+Because of this we do the simple and understandable thing: default
+values are only defaults and will never affect the value of an option
+once set.
+
+## Does wrap download sources behind my back?
+
+It does not. In order for Meson to download anything from the net
+while building, two conditions must be met.
+
+First of all there needs to be a `.wrap` file with a download URL in
+the `subprojects` directory. If one does not exist, Meson will not
+download anything.
+
+The second requirement is that there needs to be an explicit
+subproject invocation in your `meson.build` files. Either
+`subproject('foobar')` or `dependency('foobar', fallback : 'foobar',
+'foo_dep')`. If these declarations either are not in any build file
+or they are not called (due to e.g. `if/else`) then nothing is
+downloaded.
+
+If this is not sufficient for you, starting from release 0.40.0 Meson
+has a option called `wrap-mode` which can be used to disable wrap
+downloads altogether with `--wrap-mode=nodownload`. You can also
+disable dependency fallbacks altogether with `--wrap-mode=nofallback`,
+which also implies the `nodownload` option.
+
+If on the other hand, you want Meson to always use the fallback
+for dependencies, even when an external dependency exists and could
+satisfy the version requirements, for example in order to make
+sure your project builds when fallbacks are used, you can use
+`--wrap-mode=forcefallback` since 0.46.0.
+
+## Why is Meson implemented in Python rather than programming language X?
+
+Because build systems are special in ways normal applications aren't.
+
+Perhaps the biggest limitation is that because Meson is used to build
+software at the very lowest levels of the OS, it is part of the core
+bootstrap for new systems. Whenever support for a new CPU architecture
+is added, Meson must run on the system before software using it can be
+compiled natively. This requirement adds two hard limitations.
+
+The first one is that Meson must have the minimal amount of
+dependencies, because they must all be built during the bootstrap to
+get Meson to work.
+
+The second is that Meson must support all CPU architectures, both
+existing and future ones. As an example many new programming languages
+have only an LLVM based compiler available. LLVM has limited CPU
+support compared to, say, GCC, and thus bootstrapping Meson on such
+platforms would first require adding new processor support to
+LLVM. This is in most cases unfeasible.
+
+A further limitation is that we want developers on as many platforms
+as possible to submit to Meson development using the default tools
+provided by their operating system. In practice what this means is
+that Windows developers should be able to contribute using nothing but
+Visual Studio.
+
+At the time of writing (April 2018) there are only three languages
+that could fulfill these requirements:
+
+ - C
+ - C++
+ - Python
+
+Out of these we have chosen Python because it is the best fit for our
+needs.
+
+## But I really want a version of Meson that doesn't use python!
+
+Ecosystem diversity is good. We encourage interested users to write this
+competing implementation of Meson themselves. As of September 2021, there are 3
+projects attempting to do just this:
+
+ - muon(https://git.sr.ht/~lattis/muon)
+ - Meson++(https://github.com/dcbaker/meson-plus-plus)
+ - boson(https://git.sr.ht/~bl4ckb0ne/boson)
+
+## I have proprietary compiler toolchain X that does not work with Meson, how can I make it work?
+
+Meson needs to know several details about each compiler in order to
+compile code with it. These include things such as which compiler
+flags to use for each option and how to detect the compiler from its
+output. This information can not be input via a configuration file,
+instead it requires changes to Meson's source code that need to be
+submitted to Meson master repository. In theory you can run your own
+forked version with custom patches, but that's not good use of your
+time. Please submit the code upstream so everyone can use the
+toolchain.
+
+The steps for adding a new compiler for an existing language are
+roughly the following. For simplicity we're going to assume a C
+compiler.
+
+- Create a new class with a proper name in
+  `mesonbuild/compilers/c.py`. Look at the methods that other
+  compilers for the same language have and duplicate what they do.
+
+- If the compiler can only be used for cross compilation, make sure to
+  flag it as such (see existing compiler classes for examples).
+
+- Add detection logic to `mesonbuild/environment.py`, look for a
+  method called `detect_c_compiler`.
+
+- Run the test suite and fix issues until the tests pass.
+
+- Submit a pull request, add the result of the test suite to your MR
+  (linking an existing page is fine).
+
+- If the compiler is freely available, consider adding it to the CI
+  system.
+
+## Why does building my project with MSVC output static libraries called `libfoo.a`?
+
+The naming convention for static libraries on Windows is usually
+`foo.lib`.  Unfortunately, import libraries are also called `foo.lib`.
+
+This causes filename collisions with the default library type where we
+build both shared and static libraries, and also causes collisions
+during installation since all libraries are installed to the same
+directory by default.
+
+To resolve this, we decided to default to creating static libraries of
+the form `libfoo.a` when building with MSVC. This has the following
+advantages:
+
+1. Filename collisions are completely avoided.
+1. The format for MSVC static libraries is `ar`, which is the same as the GNU
+   static library format, so using this extension is semantically correct.
+1. The static library filename format is now the same on all platforms and with
+   all toolchains.
+1. Both Clang and GNU compilers can search for `libfoo.a` when specifying
+   a library as `-lfoo`. This does not work for alternative naming schemes for
+   static libraries such as `libfoo.lib`.
+1. Since `-lfoo` works out of the box, pkgconfig files will work correctly for
+   projects built with both MSVC, GCC, and Clang on Windows.
+1. MSVC does not have arguments to search for library filenames, and it does
+   not care what the extension is(https://docs.microsoft.com/en-us/cpp/build/reference/link-input-files?view=vs-2019),
+   so specifying `libfoo.a` instead of `foo.lib` does not change the workflow,
+   and is an improvement since it's less ambiguous.
+
+If, for some reason, you really need your project to output static
+libraries of the form `foo.lib` when building with MSVC, you can set
+the
+`name_prefix:`(https://mesonbuild.com/Reference-manual.html#library)
+kwarg to `''` and the
+`name_suffix:`(https://mesonbuild.com/Reference-manual.html#library)
+kwarg to `'lib'`. To get the default behaviour for each, you can
+either not specify the kwarg, or pass `` (an empty array) to it.
+
+## Do I need to add my headers to the sources list like in Autotools?
+
+Autotools requires you to add private and public headers to the sources list so
+that it knows what files to include in the tarball generated by `make dist`.
+Meson's `dist` command simply gathers everything committed to your git/hg
+repository and adds it to the tarball, so adding headers to the sources list is
+pointless.
+
+Meson uses Ninja which uses compiler dependency information to automatically
+figure out dependencies between C sources and headers, so it will rebuild
+things correctly when a header changes.
+
+The only exception to this are generated headers, for which you must declare
+dependencies correctly(#how-do-i-tell-meson-that-my-sources-use-generated-headers).
+
+If, for whatever reason, you do add non-generated headers to the sources list
+of a target, Meson will simply ignore them.
+
+## How do I tell Meson that my sources use generated headers?
+
+Let's say you use a `custom_target()`(https://mesonbuild.com/Reference-manual.html#custom_target)
+to generate the headers, and then `#include` them in your C code. Here's how
+you ensure that Meson generates the headers before trying to compile any
+sources in the build target:
+
+```meson
+libfoo_gen_headers = custom_target('gen-headers', ..., output: 'foo-gen.h')
+libfoo_sources = files('foo-utils.c', 'foo-lib.c')
+# Add generated headers to the list of sources for the build target
+libfoo = library('foo', sources: libfoo_sources + libfoo_gen_headers)
+```
+
+Now let's say you have a new target that links to `libfoo`:
+
+```meson
+libbar_sources = files('bar-lib.c')
+libbar = library('bar', sources: libbar_sources, link_with: libfoo)
+```
+
+This adds a **link-time** dependency between the two targets, but note that the
+sources of the targets have **no compile-time** dependencies and can be built
+in any order; which improves parallelism and speeds up builds.
+
+If the sources in `libbar` *also* use `foo-gen.h`, that's a *compile-time*
+dependency, and you'll have to add `libfoo_gen_headers` to `sources:` for
+`libbar` too:
+
+```meson
+libbar_sources = files('bar-lib.c')
+libbar = library('bar', sources: libbar_sources + libfoo_gen_headers, link_with: libfoo)
+```
+
+Alternatively, if you have multiple libraries with sources that link to
+a library and also use its generated headers, this code is equivalent to above:
+
+```meson
+# Add generated headers to the list of sources for the build target
+libfoo = library('foo', sources: libfoo_sources + libfoo_gen_headers)
+
+# Declare a dependency that will add the generated headers to sources
+libfoo_dep = declare_dependency(link_with: libfoo, sources: libfoo_gen_headers)
+
+...
+
+libbar = library('bar', sources: libbar_sources, dependencies: libfoo_dep)
+```
+
+**Note:** You should only add *headers* to `sources:` while declaring
+a dependency. If your custom target outputs both sources and headers, you can
+use the subscript notation to get only the header(s):
+
+```meson
+libfoo_gen_sources = custom_target('gen-headers', ..., output: 'foo-gen.h', 'foo-gen.c')
+libfoo_gen_headers = libfoo_gen_sources0
+
+# Add static and generated sources to the target
+libfoo = library('foo', sources: libfoo_sources + libfoo_gen_sources)
+
+# Declare a dependency that will add the generated *headers* to sources
+libfoo_dep = declare_dependency(link_with: libfoo, sources: libfoo_gen_headers)
+...
+libbar = library('bar', sources: libbar_sources, dependencies: libfoo_dep)
+```
+
+A good example of a generator that outputs both sources and headers is
+`gnome.mkenums()`(https://mesonbuild.com/Gnome-module.html#gnomemkenums).
+
+## How do I disable exceptions and RTTI in my C++ project?
+
+With the `cpp_eh` and `cpp_rtti` options. A typical invocation would
+look like this:
+
+```
+meson -Dcpp_eh=none -Dcpp_rtti=false <other options>
+```
+
+The RTTI option is only available since Meson version 0.53.0.
+
+## Should I check for `buildtype` or individual options like `debug` in my build files?
+
+This depends highly on what you actually need to happen. The
+´buildtype` option is meant do describe the current build's
+_intent_. That is, what it will be used for. Individual options are
+for determining what the exact state is. This becomes clearer with a
+few examples.
+
+Suppose you have a source file that is known to miscompile when using
+`-O3` and requires a workaround. Then you'd write something like this:
+
+```meson
+if get_option('optimization') == '3'
+    add_project_arguments('-DOPTIMIZATION_WORKAROUND', ...)
+endif
+```
+
+On the other hand if your project has extra logging and sanity checks
+that you would like to be enabled during the day to day development
+work (which uses the `debug` buildtype), you'd do this instead:
+
+```meson
+if get_option('buildtype') == 'debug'
+    add_project_arguments('-DENABLE_EXTRA_CHECKS', ...)
+endif
+```
+
+In this way the extra options are automatically used during
+development but are not compiled in release builds. Note that (since
+Meson 0.57.0) you can set optimization to, say, 2 in your debug builds
+if you want to. If you tried to set this flag based on optimization
+level, it would fail in this case.
+
+## How do I use a library before declaring it?
+
+This is valid (and good) code:
+```
+libA = library('libA', 'fileA.cpp', link_with : )
+libB = library('libB', 'fileB.cpp', link_with : libA)
+```
+But there is currently no way to get something like this to work:
+```
+libB = library('libB', 'fileB.cpp', link_with : libA)
+libA = library('libA', 'fileA.cpp', link_with : )
+```
+This means that you HAVE to write your `library(...)` calls in the order that the
+dependencies flow. While ideas to make arbitrary orders possible exist, they were
+rejected because reordering the `library(...)` calls was considered the "proper"
+way. See here(https://github.com/mesonbuild/meson/issues/8178) for the discussion.
+
+## Why doesn't meson have user defined functions/macros?
+
+The tl;dr answer to this is that meson's design is focused on solving specific
+problems rather than providing a general purpose language to write complex
+code solutions in build files. Build systems should be quick to write and
+quick to understand, functions muddle this simplicity.
+
+The long answer is twofold:
+
+First, Meson aims to provide a rich set of tools that solve specific problems
+simply out of the box. This is similar to the "batteries included" mentality of
+Python. By providing tools that solve common problems in the simplest way
+possible *in* Meson we are solving that problem for everyone instead of forcing
+everyone to solve that problem for themselves over and over again, often
+badly. One example of this are Meson's dependency wrappers around various
+config-tool executables (sdl-config, llvm-config, etc). In other build
+systems each user of that dependency writes a wrapper and deals with the
+corner cases (or doesn't, as is often the case), in Meson we handle them
+internally, everyone gets fixes and the corner cases are ironed out for
+*everyone*. Providing user defined functions or macros goes directly against
+this design goal.
+
+Second, functions and macros makes the build system more difficult to reason
+about. When you encounter some function call, you can refer to the reference
+manual to see that function and its signature. Instead of spending
+frustrating hours trying to interpret some bit of m4 or follow long include
+paths to figure out what `function1` (which calls `function2`, which calls
+`function3`, ad infinitum), you know what the build system is doing. Unless
+you're actively developing Meson itself, it's just a tool to orchestrate
+building the thing you actually care about. We want you to spend as little
+time worrying about build systems as possible so you can spend more time on
+*your code*.
+
+Many times user defined functions are used due to a lack of loops or
+because loops are tedious to use in the language. Meson has both arrays/lists
+and hashes/dicts natively. Compare the following pseudo code:
+
+```meson
+func(name, sources, extra_args)
+  executable(
+    name,
+    sources,
+    c_args : extra_args
+  )
+endfunc
+
+func(exe1, '1.c', 'common.c', )
+func(exe2, '2.c', 'common.c', )
+func(exe2_a, '2.c', 'common.c', '-arg')
+```
+
+```meson
+foreach e : '1', '1.c', ,
+             '2', '2.c', ,
+             '2', '2.c', '-arg'
+  executable(
+    'exe' + e0,
+    e1,
+    c_args : e2,
+  )
+endforeach
+```
+
+The loop is both less code and is much easier to reason about than the function
+version is, especially if the function were to live in a separate file, as is
+common in other popular build systems.
+
+Build system DSLs also tend to be badly thought out as generic programming
+languages, Meson tries to make it easy to use external scripts or programs
+for handling complex problems. While one can't always convert build logic
+into a scripting language (or compiled language), when it can be done this is
+often a better solution. External languages tend to be well-thought-out and
+tested, generally don't regress, and users are more likely to have domain
+knowledge about them. They also tend to have better tooling (such as
+autocompletion, linting, testing solutions), which make them a lower
+maintenance burden over time.
+
+## Why don't the arguments passed to `add_project_link_arguments` affect anything?
+
+Given code like this:
+```meson
+add_project_link_arguments('-Wl,-foo', language : 'c')
+executable(
+  'main',
+  'main.c',
+  'helper.cpp',
+)
+```
+
+One might be surprised to find that `-Wl,-foo` is *not* applied to the linkage
+of the `main` executable. In this Meson is working as expected, since meson will
+attempt to determine the correct linker to use automatically. This avoids
+situations like in autotools where dummy C++ sources have to be added to some
+compilation targets to get correct linkage. So in the above case the C++ linker
+is used, instead of the C linker, as `helper.cpp` likely cannot be linked using
+the C linker.
+
+Generally the best way to resolve this is to add the `cpp` language to the
+`add_project_link_arguments` call.
+```meson
+add_project_link_arguments('-Wl,-foo', language : 'c', 'cpp')
+executable(
+  'main',
+  'main.c',
+  'helper.cpp',
+)
+```
+
+To force the use of the C linker anyway the `link_language` keyword argument can
+be used. Note that this can result in a compilation failure if there are symbols
+that the C linker cannot resolve.
+```meson
+add_project_link_arguments('-Wl,-foo', language : 'c')
+executable(
+  'main',
+  'main.c',
+  'helper.cpp',
+  link_language : 'c',
+)
+```
+
+## How do I ignore the build directory in my VCS?
+
+You don't need to, assuming you use git or mercurial! Meson >=0.57.0 will
+create a `.gitignore` and `.hgignore` file for you, inside each build
+directory. It glob ignores ```"*"```, since all generated files should not be
+checked into git.
+
+Users of older versions of Meson may need to set up ignore files themselves.

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/Feature-autodetection.md Added

@@ -0,0 +1,41 @@
+---
+short-description: Auto-detection of features like ccache and code coverage
+...
+
+# Feature autodetection
+
+Meson is designed for high productivity. It tries to do as many things
+automatically as it possibly can.
+
+Ccache
+--
+
+Ccache(https://ccache.dev/) is a cache system designed to make
+compiling faster. When you run Meson for the first time for a given
+project, it checks if Ccache is installed. If it is, Meson will use it
+automatically.
+
+If you do not wish to use Ccache for some reason, just specify your
+compiler with environment variables `CC` and/or `CXX` when first
+running Meson (remember that once specified the compiler can not be
+changed). Meson will then use the specified compiler without Ccache.
+
+Coverage
+--
+
+When doing a code coverage build, Meson will check for existence of
+the binaries `gcovr`, `lcov` and `genhtml`. If version 3.3 or higher
+of the first is found, targets called *coverage-text*, *coverage-xml*
+and *coverage-html* are generated. If version 4.2 or higher of the
+first is found, targets *coverage-text*, *coverage-xml*, *coverage-sonarqube*
+and *coverage-html* are generated. Alternatively, if the latter two
+are found, only the target *coverage-html* is generated. Coverage
+reports can then be produced simply by calling e.g. `meson compile
+coverage-xml`. As a convenience, a high-level *coverage* target is
+also generated which will produce all 3 coverage report types, if
+possible.
+
+Note that generating any of the coverage reports described above
+requires the tests (i.e. `meson test`) to finish running so the
+information about the functions that are called in the tests can be
+gathered for the report.

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/Fs-module.md Added

@@ -0,0 +1,244 @@
+# FS (filesystem) module
+
+This module provides functions to inspect the file system. It is
+available starting with version 0.53.0.
+
+Since 0.59.0, all functions accept `files()` objects if they can do something
+useful with them (this excludes `exists`, `is_dir`, `is_file`, `is_absolute`
+since a `files()` object is always the absolute path to an existing file).
+
+## File lookup rules
+
+Non-absolute paths are looked up relative to the directory where the
+current `meson.build` file is.
+
+If specified, a leading `~` is expanded to the user home directory.
+Environment variables are not available as is the rule throughout Meson.
+That is, $HOME, %USERPROFILE%, $MKLROOT, etc. have no meaning to the Meson
+filesystem module. If needed, pass such variables into Meson via command
+line options in `meson_options.txt`, native-file or cross-file.
+
+Where possible, symlinks and parent directory notation are resolved to an
+absolute path.
+
+### exists
+
+Takes a single string argument and returns true if an entity with that
+name exists on the file system. This can be a file, directory or a
+special entry such as a device node.
+
+### is_dir
+
+Takes a single string argument and returns true if a directory with
+that name exists on the file system.
+
+### is_file
+
+Takes a single string argument and returns true if an file with that
+name exists on the file system.
+
+### is_symlink
+
+Takes a single string or (since 0.59.0) `files()` argument and returns true if
+the path pointed to by the string is a symbolic link.
+
+## File Parameters
+
+### is_absolute
+
+*since 0.54.0*
+
+Return a boolean indicating if the path string or (since 0.59.0) `files()`
+specified is absolute, WITHOUT expanding `~`.
+
+Examples:
+
+```meson
+fs.is_absolute('~')   # false
+
+home = fs.expanduser('~')
+fs.is_absolute(home)  # true
+
+fs.is_absolute(home / 'foo')  # true, even if ~/foo doesn't exist
+
+fs.is_absolute('foo/bar')  # false, even if ./foo/bar exists
+```
+
+### hash
+
+The `fs.hash(filename, hash_algorithm)` method returns a string containing
+the hexadecimal `hash_algorithm` digest of a file.
+`hash_algorithm` is a string; the available hash algorithms include:
+md5, sha1, sha224, sha256, sha384, sha512.
+
+### size
+
+The `fs.size(filename)` method returns the size of the file in integer bytes.
+
+### is_samepath
+
+The `fs.is_samepath(path1, path2)` returns boolean `true` if both
+paths resolve to the same path. For example, suppose path1 is a
+symlink and path2 is a relative path. If `path1` can be resolved to
+`path2`, then `true` is returned. If `path1` is not resolved to
+`path2`, `false` is returned. If `path1` or `path2` do not exist,
+`false` is returned.
+
+Examples:
+
+```meson
+x = 'foo.txt'
+y = 'sub/../foo.txt'
+z = 'bar.txt'  # a symlink pointing to foo.txt
+j = 'notafile.txt'  # non-existent file
+
+fs.is_samepath(x, y)  # true
+fs.is_samepath(x, z)  # true
+fs.is_samepath(x, j)  # false
+
+p = 'foo/bar'
+q = 'foo/bar/baz/..'
+r = 'buz'  # a symlink pointing to foo/bar
+s = 'notapath'  # non-existent directory
+
+fs.is_samepath(p, q)  # true
+fs.is_samepath(p, r)  # true
+fs.is_samepath(p, s)  # false
+```
+
+## Filename modification
+
+The files need not actually exist yet for these path string
+manipulation methods.
+
+### expanduser
+
+*since 0.54.0*
+
+A path string with a leading `~` is expanded to the user home
+directory
+
+Examples:
+
+```meson
+fs.expanduser('~')  # user home directory
+
+fs.expanduser('~/foo')  # <homedir>/foo
+```
+
+### as_posix
+
+*since 0.54.0*
+
+`fs.as_posix(path)` assumes a Windows path, even if on a Unix-like
+system. Thus, all `'\'` or `'\\'` are turned to '/', even if you meant
+to escape a character.
+
+Examples
+
+```meson
+fs.as_posix('\\') == '/'  # true
+fs.as_posix('\\\\') == '/'  # true
+
+fs.as_posix('foo\\bar/baz') == 'foo/bar/baz'  # true
+```
+
+### replace_suffix
+
+The `replace_suffix` method is a *string manipulation* convenient for
+filename modifications. It allows changing the filename suffix like:
+
+#### swap suffix
+
+```meson
+original = '/opt/foo.ini'
+new = fs.replace_suffix(original, '.txt')  # /opt/foo.txt
+```
+
+#### add suffix
+
+```meson
+original = '/opt/foo'
+new = fs.replace_suffix(original, '.txt')  # /opt/foo.txt
+```
+
+#### compound suffix swap
+
+```meson
+original = '/opt/foo.dll.a'
+new = fs.replace_suffix(original, '.so')  # /opt/foo.dll.so
+```
+
+#### delete suffix
+
+```meson
+original = '/opt/foo.dll.a'
+new = fs.replace_suffix(original, '')  # /opt/foo.dll
+```
+
+### parent
+
+Returns the parent directory (i.e. dirname).
+
+```meson
+new = fs.parent('foo/bar')  # foo
+new = fs.parent('foo/bar/baz.dll')  # foo/bar
+```
+
+### name
+
+Returns the last component of the path (i.e. basename).
+
+```meson
+fs.name('foo/bar/baz.dll.a')  # baz.dll.a
+```
+
+### stem
+
+*since 0.54.0*
+
+Returns the last component of the path, dropping the last part of the
+suffix
+
+```meson
+fs.stem('foo/bar/baz.dll')  # baz
+fs.stem('foo/bar/baz.dll.a')  # baz.dll
+```
+
+### read
+- `read(path, encoding: 'utf-8')` *(since 0.57.0)*:
+   return a string(Syntax.md#strings) with the contents of the given `path`.
+   If the `encoding` keyword argument is not specified, the file specified by
+   `path` is assumed to be utf-8 encoded. Binary files are not supported. The
+   provided paths should be relative to the current `meson.current_source_dir()`
+   or an absolute path outside the build directory is accepted. If the file
+   specified by `path` changes, this will trigger Meson to reconfigure the
+   project. If the file specified by `path` is a `files()` object it
+   cannot refer to a built file.
+
+
+### copyfile
+
+*Since 0.64.0*
+
+Copy a file from the source directory to the build directory at build time
+
+Has the following positional arguments:
+   - src `File | str`: the file to copy
+
+Has the following optional arguments:
+   - dest `str`: the name of the output file. If unset will be the basename of
+     the src argument
+
+Has the following keyword arguments:
+   - install `bool`: Whether to install the copied file, defaults to false
+   - install_dir `str`: Where to install the file to
+   - install_tag: `str`: the install tag to assign to this target
+   - install_mode `arraystr | int`: the mode to install the file with
+
+returns:
+   - a custom_target object
+
+```meson
+copy = fs.copyfile('input-file', 'output-file')
+```

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/Generating-sources.md Added

@@ -0,0 +1,206 @@
+---
+short-description: Generation of source files before compilation
+...
+
+# Generating sources
+
+Sometimes source files need to be preprocessed before they are passed
+to the actual compiler. As an example you might want build an IDL
+compiler and then run some files through that to generate actual
+source files. In Meson this is done with
+generator or
+custom_target.
+
+## Using custom_target()
+
+Let's say you have a build target that must be built using sources
+generated by a compiler. The compiler can either be a built target:
+
+```meson
+mycomp = executable('mycompiler', 'compiler.c')
+```
+
+Or an external program provided by the system, or script inside the
+source tree:
+
+```meson
+mycomp = find_program('mycompiler')
+```
+
+Custom targets can take zero or more input files and use them to
+generate one or more output files. Using a custom target, you can run
+this compiler at build time to generate the sources:
+
+```meson
+gen_src = custom_target('gen-output',
+                        input : 'somefile1.c', 'file2.c',
+                        output : 'out.c', 'out.h',
+                        command : mycomp, '@INPUT@',
+                                   '--c-out', '@OUTPUT0@',
+                                   '--h-out', '@OUTPUT1@')
+```
+
+The `@INPUT@` there will be transformed to `'somefile1.c'
+'file2.c'`. Just like the output, you can also refer to each input
+file individually by index.
+
+Then you just put that in your program and you're done.
+
+### Generating headers
+
+Adding a generated header to a source list will ensure that the header
+is generated and that the proper include paths are created for the
+target:
+
+```meson
+prog_python = import('python').find_installation('python3')
+
+foo_c = custom_target(
+    'foo.c',
+    output : 'foo.c',
+    input : 'my_gen.py',
+    command : prog_python, '@INPUT@', '--code', '@OUTPUT@',
+)
+
+foo_h = custom_target(
+    'foo.h',
+    output : 'foo.h',
+    input : 'my_gen.py',
+    command : prog_python, '@INPUT@', '--header', '@OUTPUT@',
+)
+
+libfoo = static_library('foo', foo_c, foo_h)
+
+executable('myexe', 'main.c', foo_h, link_with : libfoo)
+```
+
+Each target that depends on a generated header should add that header
+to its sources, as seen above with `libfoo` and `myexe`. This is
+because there is no way for Meson or the backend to know that `myexe`
+depends on `foo.h` just because `libfoo` does, it could be a private
+header.
+
+### Generating multiple files at a time
+
+Sometimes it makes sense for a single generator to create two or more
+files at a time, (perhaps a header and source file), Meson has this
+case covered as well. `custom_target`s can be indexed like a list to
+get each output file separately. The order is the same as the order of
+the output argument to `custom_target`
+
+```meson
+prog_python = import('python').find_installation('python3')
+
+foo_ch = custom_target(
+    'foo.ch',
+    output : 'foo.c', 'foo.h',
+    input : 'my_gen.py',
+    command : prog_python, '@INPUT@', '@OUTPUT@',
+)
+
+libfoo = static_library('foo', foo_ch)
+
+executable('myexe', 'main.c', foo_ch1, link_with : libfoo)
+```
+
+In this case `libfoo` depends on both `foo.c` and `foo.h` but `myexe`
+only depends on `foo.h`, the second output.
+
+### Using dependencies to manage generated resources
+
+In some cases it might be easier to use `declare_dependency` to
+"bundle" the header and library dependency, especially if there are
+many generated headers:
+
+```meson
+idep_foo = declare_dependency(
+    sources : foo_h, bar_h,
+    link_with : libfoo,
+)
+```
+
+See dependencies(Dependencies.md#declaring-your-own), and
+declare_dependency for more
+information.
+
+## Using generator()
+
+Generators are similar to custom targets, except that we define a
+*generator*, which defines how to transform an input file into one or
+more output files, and then use that on as many input files as we
+want.
+
+Note that generators should only be used for outputs that will only be
+used as inputs for a build target or a custom target. When you use the
+processed output of a generator in multiple targets, the generator
+will be run multiple times to create outputs for each target. Each
+output will be created in a target-private directory `@BUILD_DIR@`.
+
+If you want to generate files for general purposes such as for
+generating headers to be used by several sources, or data that will be
+installed, and so on, use a
+custom_target instead.
+
+
+```meson
+gen = generator(mycomp,
+                output  : '@BASENAME@.c',
+                arguments : '@INPUT@', '@OUTPUT@')
+```
+
+The first argument is the executable file to run. The next file
+specifies a name generation rule. It specifies how to build the output
+file name for a given input name. `@BASENAME@` is a placeholder for
+the input file name without preceding path or suffix (if any). So if
+the input file name were `some/path/filename.idl`, then the output
+name would be `filename.c`. You can also use `@PLAINNAME@`, which
+preserves the suffix which would result in a file called
+`filename.idl.c`. The last line specifies the command line arguments
+to pass to the executable. `@INPUT@` and `@OUTPUT@` are placeholders
+for the input and output files, respectively, and will be
+automatically filled in by Meson. If your rule produces multiple
+output files and you need to pass them to the command line, append the
+location to the output holder like this: `@OUTPUT0@`, `@OUTPUT1@` and
+so on.
+
+With this rule specified we can generate source files and add them to
+a target.
+
+```meson
+gen_src = gen.process('input1.idl', 'input2.idl')
+executable('program', 'main.c', gen_src)
+```
+
+Generators can also generate multiple output files with unknown names:
+
+```meson
+gen2 = generator(someprog,
+                 output : '@BASENAME@.c', '@BASENAME@.h',
+                 arguments : '--out_dir=@BUILD_DIR@', '@INPUT@')
+```
+
+In this case you can not use the plain `@OUTPUT@` variable, as it
+would be ambiguous. This program only needs to know the output
+directory, it will generate the file names by itself.
+
+To make passing different additional arguments to the generator
+program at each use possible, you can use the `@EXTRA_ARGS@` string in
+the `arguments` list. Note that this placeholder can only be present
+as a whole string, and not as a substring. The main reason is that it
+represents a list of strings, which may be empty, or contain multiple
+elements; and in either case, interpolating it into the middle of a
+single string would be troublesome. If there are no extra arguments
+passed in from a `process()` invocation, the placeholder is entirely
+omitted from the actual list of arguments, so an empty string won't be
+passed to the generator program because of this. If there are multiple
+elements in `extra_args`, they are inserted into to the actual
+argument list as separate elements.
+
+```meson
+gen3 = generator(genprog,
+                 output : '@BASENAME@.cc',
+                 arguments : '@INPUT@', '@EXTRA_ARGS@', '@OUTPUT@')
+gen3_src1 = gen3.process('input1.y')
+gen3_src2 = gen3.process('input2.y', extra_args: '--foo')
+gen3_src3 = gen3.process('input3.y', extra_args: '--foo', '--bar')
+```

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/Getting-meson.md Added

@@ -0,0 +1,110 @@
+# Getting Meson
+
+Meson is implemented in Python 3, and requires 3.7 or newer. If your
+operating system provides a package manager, you should install it
+with that. For platforms that don't have a package manager, you need
+to download it from Python's home page. See below for
+platform-specific Python3 quirks(#platformspecific-install-quirks).
+
+## Downloading Meson
+
+Meson releases can be downloaded from the GitHub release page, and
+you can run `./meson.py` from inside a release or the git repository
+itself without doing anything special.
+
+On Windows, if you did not install Python with the installer options
+that make Python scripts executable, you will have to run `python
+/path/to/meson.py`, where `python` is Python 3.7 or newer.
+
+The newest development code can be obtained directly from Git, and
+we strive to ensure that it will always be working and usable. All
+commits go through a pull-request process that runs CI and tests
+several platforms.
+
+### Packing Meson into a zipapp
+
+After downloading the release, you can create a standalone single-file
+executable for Meson by running the script:
+
+```
+./packaging/create_zipapp.py --outfile meson.pyz --interpreter '/usr/bin/env python3' <source checkout>
+```
+
+This uses python's native support for zipapp.
+
+## Installing Meson with pip
+
+Meson is available in the Python Package Index and can be installed
+with `pip3 install --user meson`. This does not require any special
+privileges. This will install the package in `~/.local/`, so you will
+have to add `~/.local/bin` to your `PATH`. If you are using Meson only
+for local development this should be all you need.
+
+If you need to install your project in system directories, this
+approach will not work as executable installed in this way are not
+available when `sudo` is used. You can install Meson so it can be used
+by every user with `sudo pip3 install meson`. It is generally not
+recommended to do this, but instead use the version provided by distro
+packages.
+
+If you must install Meson with `sudo pip3` make sure to uninstall any
+distro version first. Having multiple versions of any program in
+system directories can lead to problems.
+
+## Installing Meson and Ninja with the MSI installer
+
+We provide an MSI installer on the GitHub release page that can be
+used to install both Meson and Ninja at once for Windows. It also
+contains an embedded copy of Python, so scripts that use the Python
+module(Python-module.md) and do not have any external dependencies
+will continue to work as expected.
+
+Please note that this is a new feature, so bug reports are expected
+and welcome!
+
+## Dependencies
+
+In the most common case, you will need the Ninja executable for
+using the `ninja` backend, which is the default in Meson. This backend
+can be used on all platforms and with all toolchains, including GCC,
+Clang, Visual Studio, MinGW, ICC, ARMCC, etc.
+
+You can use the version provided by your package manager if possible,
+otherwise download the binary executable from the Ninja project's
+release page(https://github.com/ninja-build/ninja/releases).
+
+If you will only use the Visual Studio backend (`--backend=vs`) to
+generate Visual Studio solutions on Windows or the XCode backend
+(`--backend=xcode`) to generate XCode projects on macOS, you do not
+need Ninja.
+
+# Platform-specific install quirks
+
+## Windows Python3 quirks
+
+When installing Python 3, it is highly recommended (but not required)
+that you select the installer options as follows:
+
+!installer step 1(images/py3-install-1.png "Enable 'Add Python 3.6 to PATH' and click 'Customize installation'")
+!installer step 2(images/py3-install-2.png "Optional Features: ensure 'pip' is enabled")
+!installer step 3(images/py3-install-3.png "Advanced Options: enable 'Install for all users'")
+
+With this, you will have `python` and `pip` in `PATH`, and you can
+install Meson with pip. You will also be able to directly run `meson`
+in any shell on Windows instead of having to run `py -3` with the full
+path to the `meson.py` script.
+
+## MSYS2 Python3 quirks
+
+If you are using MSYS2 on Windows as your development environment,
+please make sure that you **do not use** the `msys/python` package to
+provide Python 3. Use either `mingw32/mingw-w64-i686-python3` or
+`mingw64/mingw-w64-x86_64-python3` depending on which MinGW target you
+are building for.
+
+  GitHub release page: https://github.com/mesonbuild/meson/releases
+  zipapp: https://docs.python.org/3/library/zipapp.html
+  Python Package Index: https://pypi.python.org/pypi/meson/
+  Git: https://github.com/mesonbuild/meson
+  Python's home page: https://www.python.org/downloads/
+  Ninja executable: https://ninja-build.org/

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/Getting-meson_ptbr.md Added

@@ -0,0 +1,93 @@
+# Obtendo o Meson
+
+Meson é implementado em Python 3, e requer a versão 3.7 ou mais nova.
+se o seu sistema operacional provê um gerenciador de pacotes, você deve
+instalar o Meson com ele. Para plataformas que não tem um gerenciador de
+pacotes, você precisa baixa-lo da página inicial do Python. Veja abaixo
+peculiaridades do Python3 específicas de plataformas(#platformspecific-install-quirks).
+
+## Baixando o Meson
+
+*Releases* do Meson podem ser baixadas da página de releases do GitHub
+e você pode executar `./meson.py` de dentro do *release* ou do próprio repositório
+do git sem fazer nada de especial.
+
+No Windows, se você não instalar o Python com a opção do instalador que fazem
+os *scripts* Python executáveis, você vai ter que executar `python
+/path/to/meson.py`, onde `python` é o Python 3.7 ou mais novo.
+
+O código de desenvolvimento mais recente pode ser obtido diretamente do Git,
+e nós lutamos para garatir que ele vai estar sempre funcionando e usável. Todos
+*commits* passam por um processo de *pull-request* que executa CI e testam diversas
+plataformas.
+
+## Instalando o Meson com o pip
+
+O Meson está disponível no Indice de Pacotes do Python e pode ser instalado com
+`sudo pip3 install meson` que requer root e vai instala-lo para todo o sistema.
+
+Se você já baixou uma cópia do código do Meson, você pode instalar com
+`sudo pip3 install path/to/source/root/`.
+
+Como alternativa, você pode usar o `pip3 install --user meson` que vai instalar
+o Meson para o seu usuário e não requer nenhum privilégio especial. Esse comando
+vai instalar o pacote em `~/.local/`, então você terá que adicionar `~/.local/bin`
+para o seu `PATH`, e `sudo meson install` vai estar completamente quebrado já que
+o programa não vai estar disponível para o root. Apeas use uma cópia de usuário do Meson
+se você não se importa sobre instalar os projetos como root.
+
+## Instalando o Meson e o Ninja com o instalador MSI
+
+Nós provemos um instalador MSI na página de *release* do GitHub que pode ser usada
+para instalar tanto o Meson quanto o Ninja de uma vez para o Windows. O instalador também
+contém uma cópia integrada do Python, então scripts que usam o módulo Python(Python-module.md)
+e não tem nenhuma dependência externa vão continuar funcionando como esperado.
+
+Por favor, note que essa é uma funcionalidade nova, então relatórios de bugs são esperados e bem-vindos!
+
+## Dependências
+
+Na maioria dos casos comums, você vai precisar do executável do Ninja para usar o *backend* do `ninja`,
+que é o padrão no Meson. Esse *backend* pode ser usado em todas plataformas e com todas **toolchains**, incluindo o GCC,
+Clang, Visual Studio, MinGW, ICC, ARMCC, etc.
+
+Você deve usar a versão provida pelo seu gerenciador de pacotes se possível, caso contrário,
+baixe o binário executável da página de *release* do projeto Ninja(https://github.com/ninja-build/ninja/releases).
+
+Se você apenas usa o *backend* do Visual Studio (`--backend=vs`) para gerar soluções do Visual Studio no Windows ou o
+*backend* do XCode (`--backend=xcode`) para gerar projetos no macOS, você não precisa do Ninja.
+
+
+
+# Peculiaridades de instalação específicas de plataformas
+
+## Peculiaridades do Python 3 no Windows
+
+Quando estiver instalando o Python 3, é altamente recomendável (mas não obrigatório)
+que você selecione as opções do instalador como a seguir:
+
+!passo 1 do instalador(images/py3-install-1.png "Ative 'Add Python 3.6 to PATH' e clique em 'Customize installation'")
+
+!passo 2 do instalador(images/py3-install-2.png "Funcionalidade Opcional: garanta que 'pip' está ativado")
+
+!passo 3 do instalador(images/py3-install-3.png "Opções Avançadas: ative 'Instalar para todos usuários'")
+
+Com isso, você terá o `python` e o `pip` no `PATH`, e você poderá instalar o Meson com o pip. Você também vai poder
+executar o comando `meson` em qualquer shell no Windows ao invés de ter que executar `py -3` com o caminho completo para
+o *script* `meson.py`.
+
+## Peculiaridades do Python 3 no MSYS2
+
+Se você está usando o MSYS2 no Windows como seu ambiente de desenvolvimento,
+por favor se certifique que você não esteja usando o pacote `msys/python` para
+fornecer o Python 3. Uso o `mingw32/mingw-w64-i686-python3` ou o
+If you are using MSYS2 on Windows as your development environment,
+please make sure that you **do not use** the `msys/python` package to
+provide Python 3. Use either `mingw32/mingw-w64-i686-python3` or `mingw64/mingw-w64-x86_64-python3`
+dependendo de para qual *target* do MinGW você está compilando.
+
+  página de *release* do GitHub: https://github.com/mesonbuild/meson/releases
+  Indice de Pacotes do Python: https://pypi.python.org/pypi/meson/
+  Git: https://github.com/mesonbuild/meson
+  página inicial do Python: https://www.python.org/downloads/
+  executável do Ninja: https://ninja-build.org/

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/Getting-meson_zh.md Added

@@ -0,0 +1,56 @@
+# 获取Meson
+
+Meson基于Python3运行，要求Python版本3.5以上。 如果你的操作系统提供包管理器, 你应该用包管理器安装meson；如果没有包管理器，你应该在Python主页下载合适的Python3。相关请参阅特殊平台的安装特例(#特殊平台的安装特例).
+
+## 下载Meson
+
+Meson发行版可在 GitHub发行页面下载, 你可以在release的解压目录或者git仓库目录里直接运行 `./meson.py` ，不需要进行任何特殊操作。
+
+在Windows下,如果你安装Python时没有将Python路径添加到环境变量, 那你应该使用`python /path/to/meson.py`命令运行Meson,当然`python` 的版本应该大于3.5。
+
+最新的开发版本的源码可以直接通过Git获得,我们尽可能保证它总是可以正常使用。所有的提交通过pull-request进行，此过程将运行 CI 并且会在多个平台进行测试。
+
+## 使用pip安装Meson
+
+Meson在Python包索引中，可通过`pip3 install meson`命令安装，如果在root环境下，它会在系统范围内安装。
+
+相反,你也可以使用 `pip3 install --user meson`命令来为`user`用户单独安装，此过程不需要任何特殊权限. Meson会被安装到`~/.local/`目录下,所以你需要将 `~/.local/bin`添加至你的`PATH`.
+
+## 使用MSI安装包安装Meson和Ninja
+
+我们也在GitHub发行页面提供MSI安装包，可以同时为Windows安装 Meson和Ninja。 它也包含一份嵌入性的Python拷贝, 所以Python module(Python-module.md)可以不靠任何外部依赖的情况下正如期望般的正常工作。
+
+因为这是新特性，请多留意，如果出现BUG欢迎反馈！
+
+## 所需依赖
+
+最主要的, 你需要 Ninja可执行程序 来使用Meson默认的
+`ninja` 后端参数。这个参数可以用于所有平台和工具链包括 GCC, Clang, Visual Studio, MinGW,ICC, ARMCC.
+
+如果可能，你应该使用包管理器提供的版本，否则的话，你应该
+在Ninja发行页面下载可执行二进制文件。(https://github.com/ninja-build/ninja/releases).
+
+如果你只用Visual Studio后端参数 (`--backend=vs`)来生成Windows上的Visual Studio工程文件或者XCode后端参数 (`--backend=xcode`) 生成macOS上的
+XCode工程文件, 那么你不需要安装Ninja.
+
+# 特殊平台的安装特例
+
+## Windows Python3
+
+安装Python3时,强烈推荐以下安装器选项 (非必须，请结合实际) :
+
+!installer step 1(images/py3-install-1.png "Enable 'Add Python 3.6 to PATH' and click 'Customize installation'")
+!installer step 2(images/py3-install-2.png "Optional Features: ensure 'pip' is enabled")
+!installer step 3(images/py3-install-3.png "Advanced Options: enable 'Install for all users'")
+
+完成这个之后, `python` 和`pip`的路径会收录进`PATH`,你可以使用pip安装Meson. 你也可以在Windows任何终端下直接运行`meson`而不是不得不输入`py -3`完整路径去运行 `meson.py`脚本.
+
+## MSYS2 Python3
+
+如果你使用MSYS2作为你的Windows开发环境,请确信你**没有**将 `msys/python` 当作你的默认Python使用. 请使用 `mingw32/mingw-w64-i686-python3` 或者 `mingw64/mingw-w64-x86_64-python3`，这取决于MinGW不同的构建对象.
+
+  GitHub发行页面: https://github.com/mesonbuild/meson/releases
+  Python包索引: https://pypi.python.org/pypi/meson/
+  Git: https://github.com/mesonbuild/meson
+  Python主页: https://www.python.org/downloads/
+  Ninja可执行程序: https://ninja-build.org/

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/Gnome-module.md Added

@@ -0,0 +1,419 @@
+# GNOME module
+
+This module provides helper tools for build operations needed when
+building Gnome/GLib programs.
+
+**Note**: the compilation commands here might not work properly when
+  you change the source files. This is a bug in the respective
+  compilers which do not expose the required dependency
+  information. This has been reported upstream in this bug. Until
+  this is fixed you need to be careful when changing your source
+  files.
+
+  this bug: https://bugzilla.gnome.org/show_bug.cgi?id=745754
+
+## Usage
+
+To use this module, just do: **`gnome = import('gnome')`**. The
+following functions will then be available as methods on the object
+with the name `gnome`. You can, of course, replace the name `gnome`
+with anything else.
+
+### gnome.compile_resources()
+
+```
+    gnome.compile_resources(id: string, input_file: string | File,
+                            build_by_default: bool = false,
+                            c_name: string | None = None,
+                            dependencies: (File, CustomTarget, CustomTargetIndex) = ,
+                            export: bool = false,
+                            extra_args: string = ,
+                            gresource_bundle: bool = false,
+                            install_dir: string | None = None,
+                            source_dir: string = ,
+                            ): (CustomTarget, CustomTarget) | CustomTarget
+```
+
+This function compiles resources specified in an XML file into code
+that can be embedded inside the main binary. Similar a build target it
+takes two positional arguments. The first one is the name of the
+resource and the second is the XML file containing the resource
+definitions. If the name is `foobar`, Meson will generate a header
+file called `foobar.h`, which you can then include in your sources.
+
+* `c_name`: passed to the resource compiler as an argument after
+  `--c-name`
+* `dependencies`: extra targets to depend upon for building
+* `export`: (*Added 0.37.0*) if true, export the symbols of the
+  generated sources
+* `extra_args`: extra command line arguments to pass to the resource
+* `gresource_bundle`: (*Added 0.37.0*) if true, output a `.gresource`
+  file instead of source
+* `install`: (*Added 0.37.0*) if true, install the gresource file
+* `install_dir`: (*Added 0.37.0*) location to install the header or
+  bundle depending on previous options
+* `install_header`: (*Added 0.37.0*) if true, install the header file
+* `source_dir`: a list of directories where the resource compiler
+  should look up the files
+
+Returns an array containing: `c_source, header_file` or
+`gresource_bundle`
+
+Example:
+
+```meson
+gnome = import('gnome')
+
+asresources = gnome.compile_resources(
+    'as-resources', 'data/asresources.gresource.xml',
+    source_dir: 'data',
+    c_name: 'as'
+)
+
+executable(
+    meson.project_name(),
+    asresources,
+    dependencies: my_deps,
+    install: true
+)
+```
+
+### gnome.generate_gir()
+
+Generates GObject introspection data.
+
+Takes one or more positional arguments:
+
+Either one or more library objects you want to build gir data for, or a single
+executable object.
+
+There are several keyword arguments. Many of these map directly to the
+`g-ir-scanner` tool so see its documentation for more information.
+
+* `dependencies`: deps to use during introspection scanning
+* `extra_args`: command line arguments to pass to gir compiler
+* `export_packages`: extra packages the gir file exports
+* `sources`: the list of sources to be scanned for gir data
+* `nsversion`: namespace version
+* `namespace`: the namespace for this gir object which determines
+  output files
+* `identifier_prefix`: the identifier prefix for the gir object,
+  e.g. `Gtk`
+* `includes`: list of gir names to be included, can also be a GirTarget
+* `header`: *(Added 0.43.0)* name of main c header to include for the library, e.g. `glib.h`
+* `include_directories`: extra include paths to look for gir files
+* `install`: if true, install the generated files
+* `install_gir`: (*Added 0.61.0*) overrides `install`, whether to install the
+  generated gir
+* `install_dir_gir`: (*Added 0.35.0*) which directory to install the
+  gir file into; (*Deprecated since 0.61.0*) can be false to disable installation
+* `install_typelib`: (*Added 0.61.0*) overrides `install`, whether to install the
+  generated typelib
+* `install_dir_typelib`: (*Added 0.35.0*) which directory to install
+  the typelib file into; (*Deprecated since 0.61.0*) can be false to disable installation
+* `link_with`: list of libraries to link with
+* `symbol_prefix`: the symbol prefix for the gir object, e.g. `gtk`,
+  (*Since 0.43.0*) an ordered list of multiple prefixes is allowed
+* `fatal_warnings`: *Since 0.55.0* turn scanner warnings into fatal errors.
+
+Returns an array of two elements which are: `gir_target,
+typelib_target`
+
+### gnome.genmarshal()
+
+Generates a marshal file using the `glib-genmarshal` tool. The first
+argument is the basename of the output files.
+
+* `depends` (BuildTarget | CustomTarget | CustomTargetIndex):
+  passed directly to CustomTarget (*since 0.61.0*)
+* `depend_files` (str | File): Passed directly to CustomTarget (*since 0.61.0*)
+* `extra_args`: (*Added 0.42.0*) additional command line arguments to pass
+* `install_dir`: directory to install header to
+* `install_header`: if true, install the generated header
+* `install_dir`: directory to install header to
+* `install_header`: if true, install the generated header
+* `internal`: if true, mark generated sources as internal to `glib-genmarshal`
+  (*Requires GLib 2.54*)
+* `nostdinc`: if true, don't include the standard marshallers from glib
+* `prefix`: the prefix to use for symbols
+* `skip_source`: if true, skip source location comments
+* `sources` (str | File) *required*: the list of sources to use as inputs
+* `stdinc`: if true, include the standard marshallers from glib
+* `valist_marshallers`: if true, generate va_list marshallers
+
+*Added 0.35.0*
+
+Returns an array of two elements which are: `c_source, header_file`
+
+### gnome.mkenums()
+
+Generates enum files for GObject using the `glib-mkenums` tool. The
+first argument is the base name of the output files, unless
+`c_template` and `h_template` are specified. In this case, the output
+files will be the base name of the values passed as templates.
+
+This method is essentially a wrapper around the `glib-mkenums` tool's
+command line API. It is the most featureful method for enum creation.
+
+Typically you either provide template files or you specify the various
+template sections manually as strings.
+
+Most libraries and applications will be using the same standard
+template with only minor tweaks, in which case the
+`gnome.mkenums_simple()` convenience method can be used instead.
+
+Note that if you `#include` the generated header in any of the sources
+for a build target, you must add the generated header to the build
+target's list of sources to codify the dependency. This is true for
+
+all generated sources, not just `mkenums`.
+
+* `c_template`: template to use for generating the source
+* `comments`: comment passed to the command
+* `h_template`: template to use for generating the header
+* `identifier_prefix`: prefix to use for the identifiers
+* `install_header`: if true, install the generated header
+* `install_dir`: directory to install the header
+* `sources`: the list of sources to make enums with
+* `symbol_prefix`: prefix to use for the symbols
+* `eprod`: enum text
+* `fhead`: file header
+* `fprod`: file text
+* `ftail`: file tail
+* `vhead`: value text
+* `vtail`: value tail
+
+*Added 0.35.0*
+
+Returns an array of two elements which are: `c_source, header_file`
+
+### gnome.mkenums_simple()
+
+Generates enum `.c` and `.h` files for GObject using the
+`glib-mkenums` tool with the standard template used by most
+GObject-based C libraries. The first argument is the base name of the
+output files.
+
+Note that if you `#include` the generated header in any of the sources
+for a build target, you must add the generated header to the build
+target's list of sources to codify the dependency. This is true for
+all generated sources, not just `mkenums_simple`.
+
+* `body_prefix`: additional prefix at the top of the body file,
+  e.g. for extra includes
+* `decorator`: optional decorator for the function declarations,
+  e.g. `GTK_AVAILABLE` or `GST_EXPORT`
+* `function_prefix`: additional prefix for function names, e.g. in
+  case you want to add a leading underscore to functions used only
+  internally
+* `header_prefix`: additional prefix at the top of the header file,
+  e.g. for extra includes (which may be needed if you specify a
+  decorator for the function declarations)
+* `install_header`: if true, install the generated header
+* `install_dir`: directory to install the header
+* `identifier_prefix`: prefix to use for the identifiers
+* `sources`: the list of sources to make enums with
+* `symbol_prefix`: prefix to use for the symbols
+
+Example:
+
+```meson
+gnome = import('gnome')
+
+my_headers = 'myheader1.h', 'myheader2.h'
+my_sources = 'mysource1.c', 'mysource2.c'
+
+# will generate myenums.c and myenums.h based on enums in myheader1.h and myheader2.h
+enums = gnome.mkenums_simple('myenums', sources : my_headers)
+
+mylib = library('my', my_sources, enums,
+                include_directories: my_incs,
+                dependencies: my_deps,
+                c_args: my_cargs,
+                install: true)
+```
+
+*Added 0.42.0*
+
+Returns an array of two elements which are: `c_source, header_file`
+
+### gnome.compile_schemas()
+
+When called, this method will compile the gschemas in the current
+directory. Note that this is not for installing schemas and is only
+useful when running the application locally for example during tests.
+
+* `build_by_default`: causes, when set to true, to have this target be
+  built by default, that is, when invoking plain `meson compile`, the default
+  value is true for all built target types
+* `depend_files`: files (@str,
+  files, or
+  configure_file) of
+  schema source XML files that should trigger a re-compile if changed.
+
+### gnome.gdbus_codegen()
+
+Compiles the given XML schema into gdbus source code. Takes two
+positional arguments, the first one specifies the base name to use
+while creating the output source and header and the second specifies
+one XML file.
+
+* `sources`: list of XML files
+* `interface_prefix`: prefix for the interface
+* `namespace`: namespace of the interface
+* `extra_args`: (*Added 0.47.0*) additional command line arguments to pass
+* `autocleanup`: *(Added 0.47.0)* if set generates autocleanup code. Can be one of `none`, `objects` or `all`
+* `object_manager`: *(Added 0.40.0)* if true generates object manager code
+* `annotations`: *(Added 0.43.0)* list of lists of 3 strings for the annotation for `'ELEMENT', 'KEY', 'VALUE'`
+* `docbook`: *(Added 0.43.0)* prefix to generate `'PREFIX'-NAME.xml` docbooks
+* `build_by_default`: causes, when set to true, to have this target be
+  built by default, that is, when invoking plain `meson compile`, the default
+  value is true for all built target types
+* `install_dir`: (*Added 0.46.0*) location to install the header or
+  bundle depending on previous options
+* `install_header`: (*Added 0.46.0*) if true, install the header file
+
+Starting *0.46.0*, this function returns a list of at least two custom
+targets (in order): one for the source code and one for the header.
+The list will contain a third custom target for the generated docbook
+files if that keyword argument is passed.
+
+Earlier versions return a single custom target representing all the
+outputs. Generally, you should just add this list of targets to a top
+level target's source list.
+
+Example:
+
+```meson
+gnome = import('gnome')
+
+# The returned source would be passed to another target
+gdbus_src = gnome.gdbus_codegen('example-interface',
+  sources: 'com.example.Sample.xml',
+  interface_prefix : 'com.example.',
+  namespace : 'Sample',
+  annotations : 
+    'com.example.Hello()', 'org.freedesktop.DBus.Deprecated', 'true'
+  ,
+  docbook : 'example-interface-doc'
+)
+```
+
+### gnome.generate_vapi()
+
+Creates a VAPI file from gir. The first argument is the name of the
+library.
+
+* `gir_dirs`: extra directories to include for gir files
+* `install`: if true, install the VAPI file
+* `install_dir`: location to install the VAPI file (defaults to datadir/vala/vapi)
+* `metadata_dirs`: extra directories to include for metadata files
+* `packages`: VAPI packages that are depended upon
+* `sources`: the gir source to generate the VAPI from
+* `vapi_dirs`: extra directories to include for VAPI files
+
+Returns a custom dependency that can be included when building other
+VAPI or Vala binaries.
+
+*Added 0.36.0*
+
+### gnome.yelp()
+
+```meson
+  gnome.yelp(id: string, sources: ...string, sources: string, media: string,
+             languages: string, symlink_media: bool = true): void
+```
+
+Installs help documentation for Yelp using itstool and gettext. The first
+argument is the project id.
+
+Additionally, sources can be passed as additional positional arguments. This
+was, however, undocumented and never officially supported. Due to a longstanding
+bug, passing sources as a keyword argument will result in the positional
+argument sources to be ignored. *since 0.60.0* A warning is raised in this case.
+
+*Since 0.43.0* if "languages" is not specified, a
+LINGUAS(https://www.gnu.org/software/gettext/manual/html_node/po_002fLINGUAS.html)
+file will be read instead.
+
+*Since 0.60.0* the use of the positional argument sources has been deprecated,
+and the "sources" keyword argument should be used instead. The passing of
+sources as positional arguments will be removed in the future.
+
+This also creates two targets for translations
+`help-$project-update-po` and `help-$project-pot`.
+
+* `languages`: *(deprecated since 0.43.0)* list of languages for translation, overrides the LINGUAS file
+* `media`: list of media such as images
+* `sources`: list of pages
+* `symlink_media`: if media should be symlinked not copied (defaults to `true` since 0.42.0)
+
+Note that very old versions of yelp may not support symlinked media;
+At least 3.10 should work.
+
+*Added 0.36.0*
+
+### gnome.gtkdoc()
+
+Compiles and installs gtkdoc documentation into
+`prefix/share/gtk-doc/html`. Takes one positional argument: The name
+of the module.
+
+* `content_files`: a list of content files
+* `dependencies`: a list of dependencies
+* `fixxref_args`: a list of arguments to pass to `gtkdoc-fixxref`
+* `gobject_typesfile`: a list of type files
+* `include_directories`: extra include paths to pass to `gtkdoc-scangobj`
+* `ignore_headers`: a list of header files to ignore
+* `html_assets`: a list of assets for the HTML pages
+* `html_args` a list of arguments to pass to `gtkdoc-mkhtml`
+* `install`: if true, installs the generated docs
+* `install_dir`: the directory to install the generated docs relative
+  to the gtk-doc html dir or an absolute path (default: module name)
+* `main_xml`: specifies the main XML file
+* `main_sgml`: equal to `main_xml`
+* `mkdb_args`: a list of arguments to pass to `gtkdoc-mkdb`
+* `namespace`: specifies the name space to pass to `gtkdoc-mkdb`
+* `module_version`: the version of the module, affects the installed location and the devhelp2 file location
+* `scan_args`: a list of arguments to pass to `gtkdoc-scan`
+* `scanobjs_args`: a list of arguments to pass to `gtkdoc-scangobj`
+* `c_args`: (*Added 0.48.0*) additional compile arguments to pass
+* `src_dir`: include_directories to include
+* `check`: (*Since 0.52.0*) if `true` runs `gtkdoc-check` when running unit tests.
+  Note that this has the downside of rebuilding the doc for each build, which is
+  often very slow. It usually should be enabled only in CI.
+
+This also creates a `$module-doc` target that can be run to build
+documentation. Normally the documentation is only built on install.
+
+*Since 0.52.0* Returns a target object that can be passed as
+dependency to other targets using generated doc files (e.g. in
+`content_files` of another doc).
+
+### gnome.gtkdoc_html_dir()
+
+Takes as argument a module name and returns the path where that
+module's HTML files will be installed. Usually used with
+`install_data` to install extra files, such as images, to the output
+directory.
+
+### gnome.post_install()
+
+*Since 0.57.0*
+
+Post-install update of various system wide caches. Each script will be executed
+only once even if `gnome.post_install()` is called multiple times from multiple
+subprojects. If `DESTDIR` is specified during installation all scripts will be
+skipped.
+
+It takes the following keyword arguments:
+- `glib_compile_schemas`: If set to `true`, update `gschemas.compiled` file in
+  `<prefix>/<datadir>/glib-2.0/schemas`.
+- `gio_querymodules`: List of directories relative to `prefix` where
+  `giomodule.cache` file will be updated.
+- `gtk_update_icon_cache`: If set to `true`, update `icon-theme.cache` file in
+  `<prefix>/<datadir>/icons/hicolor`.
+- `update_desktop_database`: *Since 0.59.0* If set to `true`, update cache of
+  MIME types handled by desktop files in `<prefix>/<datadir>/applications`.
+- `update_mime_database`: *Since 0.64.0* If set to `true`, update cache of
+  MIME types in `<prefix>/<datadir>/mime`.

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/GuiTutorial.md Added

@@ -0,0 +1,196 @@
+---
+short-description: A simple GUI tutorial
+...
+
+# Building a simple SDL2 app from scratch
+
+This page shows from the ground up how to define and build an SDL2 gui
+application using nothing but Meson. The document is written for
+Windows, as it is the most complex platform, but the same basic ideas
+should work on Linux and macOS as well.
+
+The sample application is written in plain C as SDL 2 is also written
+in C. If you prefer C++ instead, the conversion is fairly simple and
+is left as an exercise to the reader.
+
+This document assumes that you have already installed both Visual
+Studio and Meson.
+
+# Set up the build directory
+
+First you need to create an empty directory for all your stuff. The
+Visual Studio toolchain is a bit unusual in that it requires you to
+run your builds from a specific shell. This can be found by opening
+the application menu and then choosing `Visual Studio <year> -> x86_64
+native tools command prompt`.
+
+It will put you in a weird directory, so you need to go to your home
+directory:
+
+    cd \users\yourusername
+
+Typically you'd type `cd \users\` and then press the tabulator key to
+make the shell autocomplete the username. Once that is done you can
+create the directory.
+
+    mkdir sdldemo
+    cd sdldemo
+
+# Creating the sample program
+
+Now we need to create a source file and a Meson build definition file.
+We're not going to use SDL at all, but instead start with a simple
+program that only prints some text. Once we have it working we can
+extend it to do graphics. The source goes into a file `sdlprog.c` and
+has the following contents:
+
+```c
+#include <stdio.h>
+
+int main(int argc, char **argv) {
+  printf("App is running.\n");
+  return 0;
+}
+```
+
+The build definition goes to a file called `meson.build` and looks
+like this:
+
+```meson
+project('sdldemo', 'c')
+
+executable('sdlprog', 'sdlprog.c')
+```
+
+With this done we can start the build with the following command:
+
+    meson setup builddir
+
+Here `builddir` is the _build directory_, everything that is generated
+during the build is put in that directory. When run, it should look
+like this.
+
+!Configuring the sample application(images/sdltutorial_01.png)
+
+The program is compiled with this:
+
+    meson compile -C builddir
+
+The `-C` argument tells Meson where the configured build directory is.
+
+The program will be in the build directory and can be run like this:
+
+    builddir\sdlprog
+
+The output should look like this.
+
+!Running the sample application(images/sdltutorial_02.png)
+
+# Upgrading the program to use SDL
+
+The code needed to start SDL is a bit more complicated and we're not
+going to go into how it works. Merely replace the contents of
+`sdlprog.c` with the following:
+
+```c
+#include "SDL.h"
+
+int main(int argc, char *argv)
+{
+    SDL_Window *window;
+    SDL_Renderer *renderer;
+    SDL_Surface *surface;
+    SDL_Event event;
+
+    if (SDL_Init(SDL_INIT_VIDEO) < 0) {
+        SDL_LogError(SDL_LOG_CATEGORY_APPLICATION, "Couldn't initialize SDL: %s", SDL_GetError());
+        return 3;
+    }
+
+    if (SDL_CreateWindowAndRenderer(320, 240, SDL_WINDOW_RESIZABLE, &window, &renderer)) {
+        SDL_LogError(SDL_LOG_CATEGORY_APPLICATION, "Couldn't create window and renderer: %s", SDL_GetError());
+        return 3;
+    }
+
+    while (1) {
+        SDL_PollEvent(&event);
+        if (event.type == SDL_QUIT) {
+            break;
+        }
+        SDL_SetRenderDrawColor(renderer, 0x00, 0x00, 0x00, 0x00);
+        SDL_RenderClear(renderer);
+        SDL_RenderPresent(renderer);
+    }
+
+    SDL_DestroyRenderer(renderer);
+    SDL_DestroyWindow(window);
+
+    SDL_Quit();
+
+    return 0;
+}
+```
+
+Let's try to compile this by running `meson compile -C builddir` again.
+
+!Building SDL app fails(images/sdltutorial_03.png)
+
+That fails. The reason for this is that we don't actually have SDL
+currently available. We need to obtain it somehow. In more technical
+terms SDL2 is an _external dependency_ and obtaining it is called
+_dependency resolution_.
+
+Meson has a web service for downloading and building (if needed)
+dependencies called a WrapDB. It provides SDL2 so we can use it
+directly. First we need to create a `subprojects` directory because in
+Meson all subprojects like these must be stored in that directory for
+consistency.
+
+    mkdir subprojects
+
+Then we can install the dependency:
+
+    meson wrap install sdl2
+
+It looks like this:
+
+!Obtaining SDL2 from WrapDB(images/sdltutorial_04.png)
+
+As a final step we need to update our build definition file to use the
+newly obtained dependency.
+
+```meson
+project('sdldemo', 'c',
+        default_options: 'default_library=static')
+
+sdl2_dep = dependency('sdl2')
+
+executable('sdlprog', 'sdlprog.c',
+           win_subsystem: 'windows',
+           dependencies: sdl2_dep)
+```
+
+In addition to the dependency this has a few other changes. First we
+specify that we want to build helper libraries statically. For simple
+projects like these it makes things simpler. We also need to tell
+Meson that the program we are building is a Windows GUI
+application rather than a console application.
+
+This is all we need to do and can now run `meson compile` again. First
+the system downloads and configures SDL2:
+
+!Running the sample application(images/sdltutorial_05.png)
+
+A bit later the compilation exits successfully.
+
+!Running the sample application(images/sdltutorial_06.png)
+
+# Program is done
+
+Now we can run the application with
+
+    builddir\sdlprog
+
+The end result is a black SDL window.
+
+!Running the sample application(images/sdltutorial_07.png)

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/Hotdoc-module.md Added

@@ -0,0 +1,75 @@
+---
+short-description: Hotdoc module
+authors:
+    - name: Thibault Saunier
+      email: tsaunier@igalia.com
+      years: 2018
+      has-copyright: false
+...
+
+# Hotdoc module
+
+This module provides helper functions for generating documentation using
+hotdoc.
+
+*Added 0.48.0*
+
+## Usage
+
+To use this module, just do: **`hotdoc = import('hotdoc')`**. The
+following functions will then be available as methods on the object
+with the name `hotdoc`. You can, of course, replace the name `hotdoc`
+with anything else.
+
+### hotdoc.generate_doc()
+
+Generates documentation using hotdoc and installs it into `$prefix/share/doc/html`.
+
+**Positional argument:**
+
+* `project_name`: The name of the hotdoc project
+
+**Keyworded arguments:**
+
+* `sitemap` (@str or @file) (**required**): The hotdoc sitemap file
+* `index` (@str or @file) (**required**): Location of the index file
+* `dependencies`(@build_tgt): Targets on which the documentation generation depends on.
+* `subprojects`: A list of `HotdocTarget` that are used as subprojects for hotdoc to generate
+  the documentation.
+* ... Any argument of `hotdoc` can be used replacing dashes (`-`) with underscores (`_`).
+  For a full list of available parameters, just have a look at `hotdoc help`.
+
+**Returns:**
+
+`HotdocTarget`: A custom_target with the
+following extra methods:
+
+* `config_path`: Path to the generated `hotdoc` configuration file.
+
+### hotdoc.has_extensions()
+
+**Positional arguments:**
+
+* `...`: The hotdoc extension names to look for
+
+**No keyworded arguments**
+
+**Returns:** `true` if all the extensions where found, `false` otherwise.
+
+### Example
+
+``` meson
+hotdoc = import('hotdoc')
+
+hotdoc.generate_doc('foobar',
+  project_version: '0.1',
+  sitemap: 'sitemap.txt',
+  index: 'index.md',
+  c_sources: 'path/to/file.c',
+  c_smart_index: true,
+  languages: 'c',
+  install: true,
+)
+```
+
+hotdoc: https://hotdoc.github.io/
\ No newline at end of file

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/IDE-integration.md Added

@@ -0,0 +1,428 @@
+---
+short-description: Meson's API to integrate Meson support into an IDE
+...
+
+# IDE integration
+
+Meson has exporters for Visual Studio and XCode, but writing a custom
+backend for every IDE out there is not a scalable approach. To solve
+this problem, Meson provides an API that makes it easy for any IDE or
+build tools to integrate Meson builds and provide an experience
+comparable to a solution native to the IDE.
+
+All the resources required for such a IDE integration can be found in
+the `meson-info` directory in the build directory.
+
+The first thing to do when setting up a Meson project in an IDE is to
+select the source and build directories. For this example we assume
+that the source resides in an Eclipse-like directory called
+`workspace/project` and the build tree is nested inside it as
+`workspace/project/build`. First, we initialize Meson by running the
+following command in the source directory.
+
+    meson setup builddir
+
+With this command Meson will configure the project and also generate
+introspection information that is stored in `intro-*.json` files in
+the `meson-info` directory. The introspection dump will be
+automatically updated when Meson is (re)configured, or the build
+options change. Thus, an IDE can watch for changes in this directory
+to know when something changed. Note that `meson-info.json` guaranteed
+to be the last file written.
+
+The `meson-info` directory should contain the following files:
+
+| File                           | Description                                                                   |
+| ------------------------------ | ----------------------------------------------------------------------------- |
+| `intro-benchmarks.json`        | Lists all benchmarks                                                          |
+| `intro-buildoptions.json`      | Contains a full list of Meson configuration options for the project           |
+| `intro-buildsystem_files.json` | Full list of all Meson build files                                            |
+| `intro-dependencies.json`      | Lists all dependencies used in the project                                    |
+| `intro-installed.json`         | Contains mapping of files to their installed location                         |
+| `intro-install_plan.json`      | Dictionary of data types with the source files and their installation details |
+| `intro-projectinfo.json`       | Stores basic information about the project (name, version, etc.)              |
+| `intro-targets.json`           | Full list of all build targets                                                |
+| `intro-tests.json`             | Lists all tests with instructions how to run them                             |
+
+The content of the JSON files is further specified in the remainder of
+this document.
+
+## The `targets` section
+
+The most important file for an IDE is probably `intro-targets.json`.
+Here each target with its sources and compiler parameters is
+specified. The JSON format for one target is defined as follows:
+
+```json
+{
+    "name": "Name of the target",
+    "id": "The internal ID meson uses",
+    "type": "<TYPE>",
+    "defined_in": "/Path/to/the/targets/meson.build",
+    "subproject": null,
+    "filename": "list", "of", "generated", "files",
+    "build_by_default": true / false,
+    "target_sources": ,
+    "extra_files": "/path/to/file1.hpp", "/path/to/file2.hpp",
+    "installed": true / false,
+}
+```
+
+If the key `installed` is set to `true`, the key `install_filename`
+will also be present. It stores the installation location for each
+file in `filename`. If one file in `filename` is not installed, its
+corresponding install location is set to `null`.
+
+The `subproject` key specifies the name of the subproject this target
+was defined in, or `null` if the target was defined in the top level
+project.
+
+*(New in 0.56.0)* The `extra_files` key lists all files specified via
+the `extra_files` kwarg of a build target. See
+executable.
+
+A target usually generates only one file. However, it is possible for
+custom targets to have multiple outputs.
+
+### Target sources
+
+The `intro-targets.json` file also stores a list of all source objects
+of the target in the `target_sources`. With this information, an IDE
+can provide code completion for all source files.
+
+```json
+{
+    "language": "language ID",
+    "compiler": "The", "compiler", "command",
+    "parameters": "list", "of", "compiler", "parameters",
+    "sources": "list", "of", "all", "source", "files", "for", "this", "language",
+    "generated_sources": "list", "of", "all", "source", "files", "that", "where", "generated", "somewhere", "else"
+}
+```
+
+It should be noted that the compiler parameters stored in the
+`parameters` differ from the actual parameters used to compile the
+file. This is because the parameters are optimized for the usage in an
+IDE to provide autocompletion support, etc. It is thus not recommended
+to use this introspection information for actual compilation.
+
+### Possible values for `type`
+
+The following table shows all valid types for a target.
+
+| value of `type`  | Description                                                                                   |
+| ---------------- | --------------------------------------------------------------------------------------------- |
+| `executable`     | This target will generate an executable file                                                  |
+| `static library` | Target for a static library                                                                   |
+| `shared library` | Target for a shared library                                                                   |
+| `shared module`  | A shared library that is meant to be used with dlopen rather than linking into something else |
+| `custom`         | A custom target                                                                               |
+| `run`            | A Meson run target                                                                            |
+| `jar`            | A Java JAR target                                                                             |
+
+
+### Install plan
+
+The `intro-install_plan.json` file contains a list of the files that are going
+to be installed on the system.
+
+The data contains a list of files grouped by data type. Each file maps to a
+dictionary containing the `destination` and `tag` keys, with the key being the
+file location at build time. `destination` is the destination path using
+placeholders for the base directories. New keys may be added in the future.
+
+```json
+{
+    "targets": {
+        "/path/to/project/builddir/some_executable": {
+            "destination": "{bindir}/some_executable",
+            "tag": "runtime"
+        },
+        "/path/to/project/builddir/libsomelib.so": {
+            "destination": "{libdir_shared}/libsomelib.so",
+            "tag": "runtime"
+        }
+    },
+    "data": {
+        "/path/to/project/some_data": {
+            "destination": "{datadir}/some_data",
+            "tag": null
+        }
+    },
+    "headers": {
+        "/path/to/project/some_header.h": {
+            "destination": "{includedir}/some_header.h",
+            "tag": "devel"
+        }
+    }
+}
+```
+
+Additionally, the `intro-installed.json` file contains the mapping of the
+file path at build time to the absolute system location.
+
+```json
+{
+    "/path/to/project/builddir/some_executable": "/usr/bin/some_executable",
+    "/path/to/project/builddir/libsomelib.so": "/user/lib/libsomelib.so",
+    "/path/to/project/some_data": "/usr/share/some_data",
+    "/path/to/project/some_header.h": "/usr/include/some_header.h"
+}
+```
+
+
+### Using `--targets` without a build directory
+
+It is also possible to get most targets without a build directory.
+This can be done by running `meson introspect --targets
+/path/to/meson.build`.
+
+The generated output is similar to running the introspection with a
+build directory or reading the `intro-targets.json`. However, there
+are some key differences:
+
+- The paths in `filename` now are _relative_ to the future build directory
+- The `install_filename` key is completely missing
+- There is only one entry in `target_sources`:
+  - With the language set to `unknown`
+  - Empty lists for `compiler` and `parameters` and `generated_sources`
+  - The `sources` list _should_ contain all sources of the target
+
+There is no guarantee that the sources list in `target_sources` is
+correct. There might be differences, due to internal limitations. It
+is also not guaranteed that all targets will be listed in the output.
+It might even be possible that targets are listed, which won't exist
+when Meson is run normally. This can happen if a target is defined
+inside an if statement. Use this feature with care.
+
+## Build Options
+
+The list of all build options (build type, warning level, etc.) is
+stored in the `intro-buildoptions.json` file. Here is the JSON format
+for each option.
+
+```json
+{
+    "name": "name of the option",
+    "description": "the description",
+    "type": "type ID",
+    "value": "value depends on type",
+    "section": "section ID",
+    "machine": "machine ID"
+}
+```
+
+The supported types are:
+
+ - string
+ - boolean
+ - combo
+ - integer
+ - array
+
+For the type `combo` the key `choices` is also present. Here all valid
+values for the option are stored.
+
+The possible values for `section` are:
+
+ - core
+ - backend
+ - base
+ - compiler
+ - directory
+ - user
+ - test
+
+The `machine` key specifies the machine configuration for the option.
+Possible values are:
+
+ - any
+ - host
+ - build
+
+To set the options, use the `meson configure` command.
+
+Since Meson 0.50.0 it is also possible to get the default buildoptions
+without a build directory by providing the root `meson.build` instead
+of a build directory to `meson introspect --buildoptions`.
+
+Running `--buildoptions` without a build directory produces the same
+output as running it with a freshly configured build directory.
+
+However, this behavior is not guaranteed if subprojects are present.
+Due to internal limitations all subprojects are processed even if they
+are never used in a real Meson run. Because of this options for the
+subprojects can differ.
+
+## The dependencies section
+
+The list of all _found_ dependencies can be acquired from
+`intro-dependencies.json`. Here, the name, version, compiler and
+linker arguments for a dependency are listed.
+
+### Scanning for dependecie with `--scan-dependencies`
+
+It is also possible to get most dependencies used without a build
+directory. This can be done by running `meson introspect
+--scan-dependencies /path/to/meson.build`.
+
+The output format is as follows:
+
+```json
+
+  {
+    "name": "The name of the dependency",
+    "required": true,
+    "version": ">=1.2.3",
+    "conditional": false,
+    "has_fallback": false
+  }
+
+```
+
+The `required` keyword specifies whether the dependency is marked as
+required in the `meson.build` (all dependencies are required by
+default). The `conditional` key indicates whether the `dependency()`
+function was called inside a conditional block. In a real Meson run
+these dependencies might not be used, thus they _may_ not be required,
+even if the `required` key is set. The `has_fallback` key just
+indicates whether a fallback was directly set in the `dependency()`
+function. The `version` key always contains a list of version
+requirements from the `meson.build` and **not** the actual version of
+the dependency on disc. The version list is empty if no version was
+specified in the `meson.build`.
+
+## Tests
+
+Compilation and unit tests are done as usual by running the `meson
+compile` and `meson test` commands. A JSON formatted result log can be
+found in `workspace/project/builddir/meson-logs/testlog.json`.
+
+When these tests fail, the user probably wants to run the failing test
+in a debugger. To make this as integrated as possible, extract the
+tests from the `intro-tests.json` and `intro-benchmarks.json` files.
+This provides you with all the information needed to run the test:
+what command to execute, command line arguments, environment variable
+settings and how to process the output.
+
+```json
+{
+    "name": "name of the test",
+    "workdir": "the working directory (can be null)",
+    "timeout": "the test timeout",
+    "suite": "list", "of", "test", "suites",
+    "is_parallel": true / false,
+    "protocol": "exitcode" / "tap",
+    "cmd": "command", "to", "run",
+    "depends": "target1-id", "target2-id",
+    "env": {
+        "VARIABLE1": "value 1",
+        "VARIABLE2": "value 2"
+    }
+}
+```
+
+The `depends` entry *(since 0.56.0)* contains target ids; they can be
+looked up in the targets introspection data. The executable pointed to
+by `cmd` is also included in the entry, as are any arguments to the
+test that are build products.
+
+## Build system files
+
+It is also possible to get Meson build files used in your current
+project. This can be done by running `meson introspect
+--buildsystem-files /path/to/builddir`.
+
+The output format is as follows:
+
+```json
+
+    "/Path/to/the/targets/meson.build",
+    "/Path/to/the/targets/meson_options.txt",
+    "/Path/to/the/targets/subdir/meson.build"
+
+```
+
+# Programmatic interface
+
+Meson also provides the `meson introspect` for project introspection
+via the command line. Use `meson introspect -h` to see all available
+options.
+
+This API can also work without a build directory for the
+`--projectinfo` command.
+
+# AST of a `meson.build`
+
+Since Meson *0.55.0* it is possible to dump the AST of a `meson.build`
+as a JSON object. The interface for this is `meson introspect --ast
+/path/to/meson.build`.
+
+Each node of the AST has at least the following entries:
+
+| Key          | Description                                             |
+| ------------ | ------------------------------------------------------- |
+| `node`       | Type of the node (see following table)                  |
+| `lineno`     | Line number of the node in the file                     |
+| `colno`      | Column number of the node in the file                   |
+| `end_lineno` | Marks the end of the node (may be the same as `lineno`) |
+| `end_colno`  | Marks the end of the node (may be the same as `colno`)  |
+
+Possible values for `node` with additional keys:
+
+| Node type            | Additional keys                                  |
+| -------------------- | ------------------------------------------------ |
+| `BooleanNode`        | `value`: bool                                    |
+| `IdNode`             | `value`: str                                     |
+| `NumberNode`         | `value`: int                                     |
+| `StringNode`         | `value`: str                                     |
+| `ContinueNode`       |                                                  |
+| `BreakNode`          |                                                  |
+| `ArgumentNode`       | `positional`: node list; `kwargs`: accept_kwargs |
+| `ArrayNode`          | `args`: node                                     |
+| `DictNode`           | `args`: node                                     |
+| `EmptyNode`          |                                                  |
+| `OrNode`             | `left`: node; `right`: node                      |
+| `AndNode`            | `left`: node; `right`: node                      |
+| `ComparisonNode`     | `left`: node; `right`: node; `ctype`: str        |
+| `ArithmeticNode`     | `left`: node; `right`: node; `op`: str           |
+| `NotNode`            | `right`: node                                    |
+| `CodeBlockNode`      | `lines`: node list                               |
+| `IndexNode`          | `object`: node; `index`: node                    |
+| `MethodNode`         | `object`: node; `args`: node; `name`: str        |
+| `FunctionNode`       | `args`: node; `name`: str                        |
+| `AssignmentNode`     | `value`: node; `var_name`: str                   |
+| `PlusAssignmentNode` | `value`: node; `var_name`: str                   |
+| `ForeachClauseNode`  | `items`: node; `block`: node; `varnames`: list   |
+| `IfClauseNode`       | `ifs`: node list; `else`: node                   |
+| `IfNode`             | `condition`: node; `block`: node                 |
+| `UMinusNode`         | `right`: node                                    |
+| `TernaryNode`        | `condition`: node; `true`: node; `false`: node   |
+
+We do not guarantee the stability of this format since it is heavily
+linked to the internal Meson AST. However, breaking changes (removal
+of a node type or the removal of a key) are unlikely and will be
+announced in the release notes.
+
+
+# JSON Reference manual
+
+In additional to the online Reference manual(Reference-manual.md), Meson also
+offers the manual as JSON file. The content of this file is generated from the
+same source as the online documentation. The two versions are thus identical
+in content.
+
+This JSON document is attached to every Meson release since *0.60.0*. The JSON
+schema is defined by the class structure given in
+`jsonschema.py`(https://github.com/mesonbuild/meson/blob/master/docs/refman/jsonschema.py)
+
+# Existing integrations
+
+- Gnome Builder(https://wiki.gnome.org/Apps/Builder)
+- KDevelop(https://www.kdevelop.org)
+- Eclipse CDT(https://www.eclipse.org/cdt/) (experimental)
+- Meson Cmake Wrapper(https://github.com/prozum/meson-cmake-wrapper) (for cmake IDEs) (currently unmaintained !!)
+- Meson-UI(https://github.com/michaelbadcrumble/meson-ui) (Meson build GUI)
+- Meson Syntax Highlighter(https://plugins.jetbrains.com/plugin/13269-meson-syntax-highlighter) plugin for JetBrains IDEs.
+- asabil.meson(https://open-vsx.org/extension/asabil/meson) extension for VS Code/Codium
+- Qt Creator(https://doc.qt.io/qtcreator/creator-project-meson.html)

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/Icestorm-module.md Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/In-the-press.md Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/Include-directories.md Added

@@ -0,0 +1,30 @@
+---
+short-description: Instructions on handling include directories
+...
+
+# Include directories
+
+Most `C`/`C++` projects have headers in different directories than
+sources. Thus you need to specify include directories. Let's assume
+that we are at some subdirectory and wish to add its `include`
+subdirectory to some target's search path. To create a include
+directory object we do this:
+
+```meson
+incdir = include_directories('include')
+```
+
+The `incdir` variable now holds a reference to the `include` subdir.
+Now we pass that as an argument to a build target:
+
+```meson
+executable('someprog', 'someprog.c', include_directories : incdir)
+```
+
+Note that these two commands can be given in any subdirectories and it
+will still work. Meson will keep track of the locations and generate
+proper compiler flags to make it all work.
+
+Another thing to note is that `include_directories` adds both the
+source directory and corresponding build directory to include path, so
+you don't have to care.

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/IndepthTutorial.md Added

@@ -0,0 +1,150 @@
+# An in-depth tutorial
+
+In this tutorial we set up a project with multiple targets, unit tests
+and dependencies between targets. Our main product is a shared library
+called *foo* that is written in `C++11`. We are going to ignore the
+contents of the source files, as they are not really important from a
+build definition point of view. The library makes use of the `GLib`
+library so we need to detect and link it properly. We also make the
+resulting library installable.
+
+The source tree contains three subdirectories `src`, `include` and
+`test` that contain, respectively, the source code, headers and unit
+tests of our project.
+
+To start things up, here is the top level `meson.build` file.
+
+```meson
+project('c++ foolib', 'cpp',
+  version : '1.0.0',
+  license : 'MIT')
+add_global_arguments('-DSOME_TOKEN=value', language : 'cpp')
+glib_dep = dependency('glib-2.0')
+
+inc = include_directories('include')
+
+subdir('include')
+subdir('src')
+subdir('test')
+
+pkg_mod = import('pkgconfig')
+pkg_mod.generate(libraries : foolib,
+                 version : '1.0',
+                 name : 'libfoobar',
+                 filebase : 'foobar',
+                 description : 'A Library to barnicate your foos.')
+```
+
+The definition always starts with a call to the `project` function. In
+it you must specify the project's name and programming languages to
+use, in this case only `C++`. We also specify two additional
+arguments, the project's version and the license it is under. Our
+project is version `1.0.0` and is specified to be under the MIT
+license.
+
+Then we find GLib, which is an *external dependency*. The `dependency`
+function tells Meson to find the library (by default using
+`pkg-config`). If the library is not found, Meson will raise an error
+and stop processing the build definition.
+
+Then we add a global compiler argument `-DSOME_TOKEN=value`. This flag
+is used for *all* C++ source file compilations. It is not possible to
+unset it for some targets. The reason for this is that it is hard to
+keep track of what compiler flags are in use if global settings change
+per target.
+
+Since `include` directory contains the header files, we need a way to
+tell compilations to add that directory to the compiler command line.
+This is done with the `include_directories` command that takes a
+directory and returns an object representing this directory. It is
+stored in variable `inc` which makes it accessible later on.
+
+After this are three `subdir` commands. These instruct Meson to go to
+the specified subdirectory, open the `meson.build` file that's in
+there and execute it. The last few lines are a stanza to generate a
+`pkg-config` file. We'll skip that for now and come back to it at the
+end of this document.
+
+The first subdirectory we go into is `include`. In it we have a
+header file for the library that we want to install. This requires one
+line.
+
+```meson
+install_headers('foolib.h')
+```
+
+This installs the given header file to the system's header directory.
+This is by default `/install prefix/include`, but it can be changed
+with a command line argument.
+
+The Meson definition of `src` subdir is simple.
+
+```meson
+foo_sources = 'source1.cpp', 'source2.cpp'
+foolib = shared_library('foo',
+                        foo_sources,
+                        include_directories : inc,
+                        dependencies : glib_dep,
+                        install : true)
+```
+
+Here we just tell Meson to build the library with the given sources.
+We also tell it to use the include directories we stored to variable
+`inc` earlier. Since this library uses GLib, we tell Meson to add all
+necessary compiler and linker flags with the `dependencies` keyword
+argument. Its value is `glib_dep` which we set at the top level
+`meson.build` file. The `install` argument tells Meson to install the
+result. As with the headers, the shared library is installed to the
+system's default location (usually `/install prefix/lib`) but is
+again overridable.
+
+The resulting library is stored in variable `foolib` just like the
+include directory was stored in the previous file.
+
+Once Meson has processed the `src` subdir it returns to the main Meson
+file and executes the next line that moves it into the `test` subdir.
+Its contents look like this.
+
+```meson
+testexe = executable('testexe', 'footest.cpp',
+                     include_directories : inc,
+                     link_with : foolib)
+test('foolib test', testexe)
+```
+
+First we build a test executable that has the same include directory
+as the main library and which also links against the freshly built
+shared library. Note that you don't need to specify `glib_dep` here
+just to be able to use the built library `foolib`. If the executable
+used GLib functionality itself, then we would of course need to add it
+as a keyword argument here.
+
+Finally we define a test with the name `foolib test`. It consists of
+running the binary we just built. If the executable exits with a zero
+return value, the test is considered passed. Nonzero return values
+mark the test as failed.
+
+At this point we can return to the pkg-config generator line. All
+shared libraries should provide a pkg-config file, which explains how
+that library is used. Meson provides this simple generator that should
+be sufficient for most simple projects. All you need to do is list a
+few basic pieces of information and Meson takes care of generating an
+appropriate file. More advanced users might want to create their own
+pkg-config files using Meson's configuration file generator
+system(Configuration.md).
+
+With these four files we are done. To configure, build and run the
+test suite, we just need to execute the following commands (starting
+at source tree root directory).
+
+```console
+$ meson setup builddir && cd builddir
+$ meson compile
+$ meson test
+```
+
+To then install the project you only need one command.
+
+```console
+$ meson install
+```

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/Installing.md Added

@@ -0,0 +1,205 @@
+---
+short-description: Installing targets
+...
+
+# Installing
+
+Invoked via the following command(Commands.md#install) *(available
+since 0.47.0)*:
+
+```sh
+meson install
+```
+
+or alternatively (on older Meson versions with `ninja` backend):
+
+```sh
+ninja install
+```
+
+By default Meson will not install anything. Build targets can be
+installed by tagging them as installable in the definition.
+
+```meson
+project('install', 'c')
+shared_library('mylib', 'libfile.c', install : true)
+```
+
+There is usually no need to specify install paths or the like. Meson
+will automatically install it to the standards-conforming location. In
+this particular case the executable is installed to the `bin`
+subdirectory of the install prefix. However if you wish to override
+the install dir, you can do that with the `install_dir` argument.
+
+```meson
+executable('prog', 'prog.c', install : true, install_dir : 'my/special/dir')
+```
+
+Other install commands are the following.
+
+```meson
+install_headers('header.h', subdir : 'projname') # -> include/projname/header.h
+install_man('foo.1') # -> share/man/man1/foo.1
+install_data('datafile.dat', install_dir : get_option('datadir') / 'progname')
+# -> share/progname/datafile.dat
+```
+
+`install_data()` supports rename of the file *since 0.46.0*.
+
+```meson
+# file.txt -> {datadir}/{projectname}/new-name.txt
+install_data('file.txt', rename : 'new-name.txt')
+
+# file1.txt -> share/myapp/dir1/data.txt
+# file2.txt -> share/myapp/dir2/data.txt
+install_data('file1.txt', 'file2.txt',
+             rename : 'dir1/data.txt', 'dir2/data.txt',
+             install_dir : 'share/myapp')
+```
+
+Sometimes you want to copy an entire subtree directly. For this use
+case there is the `install_subdir` command, which can be used like
+this.
+
+```meson
+install_subdir('mydir', install_dir : 'include') # mydir subtree -> include/mydir
+```
+
+Most of the time you want to install files relative to the install
+prefix. Sometimes you need to go outside of the prefix (such as writing
+files to `/etc` instead of `/usr/etc`. This can be accomplished by
+giving an absolute install path.
+
+```meson
+install_data(sources : 'foo.dat', install_dir : '/etc') # -> /etc/foo.dat
+```
+
+## Custom install script
+
+Sometimes you need to do more than just install basic targets. Meson
+makes this easy by allowing you to specify a custom script to execute
+at install time. As an example, here is a script that generates an
+empty file in a custom directory.
+
+```bash
+#!/bin/sh
+
+mkdir "${DESTDIR}/${MESON_INSTALL_PREFIX}/mydir"
+touch "${DESTDIR}/${MESON_INSTALL_PREFIX}/mydir/file.dat"
+```
+
+As you can see, Meson sets up some environment variables to help you
+write your script (`DESTDIR` is not set by Meson, it is inherited from
+the outside environment). In addition to the install prefix, Meson
+also sets the variables `MESON_SOURCE_ROOT` and `MESON_BUILD_ROOT`.
+
+Telling Meson to run this script at install time is a one-liner.
+
+```meson
+#meson.add_install_script('myscript.sh')
+```
+
+The argument is the name of the script file relative to the current
+subdirectory.
+
+## DESTDIR support
+
+Sometimes you need to install to a different directory than the
+install prefix. This is most common when building rpm or deb
+packages. This is done with the `DESTDIR` environment variable and it
+is used just like with other build systems:
+
+```console
+$ DESTDIR=/path/to/staging/area meson install
+```
+
+Since *0.57.0* `--destdir` argument can be used instead of environment. In that
+case Meson will set `DESTDIR` into environment when running install scripts.
+
+Since *0.60.0* `DESTDIR` and `--destdir` can be a path relative to build
+directory. An absolute path will be set into environment when executing scripts.
+
+## Custom install behaviour
+
+Installation behaviour can be further customized using additional
+arguments.
+
+For example, if you wish to install the current setup without
+rebuilding the code (which the default install target always does) and
+only installing those files that have changed, you would run this
+command in the build tree:
+
+```console
+$ meson install --no-rebuild --only-changed
+```
+
+## Installation tags
+
+*Since 0.60.0*
+
+It is possible to install only a subset of the installable files using
+`meson install --tags tag1,tag2` command line. When `--tags` is specified, only
+files that have been tagged with one of the tags are going to be installed.
+
+This is intended to be used by packagers (e.g. distributions) who typically
+want to split `libfoo`, `libfoo-dev` and `libfoo-doc` packages. Instead of
+duplicating the list of installed files per category in each packaging system,
+it can be maintained in a single place, directly in upstream `meson.build` files.
+
+Meson sets predefined tags on some files. More tags are likely to be added over
+time, please help extending the list of well known categories.
+- `devel`:
+  * static_library,
+  * install_headers,
+  * `pkgconfig.generate()`,
+  * `gnome.generate_gir()` - `.gir` file,
+  * `gnome.generate_vapi()` - `.vapi` file (*Since 0.64.0*),
+  * Files installed into `libdir` and with `.a` or `.pc` extension,
+  * File installed into `includedir`,
+  * Generated header files installed with `gnome.compile_resources()`,
+    `gnome.genmarshal()`, `gnome.mkenums()`, `gnome.mkenums_simple()`
+    and `gnome.gdbus_codegen()` (*Since 0.64.0*).
+- `runtime`:
+  * executable,
+  * shared_library,
+  * shared_module,
+  * jar,
+  * `gnome.compile_resources()` - `.gresource` file (*Since 0.64.0*),
+  * Files installed into `bindir`,
+  * Files installed into `libdir` and with `.so` or `.dll` extension.
+- `python-runtime`:
+  * `python.install_sources()`.
+- `man`:
+  * install_man.
+- `doc`:
+  * `gnome.gtkdoc()`,
+  * `gnome.yelp()`,
+  * `hotdoc.generate_doc()`.
+- `i18n`:
+  * `i18n.gettext()`,
+  * `qt.compile_translations()`,
+  * Files installed into `localedir`.
+- `typelib`:
+  * `gnome.generate_gir()` - `.typelib` file.
+- `bin`:
+  * Scripts and executables bundled with a library meant to be used by end
+    users.
+- `bin-devel`:
+  * Scripts and executables bundled with a library meant to be used by
+    developers (i.e. build tools).
+- `tests`:
+  * Files installed into `installed-tests` subdir (*Since 0.64.0*).
+- `systemtap`:
+  * Files installed into `systemtap` subdir (*Since 0.64.0*).
+
+Custom installation tag can be set using the `install_tag` keyword argument
+on various functions such as custom_target, configure_file,
+install_subdir and install_data. See their respective documentation
+in the reference manual for details. It is recommended to use one of the
+predefined tags above when possible.
+
+Installable files that have not been tagged either automatically by Meson, or
+manually using `install_tag` keyword argument won't be installed when `--tags`
+is used. They are reported at the end of `<builddir>/meson-logs/meson-log.txt`,
+it is recommended to add missing `install_tag` to have a tag on each installable
+files.

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/Java-module.md Added

@@ -0,0 +1,105 @@
+# Java Module
+
+*(added in 0.60.0)*
+
+## Functions
+
+### `generate_native_header()`
+
+*(deprecated in 0.62.0, use `generate_native_headers()`)*
+*(removed in 1.0.0)*
+
+This function will generate a header file for use in Java native module
+development by reading the supplied Java file for `native` method declarations.
+
+Keyword arguments:
+
+- `package`: The package(https://en.wikipedia.org/wiki/Java_package) of the
+file. If left empty, Meson will assume that there is no package.
+
+### `generate_native_headers()`
+
+*(added in 0.62.0)*
+*(deprecated in 1.0.0, use `native_headers()`)*
+
+This function will generate native header files for use in Java native module
+development by reading the supplied Java files for `native` method declarations.
+
+Keyword arguments:
+
+- `classes`: The list of class names relative to the `package`, if it exists,
+which contain `native` method declarations. Use `.` separated class names.
+
+- `package`: The package(https://en.wikipedia.org/wiki/Java_package) of the
+file. If left empty, Meson will assume that there is no package.
+
+Example:
+
+```java
+// Outer.java
+
+package com.mesonbuild;
+
+public class Outer {
+    private static native void outer();
+
+    public static class Inner {
+        private static native void inner();
+    }
+}
+```
+
+With the above file, an invocation would look like the following:
+
+```meson
+java = import('java')
+
+native_headers = java.generate_native_headers(
+    'Outer.java',
+    package: 'com.mesonbuild',
+    classes: 'Outer', 'Outer.Inner'
+)
+```
+
+### `native_headers()`
+
+*(added in 1.0.0)*
+
+This function will generate native header files for use in Java native module
+development by reading the supplied Java files for `native` method declarations.
+
+Keyword arguments:
+
+- `classes`: The list of class names relative to the `package`, if it exists,
+which contain `native` method declarations. Use `.` separated class names.
+
+- `package`: The package(https://en.wikipedia.org/wiki/Java_package) of the
+file. If left empty, Meson will assume that there is no package.
+
+Example:
+
+```java
+// Outer.java
+
+package com.mesonbuild;
+
+public class Outer {
+    private static native void outer();
+
+    public static class Inner {
+        private static native void inner();
+    }
+}
+```
+
+With the above file, an invocation would look like the following:
+
+```meson
+java = import('java')
+
+native_headers = java.generate_native_headers(
+    'Outer.java',
+    package: 'com.mesonbuild',
+    classes: 'Outer', 'Outer.Inner'
+)
+```

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/Java.md Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/Keyval-module.md Added

@@ -0,0 +1,58 @@
+---
+short-description: Keyval module
+authors:
+    - name: Mark Schulte, Paolo Bonzini
+      years: 2017, 2019
+      has-copyright: false
+...
+
+# keyval module
+
+This module parses files consisting of a series of `key=value` lines.
+One use of this module is to load kconfig configurations in Meson
+projects.
+
+**Note**: this does not provide kconfig frontend tooling to generate a
+configuration. You still need something such as kconfig frontends (see
+link below) to parse your Kconfig files, and then (after you've chosen
+the configuration options), output a ".config" file.
+
+  kconfig-frontends: http://ymorin.is-a-geek.org/projects/kconfig-frontends
+
+## Usage
+
+The module may be imported as follows:
+
+``` meson
+keyval = import('keyval')
+```
+
+The following functions will then be available as methods on the object
+with the name `keyval`. You can, of course, replace the name
+`keyval` with anything else.
+
+### keyval.load()
+
+This function loads a file consisting of a series of `key=value` lines
+and returns a dictionary object.
+
+`keyval.load()` makes no attempt at parsing the values in the file. In
+particular boolean and integer values will be represented as strings,
+and strings will keep any quoting that is present in the input file.
+It can be useful to create a
+`configuration_data()`(#configuration_data) object from the
+dictionary and use methods such as `get_unquoted()`.
+
+Kconfig frontends usually have ".config" as the default name for the
+configuration file. However, placing the configuration file in the
+source directory limits the user to one configuration per source
+directory. In order to allow separate configurations for each build
+directory, as is the Meson standard, `meson.build` should not hardcode
+".config" as the argument to `kconfig.load()`, and should instead make
+the argument to `kconfig.load()` a project build
+option(Build-options.md).
+
+* The first (and only) argument is the path to the configuration file to
+  load (usually ".config").
+
+**Returns**: a @dict object.

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/Localisation.md Added

@@ -0,0 +1,84 @@
+---
+short-description: Localization with GNU Gettext
+...
+
+# Localisation
+
+Localising your application with GNU gettext takes a little effort but
+is quite straightforward. We'll create a `po` subdirectory at your
+project root directory for all the localisation info.
+
+## Generating .pot and .po files
+
+In your main meson.build file include the `po` subdirectory in the build process.
+
+    subdir('po')
+
+In this `po` subdirectory we need:
+- `LINGUAS`: Space separated list of languages
+- `POTFILES`: List of source files to scan for translatable strings.
+- `meson.build`: Localization specific Meson file
+
+### LINGUAS
+
+File with space separated list of languages. A sample LINGUAS might look like this.
+
+    aa ab ae af
+
+### POTFILES
+
+File that lists all the source files that gettext should scan in order
+to find strings to translate. The syntax of the file is one line per
+source file and the line must contain the relative path from source
+root. A sample POTFILES might look like this.
+
+    src/file1.c
+    src/file2.c
+    src/subdir/file3.c
+    include/mything/somefile.h
+
+### meson.build
+
+Localization specific Meson file. It imports and uses the `i18n`
+module. If not defined before it needs to define the `GETTEXT_PACKAGE`
+global.
+
+```meson
+i18n = import('i18n')
+# define GETTEXT_PACKAGE
+add_project_arguments('-DGETTEXT_PACKAGE="intltest"', language:'c')
+i18n.gettext(meson.project_name())
+```
+
+The first command imports the `i18n` module that provides gettext
+features. The fourth line does the actual invocation. The first
+argument is the gettext package name. This causes two things to
+happen. The first is that Meson will generate binary mo files and put
+them to their proper locations when doing an install. The second is
+that it creates a build rule to regenerate the main pot file. If you
+are using the Ninja backend, this is how you would invoke the rebuild.
+
+### generate .pot file
+
+Then we need to generate the main pot file. The potfile can have any
+name but is usually the name of the gettext package. Let's say the
+project is called *intltest*. In this case the corresponding pot file
+would be called `intltest.pot`.
+
+Run the following command from your build folder to generate the pot
+file. It is recommended to inspect it manually afterwards and fill in
+e.g. proper copyright and contact information.
+
+```console
+$ meson compile intltest-pot
+```
+
+### generate .po files
+
+For each language listed in the array above we need a corresponding
+`.po` file. Those can be generated by running the following command
+from your build folder.
+
+```console
+$ meson compile intltest-update-po
+```

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/Machine-files.md Added

@@ -0,0 +1,361 @@
+# Cross and Native File reference
+
+Cross and native files are nearly identical, but not completely. This
+is the documentation on the common values used by both, for the
+specific values of one or the other see the cross
+compilation(Cross-compilation.md) and native
+environments(Native-environments.md).
+
+*Changed in 0.56.0* Keys within sections are now case sensitive. This
+is required to make project options work correctly.
+
+## Data Types
+
+There are four basic data types in a machine file:
+- strings
+- arrays
+- booleans
+- integers
+
+A string is specified single quoted:
+```ini
+section
+option1 = 'false'
+option2 = '2'
+```
+
+An array is enclosed in square brackets, and must consist of strings or booleans
+```ini
+section
+option = 'value'
+```
+
+A boolean must be either `true` or `false`, and unquoted.
+```ini
+option = false
+```
+
+An integer must be an unquoted numeric constant.
+```ini
+option = 42
+```
+
+## Sections
+
+The following sections are allowed:
+- constants
+- binaries
+- paths
+- properties
+- cmake
+- project options
+- built-in options
+
+### constants
+
+*Since 0.56.0*
+
+String and list concatenation is supported using the `+` operator,
+joining paths is supported using the `/` operator. Entries defined in
+the `constants` section can be used in any other section (they are
+always parsed first), entries in any other section can be used only
+within that same section and only after it has been defined.
+
+```ini
+constants
+toolchain = '/toolchain'
+common_flags = '--sysroot=' + toolchain / 'sysroot'
+
+properties
+c_args = common_flags + '-DSOMETHING'
+cpp_args = c_args + '-DSOMETHING_ELSE'
+
+binaries
+c = toolchain / 'gcc'
+```
+
+This can be useful with cross file composition as well. A generic
+cross file could be composed with a platform specific file where
+constants are defined:
+
+```ini
+# aarch64.ini
+constants
+arch = 'aarch64-linux-gnu'
+```
+
+```ini
+# cross.ini
+binaries
+c = arch + '-gcc'
+cpp = arch + '-g++'
+strip = arch + '-strip'
+pkgconfig = arch + '-pkg-config'
+...
+```
+
+This can be used as `meson setup --cross-file aarch64.ini --cross-file
+cross.ini builddir`.
+
+Note that file composition happens before the parsing of values. The
+example below results in `b` being `'HelloWorld'`:
+
+```ini
+# file1.ini:
+constants
+a = 'Foo'
+b = a + 'World'
+```
+
+```ini
+#file2.ini:
+constants
+a = 'Hello'
+```
+
+The example below results in an error when file1.ini is included
+before file2.ini because `b` would be defined before `a`:
+
+```ini
+# file1.ini:
+constants
+b = a + 'World'
+```
+
+```ini
+#file2.ini:
+constants
+a = 'Hello'
+```
+
+### Binaries
+
+The binaries section contains a list of binaries. These can be used
+internally by Meson, or by the `find_program` function.
+
+These values must be either strings or an array of strings
+
+Compilers and linkers are defined here using `<lang>` and `<lang>_ld`.
+`<lang>_ld` is special because it is compiler specific. For compilers
+like gcc and clang which are used to invoke the linker this is a value
+to pass to their "choose the linker" argument (-fuse-ld= in this
+case). For compilers like MSVC and Clang-Cl, this is the path to a
+linker for Meson to invoke, such as `link.exe` or `lld-link.exe`.
+Support for `ld` is *new in 0.53.0*
+
+*changed in 0.53.1* the `ld` variable was replaced by `<lang>_ld`,
+because it regressed a large number of projects. in 0.53.0 the `ld`
+variable was used instead.
+
+Native example:
+
+```ini
+c = '/usr/bin/clang'
+c_ld = 'lld'
+sed = 'C:\\program files\\gnu\\sed.exe'
+llvm-config = '/usr/lib/llvm8/bin/llvm-config'
+```
+
+Cross example:
+
+```ini
+c = 'ccache', '/usr/bin/i586-mingw32msvc-gcc'
+cpp = 'ccache', '/usr/bin/i586-mingw32msvc-g++'
+c_ld = 'gold'
+cpp_ld = 'gold'
+ar = '/usr/i586-mingw32msvc/bin/ar'
+strip = '/usr/i586-mingw32msvc/bin/strip'
+pkgconfig = '/usr/bin/i586-mingw32msvc-pkg-config'
+```
+
+An incomplete list of internally used programs that can be overridden
+here is:
+
+- cmake
+- cups-config
+- gnustep-config
+- gpgme-config
+- libgcrypt-config
+- libwmf-config
+- llvm-config
+- pcap-config
+- pkgconfig
+- sdl2-config
+- wx-config (or wx-3.0-config or wx-config-gtk)
+
+### Paths and Directories
+
+*Deprecated in 0.56.0* use the built-in section instead.
+
+As of 0.50.0 paths and directories such as libdir can be defined in
+the native and cross files in a paths section. These should be
+strings.
+
+```ini
+paths
+libdir = 'mylibdir'
+prefix = '/my prefix'
+```
+
+These values will only be loaded when not cross compiling. Any
+arguments on the command line will override any options in the native
+file. For example, passing `--libdir=otherlibdir` would result in a
+prefix of `/my prefix` and a libdir of `otherlibdir`.
+
+### Properties
+
+*New in native files in 0.54.0*, always in cross files.
+
+In addition to special data that may be specified in cross files, this
+section may contain random key value pairs accessed using the
+`meson.get_external_property()`, or `meson.get_cross_property()`.
+
+*Changed in 0.56.0* putting `<lang>_args` and `<lang>_link_args` in
+the properties section has been deprecated, and should be put in the
+built-in options section.
+
+#### Supported properties
+
+This is a non exhaustive list of supported variables in the `properties`
+section.
+
+- `cmake_toolchain_file` specifies an absolute path to an already existing
+  CMake toolchain file that will be loaded with `include()` as the last
+  instruction of the automatically generated CMake toolchain file from Meson.
+  (*new in 0.56.0*)
+- `cmake_defaults` is a boolean that specifies whether Meson should automatically
+  generate default toolchain variables from other sections (`binaries`,
+  `host_machine`, etc.) in the machine file. Defaults are always overwritten
+  by variables set in the `cmake` section. The default is `true`. (*new in 0.56.0*)
+- `cmake_skip_compiler_test` is an enum that specifies when Meson should
+  automatically generate toolchain variables to skip the CMake compiler
+  sanity checks. This only has an effect if `cmake_defaults` is `true`.
+  Supported values are `always`, `never`, `dep_only`. The default is `dep_only`.
+  (*new in 0.56.0*)
+- `cmake_use_exe_wrapper` is a boolean that controls whether to use the
+  `exe_wrapper` specified in `binaries` to run generated executables in CMake
+  subprojects. This setting has no effect if the `exe_wrapper` was not specified.
+  The default value is `true`. (*new in 0.56.0*)
+- `java_home` is an absolute path pointing to the root of a Java installation.
+
+### CMake variables
+
+*New in 0.56.0*
+
+All variables set in the `cmake` section will be added to the
+generate CMake toolchain file used for both CMake dependencies and
+CMake subprojects. The type of each entry must be either a string or a
+list of strings.
+
+**Note:** All occurrences of `\` in the value of all keys will be replaced with
+          a `/` since CMake has a lot of issues with correctly escaping `\` when
+          dealing with variables (even in cases where a path in `CMAKE_C_COMPILER`
+          is correctly escaped, CMake will still trip up internally for instance)
+
+          A custom toolchain file should be used (via the `cmake_toolchain_file`
+          property) if `\` support is required.
+
+```ini
+cmake
+
+CMAKE_C_COMPILER    = '/usr/bin/gcc'
+CMAKE_CXX_COMPILER  = 'C:\\user\\bin\\g++'
+CMAKE_SOME_VARIABLE = 'some', 'value with spaces'
+```
+
+For instance, the `cmake` section from above will generate the
+following code in the CMake toolchain file:
+
+```cmake
+set(CMAKE_C_COMPILER    "/usr/bin/gcc")
+set(CMAKE_CXX_COMPILER  "C:/usr/bin/g++")
+set(CMAKE_SOME_VARIABLE "some" "value with spaces")
+```
+
+### Project specific options
+
+*New in 0.56.0*
+
+Path options are not allowed, those must be set in the `paths`
+section.
+
+Being able to set project specific options in a cross or native file
+can be done using the `project options` section of the specific file
+(if doing a cross build the options from the native file will be
+ignored)
+
+For setting options in subprojects use the `<subproject>:project
+options` section instead.
+
+```ini
+project options
+build-tests = true
+
+zlib:project options
+build-tests = false
+```
+
+### Meson built-in options
+
+*Before 0.56.0, `<lang>_args` and `<lang>_link_args` must be put in the `properties` section instead, else they will be ignored.*
+
+Meson built-in options can be set the same way:
+
+```ini
+built-in options
+c_std = 'c99'
+```
+
+You can set some Meson built-in options on a per-subproject basis,
+such as `default_library` and `werror`. The order of precedence is:
+
+1) Command line
+2) Machine file
+3) Build system definitions
+
+```ini
+zlib:built-in options
+default_library = 'static'
+werror = false
+```
+
+Options set on a per-subproject basis will inherit the option from the
+parent if the parent has a setting but the subproject doesn't, even
+when there is a default set Meson language.
+
+```ini
+built-in options
+default_library = 'static'
+```
+
+will make subprojects use default_library as static.
+
+Some options can be set on a per-machine basis (in other words, the
+value of the build machine can be different than the host machine in a
+cross compile). In these cases the values from both a cross file and a
+native file are used.
+
+An incomplete list of options is:
+- pkg_config_path
+- cmake_prefix_path
+
+## Loading multiple machine files
+
+Native files allow layering (cross files can be layered since Meson
+0.52.0). More than one file can be loaded, with values from a previous
+file being overridden by the next. The intention of this is not
+overriding, but to allow composing files. This composition is done by
+passing the command line argument multiple times:
+
+```console
+meson setup builddir/ --cross-file first.ini --cross-file second.ini --cross-file third.ini
+```
+
+In this case `first.ini` will be loaded, then `second.ini`, with
+values from `second.ini` replacing `first.ini`, and so on.
+
+For example, if there is a project using C and C++, python 3.4-3.7,
+and LLVM 5-7, and it needs to build with clang 5, 6, and 7, and gcc
+5.x, 6.x, and 7.x; expressing all of these configurations in
+monolithic configurations would result in 81 different native files.
+By layering them, it can be expressed by just 12 native files.

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/Manual.md Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/Meson-sample.md Added

@@ -0,0 +1,80 @@
+---
+short-description: Simple project step by step explanation
+...
+
+# Meson sample
+
+A Meson file that builds an executable looks like this.
+
+```meson
+project('simple', 'c')
+executable('myexe', 'source.c')
+```
+
+All Meson build definitions begin with the `project` command. It
+specifies the name of the project and what programming languages it
+uses. Here the project is called *simple* and it uses only the C
+programming language. All strings are single-quoted.
+
+On the next line we define a *build target*, in this case an
+executable called *myexe*. It consists of one source file. This is all
+the code that a user needs to write to compile an executable with
+Meson.
+
+Variables are fully supported. The above code snippet could also have
+been declared like this.
+
+```meson
+project('simple', 'c')
+src = 'source.c'
+executable('myexe', src)
+```
+
+Most executables consist of more than one source file. The easiest way
+to deal with this is to put them in an array.
+
+```meson
+project('simple', 'c')
+src = 'source1.c', 'source2.c', 'source3.c'
+executable('myexe', src)
+```
+
+Meson also supports the notion of *keyword arguments*. Indeed most
+arguments to functions can only be passed using them. The above
+snippet could be rewritten like this.
+
+```meson
+project('simple', 'c')
+src = 'source1.c', 'source2.c', 'source3.c'
+executable('myexe', sources : src)
+```
+
+These two formats are equivalent and choosing one over the other is
+mostly a question of personal preference.
+
+The `executable` command actually returns an *executable object*,
+which represents the given build target. It can be passed on to other
+functions, like this.
+
+```meson
+project('simple', 'c')
+src = 'source1.c', 'source2.c', 'source3.c'
+exe = executable('myexe', src)
+test('simple test', exe)
+```
+
+Here we create a unit test called *simple test*, and which uses the
+built executable. When the tests are run with the `meson test`
+command, the built executable is run. If it returns zero, the test
+passes. A non-zero return value indicates an error, which Meson will
+then report to the user.
+
+A note to Visual Studio users
+-----
+
+There's a slight terminology difference between Meson and Visual
+Studio. A Meson *project* is the equivalent to a Visual Studio
+*solution*. That is, the topmost thing that encompasses all things to
+be built. A Visual Studio *project* on the other hand is the
+equivalent of a Meson top level build target, such as an executable or
+a shared library.

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/MesonCI.md Added

@@ -0,0 +1,43 @@
+# Meson CI setup
+
+This document is aimed for Meson contributors and documents the CI
+setup used for testing Meson itself. The Meson project uses multiple
+CI platforms for covering a wide range of target systems.
+
+## GitHub actions
+
+The configuration files for GitHub actions are located in
+`.github/workflows`. Here, all images(#docker-images) are tested
+with the full `run_tests.py` run. Additionally, some other, smaller,
+tests are run.
+
+## Docker images
+
+The Linux docker images are automatically built and uploaded by GitHub
+actions. An image rebuild is triggered when any of the image definition
+files are changed (in `ci/ciimage`) in the master branch.
+Additionally, the images are also updated weekly.
+
+Each docker image has one corresponding directory in `ci/ciimage` with
+an `image.json` and an `install.sh`.
+
+### Image generation
+
+There are no manual Dockerfiles. Instead the Dockerfile is
+automatically generated by the `build.py` script. This is done to
+ensure that all images have the same layout and can all be built and
+tested automatically.
+
+The Dockerfile is generated from the `image.json` file and basically
+only adds a few common files and runs the `install.sh` script which
+should contain all distribution specific setup steps. The `common.sh`
+can be sourced via `source /ci/common.sh` to access some shared
+functionalety.
+
+To generate the image run `build.py -t build <image>`. A generated
+image can be tested with `build.py -t test <image>`.
+
+### Common image setup
+
+Each docker image has a `/ci` directory with an `env_vars.sh` script.
+This script has to be sourced before running the Meson test suite.

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/Mixing-build-systems.md Added

@@ -0,0 +1,55 @@
+# Meson's policy on mixing multiple build systems in one build directory
+
+Meson has been designed with the principle that all dependencies are
+either provided by "the platform" via a mechanism such as Pkg-Config
+or that they are built as Meson subprojects under the main project.
+There are several projects that would like to mix build systems, that
+is, build dependencies in the same build directory as the other build
+system by having one build system call the other. The build
+directories do not necessarily need to be inside each other, but that
+is the common case.
+
+This page lists the Meson project's stance on mixing build systems.
+The tl/dr version is that while we do provide some functionality for
+this use case, it only works for simple cases. Anything more complex
+can not be made reliable and trying to do that would burden Meson
+developers with an effectively infinite maintenance burden. Thus these
+use cases are not guaranteed to work, and even if a project using them
+works today there are no guarantees that it will work in any future
+version.
+
+## The definition of "build system mixing"
+
+For the purposes of this page, mixing build systems means any and all
+mechanisms where one build system uses build artifacts from a
+different build system's build directory in any way.
+
+Note that this definition does not specify what the dependencies are
+and how they are built, only how they are consumed. For example
+suppose you have a standalone dependency library that builds with
+build system X. In this case having Meson call the build system to
+build the dependency at build time would be interpreted as mixing
+build systems. On the other hand a "Flatpak-like" approach of building
+and installing the library with an external mechanism and consuming it
+via a standard build-system agnostic method such as Pkg-Config would
+not be considered build system mixing. Use of uninstalled-pkgconfig
+files is considered mixing, though.
+
+## What does this mean for support and compatibility?
+
+The Meson project will not take on any maintenance burden to ensure
+anything other than the simple builds setups as discussed above will
+work. Nor will we make changes to support these use cases that would
+worsen the user experience of users of plain Meson. This includes, but
+is not limited to, the following:
+
+- Any changes in other build systems that cause mixed project breakage
+  will not be considered a bug in Meson.
+
+- Breakages in mixed build projects will not be considered regressions
+  and such problems will never be considered release blockers,
+  regardless of what the underlying issue is.
+
+- Any use case that would require major changes in Meson to work
+  around missing or broken functionality in the other build system is
+  not supported. These issues must be fixed upstream.

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/Modules.md Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/Native-environments.md Added

@@ -0,0 +1,57 @@
+---
+short-description: Setting up native compilation
+...
+
+# Persistent native environments
+
+New in 0.49.0
+
+Meson has cross files for describing cross compilation
+environments(Cross-compilation.md), for describing native
+environments it has equivalent "native files".
+
+Natives describe the *build machine*, and can be used to override
+properties of non-cross builds, as well as properties that are marked
+as "native" in a cross build.
+
+There are a couple of reasons you might want to use a native file to
+keep a persistent environment:
+
+* To build with a non-default native tool chain (such as clang instead of gcc)
+* To use a non-default version of another binary, such as yacc, or llvm-config
+
+## Using a native file
+
+During the `setup` phase, use the native file as such:
+```sh
+meson setup --native-file my-native-file.ini builddir/
+```
+
+## Changing native file settings
+
+All of the rules about cross files and changed settings apply to native files
+as well, see here(Cross-compilation.md#changing-cross-file-settings)
+
+## Defining the environment
+
+See the config-files section(Machine-files.md), for options shared by cross
+and native files.
+
+## Native file locations
+
+Like cross files, native files may be installed to user or system wide
+locations, defined as:
+  - $XDG_DATA_DIRS/meson/native
+    (/usr/local/share/meson/native:/usr/share/meson/native if $XDG_DATA_DIRS is
+    undefined)
+  - $XDG_DATA_HOME/meson/native ($HOME/.local/share/meson/native if
+    $XDG_DATA_HOME is undefined)
+
+The order of locations tried is as follows:
+ - A file relative to the local dir
+ - The user local location
+ - The system wide locations in order
+
+These files are not intended to be shipped by distributions, unless
+they are specifically for distribution packaging, they are mainly
+intended for developers.

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/Overview.md Added

@@ -0,0 +1,58 @@
+---
+short-description: Overview of the Meson build system
+...
+
+# Overview
+
+Meson is a build system that is designed to be as user-friendly as
+possible without sacrificing performance. The main tool for this is a
+custom language that the user uses to describe the structure of his
+build. The main design goals of this language has been simplicity,
+clarity and conciseness. Much inspiration was drawn from the Python
+programming language, which is considered very readable, even to
+people who have not programmed in Python before.
+
+Another main idea has been to provide first class support for modern
+programming tools and best practices. These include features as varied
+as unit testing, code coverage reporting, precompiled headers and the
+like. All of these features should be immediately available to any
+project using Meson. The user should not need to hunt for third party
+macros or write shell scripts to get these features. They should just
+work out of the box.
+
+This power should not come at the expense of limited usability. Many
+software builds require unorthodox steps. A common example is that you
+first need to build a custom tool and then use that tool to generate
+more source code to build. This functionality needs to be supported
+and be as easy to use as other parts of the system.
+
+Terminology
+--
+
+Meson follows the overall structure of other popular build systems,
+such as CMake and GNU Autotools. This means that the build is divided
+into two discrete steps: *configure step* and *build step*. The first
+step inspects the system, checks for dependencies and does all other
+steps necessary to configure the build. It then generates the actual
+build system. The second step is simply executing this generated build
+system. The end result is a bunch of *build targets*, which are
+usually executables and shared and static libraries.
+
+The directory that contains the source code is called the *source
+directory*. Correspondingly the directory where the output is written
+is called the *build directory*. In other build systems it is common
+to have these two be the same directory. This is called an *in-source
+build*. The case where the build directory is separate is called an
+*out-of-source build*.
+
+What sets Meson apart from most build systems is that it enforces a
+separate build directory. All files created by the build system are
+put in the build directory. It is actually impossible to do an
+in-source build. For people used to building inside their source tree,
+this may seem like a needless complication. However there are several
+benefits to doing only out-of-source builds. These will be explained
+in the next chapter.
+
+When the source code is built, a set of *unit tests* is usually
+run. They ensure that the program is working as it should. If it does,
+the build result can be *installed* after which it is ready for use.

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/Performance-comparison.md Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/Pkg-config-files.md Added

@@ -0,0 +1,30 @@
+# Pkg config files
+
+Pkg-config(https://en.wikipedia.org/wiki/Pkg-config) is a way for
+shared libraries to declare the compiler flags needed to use them.
+There are two different ways of generating Pkg-config files in Meson.
+The first way is to build them manually with the `configure_file`
+command. The second way is to use Meson's built in Pkg-config file
+generator. The difference between the two is that the latter is very
+simple and meant for basic use cases. The former should be used when
+you need to provide a more customized solution.
+
+In this document we describe the simple generator approach. It is used in the following way.
+
+```meson
+pkg = import('pkgconfig')
+libs = ...     # the library/libraries users need to link against
+h = '.', ... # subdirectories of ${prefix}/${includedir} to add to header path
+pkg.generate(libraries : libs,
+             subdirs : h,
+             version : '1.0',
+             name : 'libsimple',
+             filebase : 'simple',
+             description : 'A simple demo library.')
+```
+
+This causes a file called `simple.pc` to be created and placed into
+the install directory during the install phase.
+
+More information on the pkg-config module and the parameters can be
+found on the pkgconfig-module(Pkgconfig-module.md) page.

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/Pkgconfig-module.md Added

@@ -0,0 +1,133 @@
+# Pkgconfig module
+
+This module is a simple generator for
+pkg-config(https://pkg-config.freedesktop.org/) files.
+
+## Usage
+
+```meson
+pkg = import('pkgconfig')
+bar_dep = dependency('bar')
+lib = library('foo', dependencies : bar)
+pkg.generate(lib)
+```
+
+### pkg.generate()
+
+The generated file's properties are specified with the following
+keyword arguments.
+
+- `description` a string describing the library, used to set the `Description:` field
+- `extra_cflags` a list of extra compiler flags to be added to the
+  `Cflags` field after the header search path
+- `filebase` the base name to use for the pkg-config file; as an
+  example, the value of `libfoo` would produce a pkg-config file called
+  `libfoo.pc`
+- `install_dir` the directory to install to, defaults to the value of
+  option `libdir` followed by `/pkgconfig`
+- `libraries` a list of built libraries (usually results of
+  shared_library) that the user needs to link against. Arbitrary strings can
+  also be provided and they will be added into the `Libs` field. Since 0.45.0
+  dependencies of built libraries will be automatically added, see the
+  Implicit dependencies(#implicit-dependencies) section below for the exact
+  rules. Since 0.58.0 custom_target() objects are supported as long as they are
+  linkable (has known extension such as `.a`, `.so`, etc).
+- `libraries_private` list of built libraries or strings to put in the
+  `Libs.private` field. Since 0.45.0 dependencies of built libraries will be
+  automatically added, see the Implicit dependencies(#implicit-dependencies)
+  section below for the exact rules. Since 0.58.0 custom_target() objects are
+  supported as long as they are linkable (has known extension such as `.a`,
+  `.so`, etc).
+- `name` the name of this library, used to set the `Name:` field
+- `subdirs` which subdirs of `include` should be added to the header
+  search path, for example if you install headers into
+  `${PREFIX}/include/foobar-1`, the correct value for this argument
+  would be `foobar-1`
+- `requires` list of strings, pkgconfig-dependencies or libraries that
+   `pkgconfig.generate()` was used on to put in the `Requires` field
+- `requires_private` the same as `requires` but for the `Requires.private` field
+- `url` a string with a url for the library
+- `variables` a list of strings with custom variables to add to the
+  generated file. The strings must be in the form `name=value` and may
+  reference other pkgconfig variables,
+  e.g. `datadir=${prefix}/share`. The names `prefix`, `libdir` and
+  `includedir` are reserved and may not be used. *Since 0.56.0* it can also be a
+  dictionary but ordering of Meson dictionaries are not guaranteed, which could
+  cause issues when some variables reference other variables.
+  Spaces in values are escaped with `\`, this is required in the case the value is
+  a path that and is used in `cflags` or `libs` arguments. *Since 0.59.0* if
+  escaping is not desired (e.g. space separate list of values) `unescaped_variables`
+  keyword argument should be used instead. *Since 0.62.0* builtin directory variables
+  that are referenced are automatically created by default.
+- `uninstalled_variables` used instead of the `variables` keyword argument, when
+  generating the uninstalled pkg-config file. Since *0.54.0*
+  Spaces in values are escaped with `\`, this is required in the case the value is
+  a path that and is used in `cflags` or `libs` arguments. *Since 0.59.0* if
+  escaping is not desired (e.g. space separate list of values)
+  `unescaped_uninstalled_variables` keyword argument should be used instead.
+- `version` a string describing the version of this library, used to set the
+  `Version:` field. (*since 0.46.0*) Defaults to the project version if unspecified.
+- `d_module_versions` a list of module version flags used when compiling
+   D sources referred to by this pkg-config file
+- `dataonly` field. (*since 0.54.0*) this is used for architecture-independent
+   pkg-config files in projects which also have architecture-dependent outputs.
+- `conflicts` (*since 0.36.0, incorrectly issued a warning prior to 0.54.0*) list of strings to be put in the `Conflicts` field.
+
+Since 0.46 a `StaticLibrary` or `SharedLibrary` object can optionally
+be passed as first positional argument. If one is provided a default
+value will be provided for all required fields of the pc file:
+- `install_dir` is set to `pkgconfig` folder in the same location than the provided library.
+- `description` is set to the project's name followed by the library's name.
+- `name` is set to the library's name.
+
+Since 0.54.0 uninstalled pkg-config files are generated as well. They
+are located in `<build dir>/meson-uninstalled/`. It is sometimes
+useful to build projects against libraries built by Meson without
+having to install them into a prefix. In order to do so, just set
+`PKG_CONFIG_PATH=<builddir>/meson-uninstalled` before building your
+application. That will cause pkg-config to prefer those
+`-uninstalled.pc` files and find libraries and headers from the Meson
+builddir. This is an experimental feature provided on a best-effort
+basis, it might not work in all use-cases.
+
+### Implicit dependencies
+
+The exact rules followed to find dependencies that are implicitly
+added into the pkg-config file have evolved over time. Here are the
+rules as of Meson *0.49.0*, previous versions might have slightly
+different behaviour.
+
+- Not found libraries or dependencies are ignored.
+- Libraries and dependencies are private by default (i.e. added into
+  `Requires.private:` or `Libs.private:`) unless they are explicitly added in
+  `libraries` or `requires` keyword arguments, or is the main library (first
+  positional argument).
+- Libraries and dependencies will be de-duplicated, if they are added in both
+  public and private (e.g `Requires:` and `Requires.private:`) it will be removed
+  from the private list.
+- Shared libraries (i.e. `shared_library()` and **NOT** `library()`) add only
+  `-lfoo` into `Libs:` or `Libs.private:` but their dependencies are not pulled.
+  This is because dependencies are only needed for static link.
+- Other libraries (i.e. `static_library()` or `library()`) add `-lfoo` into `Libs:`
+  or `Libs.private:` and recursively add their dependencies into `Libs.private:` or
+  `Requires.private:`.
+- Dependencies provided by pkg-config are added into `Requires:` or
+  `Requires.private:`. If a version was specified when declaring that dependency
+  it will be written into the generated file too.
+- The threads dependency (i.e. `dependency('threads')`) adds `-pthread` into
+  `Libs:` or `Libs.private:`.
+- Internal dependencies (i.e.
+  `declare_dependency(compiler_args : '-DFOO', link_args : '-Wl,something', link_with : foo)`)
+  add `compiler_args` into `Cflags:` if public, `link_args` and `link_with` into
+  `Libs:` if public or `Libs.private:` if private.
+- Other dependency types add their compiler arguments into `Cflags:` if public,
+  and linker arguments into `Libs:` if public or `Libs.private:` if private.
+- Once a pkg-config file is generated for a library using `pkg.generate(mylib)`,
+  any subsequent call to `pkg.generate()` where mylib appears, will generate a
+  `Requires:` or `Requires.private` instead of a `Libs:` or `Libs.private:`.
+
+### Relocatable pkg-config files
+
+By default, the files generated by `pkg.generate` contain a hardcoded prefix path.
+In order to make them relocatable, a `pkgconfig.relocatable` builtin option is provided.
+See Pkgconfig module options(Builtin-options.md#pkgconfig-module).

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/Playground.md Added

@@ -0,0 +1,35 @@
+# playground
+
+This page is *not* part of official documentation. It exists merely
+for testing new stuff for the wiki.
+
+## Ref manual reformat
+
+The current format is not very readable. We should have something more
+like what
+glib(https://developer.gnome.org/glib/stable/glib-Hash-Tables.html)
+or Python(https://docs.python.org/3/library/os.html) do.
+
+Here's a first proposal.
+
+    project(<project name>,
+            <languages to use, comma separated>,
+            version         : <project version>,
+            subproject_dir  : <alternative directory to store subprojects>,
+            meson_version   : <required version of Meson>,
+            license         : <string or array of licenses>,
+            default_options : <default values for project options>,
+
+Longer descriptions of arguments go here.
+
+Take two:
+
+## project
+
+    <project name>
+    <languages to use, comma separated>
+    version         : <project version>
+    subproject_dir  : <alternative directory to store subprojects>
+    meson_version   : <required version of Meson>
+    license         : <string or array of licenses>
+    default_options : <default values for project options>

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/Porting-from-autotools.md Added

@@ -0,0 +1,700 @@
+# Porting from Autotools
+
+This page uses
+AppStream-glib(https://github.com/hughsie/appstream-glib/) as an
+example project. AppStream-Glib contains some libraries, GObject
+Introspection data, tests, man pages, i18n, bash-completion with
+optional flags to build/not build support for some things.
+
+Meson comes with a helper script `ac_converter` that you can use to
+convert the basic autoconf checks for your project.
+
+## Configure.ac
+
+First let's look at `configure.ac` and write the same in
+`meson.build`.
+
+```autoconf
+AC_PREREQ(2.63)
+```
+Meson doesn't provide the same function, so just ignore this.
+
+### Defining variables
+`configure.ac`:
+```autoconf
+m4_define(as_major_version, 0)
+m4_define(as_minor_version, 3)
+m4_define(as_micro_version, 6)
+m4_define(as_version,
+          as_major_version.as_minor_version.as_micro_version)
+```
+`meson.build`:
+```meson
+
+as_version = meson.project_version() # set in project() below
+ver_arr = as_version.split('.')
+
+as_major_version = ver_arr0
+as_minor_version = ver_arr1
+as_micro_version = ver_arr2
+```
+
+### Initializing project and setting compilers
+`configure.ac`:
+```autoconf
+AC_INIT(appstream-glib,as_version)
+AC_PROG_CC
+```
+`meson.build`:
+```meson
+project('appstream-glib', 'c', version : '0.3.6')
+```
+Note that this must be the first line of your `meson.build` file.
+
+### AC_SUBST
+`configure.ac`:
+```autoconf
+AC_SUBST(AS_MAJOR_VERSION)
+AC_SUBST(AS_MINOR_VERSION)
+AC_SUBST(AS_MICRO_VERSION)
+AC_SUBST(AS_VERSION)
+```
+
+You don't need to do the same in Meson, because it does not have two
+different types of files (Makefile, configure).
+
+### Auto headers
+
+`configure.ac`:
+
+```autoconf
+AC_CONFIG_HEADERS(config.h)
+```
+
+`meson.build`:
+
+```meson
+conf = configuration_data()
+# Surround the version in quotes to make it a C string
+conf.set_quoted('VERSION', as_version)
+configure_file(output : 'config.h',
+               configuration : conf)
+```
+
+Meson doesn't support autoheaders, you need to manually specify what
+do you want to see in header file, write `configuration_data()` object
+and use `configure_file()`.
+
+You can also substitute variables of type `@SOME_VAR@` with configure
+data. The details are on the configuration page(Configuration.md).
+
+### Finding programs
+
+`configure.ac`:
+
+```autoconf
+AC_PATH_PROG(GPERF, gperf, no)
+if test x$GPERF != xno ; then
+        AC_DEFINE(HAVE_GPERF,1, Use gperf)
+fi
+AM_CONDITIONAL(HAVE_GPERF, test x$GPERF != xno)
+```
+
+`meson.build`:
+
+```meson
+gperf = find_program('gperf', required : false)
+if gperf.found()
+  conf.set('HAVE_GPERF', 1)
+endif
+```
+
+### Finding pkg-config modules
+
+`configure.ac`:
+
+```autoconf
+PKG_CHECK_MODULES(SOUP, libsoup-2.4 >= 2.24)
+```
+
+`meson.build`:
+
+```meson
+soup = dependency('libsoup-2.4', version : '>= 2.24')
+```
+
+### Arguments
+
+`configure.ac`:
+
+```autoconf
+AC_ARG_ENABLE(dep11, AS_HELP_STRING(--enable-dep11,enable DEP-11),
+              enable_dep11=$enableval,enable_dep11=yes)
+AM_CONDITIONAL(HAVE_DEP11, test x$enable_dep11 = xyes)
+if test x$enable_dep11 = xyes; then
+  AC_CHECK_HEADER(yaml.h, , AC_MSG_ERROR(No yaml.h))
+  YAML_LIBS="-lyaml"
+  AC_SUBST(YAML_LIBS)
+  AC_DEFINE(AS_BUILD_DEP11,1,Build DEP-11 code)
+fi
+```
+
+`meson.build`:
+
+```meson
+if get_option('enable-dep11')
+  yaml = dependency('yaml-0.1')
+  conf.set('AS_BUILD_DEP11', 1)
+else
+  yaml = dependency('yaml-0.1', required : false)
+endif
+```
+
+`meson_options.txt`:
+
+```meson
+option('enable-dep11', type : 'boolean', value : true, description : 'enable DEP-11')
+```
+
+## Makefile.am
+
+Next step is `Makefile.am`. In Meson you don't need to have other
+file, you still use `meson.build`.
+
+### Sub directories
+
+`Makefile.am`:
+
+```make
+SUBDIRS =                                         \
+        libappstream-glib
+```
+
+`meson.build`:
+
+```meson
+subdir('libappstream-glib')
+```
+
+### *CLEANFILES, EXTRA_DIST, etc.
+
+`Makefile.am`:
+
+```make
+DISTCLEANFILES =                                        \
+        appstream-glib-*.tar.xz
+
+MAINTAINERCLEANFILES =                                  \
+        *~                                              \
+        ABOUT-NLS                                       \
+        aclocal.m4                                      \
+        ChangeLog                                       \
+        compile                                         \
+        config.guess                                    \
+        config.h.*                                      \
+        config.rpath
+
+EXTRA_DIST =                                            \
+        COPYING                                         \
+        MAINTAINERS                                     \
+        AUTHORS                                         \
+        README.md                                       \
+        NEWS                                            \
+        autogen.sh                                      \
+        config.h
+```
+
+In Meson you don't need have `*CLEANFILES`, because in Meson you are
+building in temporary directory (usually called `build`), you manually
+removing it. You also not need to use `EXTRA_DIST`, because you will
+make tarballs via `git archive` or something like this.
+
+### glib-compile-resources
+
+`Makefile.am`:
+```make
+as-resources.c: appstream-glib.gresource.xml                    \
+                as-stock-icons.txt                              \
+                as-license-ids.txt                              \
+                as-blacklist-ids.txt                            \
+                as-category-ids.txt                             \
+                as-environment-ids.txt
+        $(AM_V_GEN)                                             \
+        glib-compile-resources                                  \
+                --sourcedir=$(srcdir)                           \
+                --sourcedir=$(top_builddir)/data                \
+                --target=$@                                     \
+                --generate-source                               \
+                --c-name as                                     \
+                $(srcdir)/appstream-glib.gresource.xml
+as-resources.h: appstream-glib.gresource.xml                    \
+                as-stock-icons.txt                              \
+                as-license-ids.txt                              \
+                as-blacklist-ids.txt                            \
+                as-category-ids.txt                             \
+                as-environment-ids.txt
+        $(AM_V_GEN)                                             \
+        glib-compile-resources                                  \
+                --sourcedir=$(srcdir)                           \
+                --sourcedir=$(top_builddir)/data                \
+                --target=$@                                     \
+                --generate-header                               \
+                --c-name as                                     \
+                $(srcdir)/appstream-glib.gresource.xml
+
+BUILT_SOURCES =                                                 \
+        as-resources.c                                          \
+        as-resources.h
+```
+
+`meson.build`:
+
+```meson
+asresources = gnome.compile_resources(
+  'as-resources', 'appstream-glib.gresource.xml',
+  source_dir : '.',
+  c_name : 'as')
+```
+
+### Headers
+
+`Makefile.am`:
+
+```make
+libappstream_glib_includedir = $(includedir)/libappstream-glib
+libappstream_glib_include_HEADERS =                             \
+        appstream-glib.h                                        \
+        as-app.h                                                \
+        as-bundle.h                                             \
+        as-enums.h                                              \
+        as-icon.h                                               \
+        as-image.h                                              \
+        as-inf.h                                                \
+        as-node.h                                               \
+        as-problem.h                                            \
+        as-provide.h                                            \
+        as-release.h                                            \
+        as-screenshot.h                                         \
+        as-store.h                                              \
+        as-tag.h                                                \
+        as-utils.h                                              \
+        as-version.h
+```
+
+`meson.build`:
+
+```meson
+headers = 
+  'appstream-glib.h',
+  'as-app.h',
+  'as-bundle.h',
+  'as-enums.h',
+  'as-icon.h',
+  'as-image.h',
+  'as-inf.h',
+  'as-node.h',
+  'as-problem.h',
+  'as-provide.h',
+  'as-release.h',
+  'as-screenshot.h',
+  'as-store.h',
+  'as-tag.h',
+  'as-utils.h',
+  'as-version.h'
+install_headers(headers, subdir : 'libappstream-glib')
+```
+
+### Libraries
+
+`Makefile.am`:
+```make
+lib_LTLIBRARIES =                                               \
+        libappstream-glib.la
+libappstream_glib_la_SOURCES =                                  \
+        as-app.c                                                \
+        as-app-desktop.c                                        \
+        as-app-inf.c                                            \
+        as-app-private.h                                        \
+        as-app-validate.c                                       \
+        as-bundle.c                                             \
+        as-bundle-private.h                                     \
+        as-cleanup.h                                            \
+        as-enums.c                                              \
+        as-icon.c                                               \
+        as-icon-private.h                                       \
+        as-image.c                                              \
+        as-image-private.h                                      \
+        as-inf.c                                                \
+        as-inf.h                                                \
+        as-node.c                                               \
+        as-node-private.h                                       \
+        as-problem.c                                            \
+        as-problem.h                                            \
+        as-provide.c                                            \
+        as-provide-private.h                                    \
+        as-release.c                                            \
+        as-release-private.h                                    \
+        as-resources.c                                          \
+        as-resources.h                                          \
+        as-screenshot.c                                         \
+        as-screenshot-private.h                                 \
+        as-store.c                                              \
+        as-tag.c                                                \
+        as-utils.c                                              \
+        as-utils-private.h                                      \
+        as-version.h                                            \
+        as-yaml.c                                               \
+        as-yaml.h
+
+libappstream_glib_la_LIBADD =                                   \
+        $(GLIB_LIBS)                                            \
+        $(GDKPIXBUF_LIBS)                                       \
+        $(LIBARCHIVE_LIBS)                                      \
+        $(SOUP_LIBS)                                            \
+        $(YAML_LIBS)
+
+libappstream_glib_la_LDFLAGS =                                  \
+        -version-info $(LT_CURRENT):$(LT_REVISION):$(LT_AGE)    \
+        -export-dynamic                                         \
+        -no-undefined                                           \
+        -export-symbols-regex '^as_.*'
+```
+
+`meson.build`:
+
+```meson
+sources = 
+  'as-app.c',
+  'as-app-desktop.c',
+  'as-app-inf.c',
+  'as-app-private.h',
+  'as-app-validate.c',
+  'as-bundle.c',
+  'as-bundle-private.h',
+  'as-cleanup.h',
+  'as-enums.c',
+  'as-icon.c',
+  'as-icon-private.h',
+  'as-image.c',
+  'as-image-private.h',
+  'as-inf.c',
+  'as-inf.h',
+  'as-node.c',
+  'as-node-private.h',
+  'as-problem.c',
+  'as-problem.h',
+  'as-provide.c',
+  'as-provide-private.h',
+  'as-release.c',
+  'as-release-private.h',
+  asresources,
+  'as-screenshot.c',
+  'as-screenshot-private.h',
+  'as-store.c',
+  'as-tag.c',
+  'as-utils.c',
+  'as-utils-private.h',
+  'as-version.h',
+  'as-yaml.c',
+  'as-yaml.h'
+
+deps = glib, gdkpixbuf, libarchive, soup, yaml
+
+mapfile = 'appstream-glib.map'
+vflag = '-Wl,--version-script,@0@/@1@'.format(meson.current_source_dir(), mapfile)
+asglib = shared_library(
+  'appstream-glib', sources,
+  soversion : lt_current,
+  version : lt_version,
+  dependencies : deps,
+  include_directories : include_directories('@0@/..'.format(meson.current_build_dir())),
+  link_args : '-Wl,--no-undefined', vflag,
+  link_depends : mapfile,
+  install : true)
+```
+
+`appstream-glib.map`:
+
+```
+{
+global:
+    as_*;
+local:
+    *;
+};
+```
+
+### Custom targets
+
+`Makefile.am`:
+
+```make
+if HAVE_GPERF
+as-tag-private.h: as-tag.gperf
+        $(AM_V_GEN) gperf < $< > $@
+
+libappstream_glib_la_SOURCES += as-tag-private.h
+BUILT_SOURCES += as-tag-private.h
+endif
+```
+
+`meson.build`:
+
+```meson
+if gperf.found()
+  astagpriv = custom_target('gperf as-tag',
+                            output : 'as-tag-private.h',
+                            input : 'as-tag.gperf',
+                            command : gperf, '@INPUT@', '--output-file', '@OUTPUT@')
+  sources = sources + astagpriv
+endif
+```
+
+### Global CFLAGS
+
+`Makefile.am`:
+
+```make
+AM_CPPFLAGS =                                                   \
+        -DAS_COMPILATION                                        \
+        -DLOCALSTATEDIR=\""$(localstatedir)"\"                  \
+        -DG_LOG_DOMAIN=\"As\"
+```
+
+`meson.build`:
+
+```meson
+add_project_arguments('-DG_LOG_DOMAIN="As"', language : 'c')
+add_project_arguments('-DAS_COMPILATION', language : 'c')
+add_project_arguments('-DLOCALSTATEDIR="/var"', language : 'c')
+```
+
+### Tests
+
+`Makefile.am`:
+
+```make
+check_PROGRAMS =                                                \
+        as-self-test
+as_self_test_SOURCES =                                          \
+        as-self-test.c
+as_self_test_LDADD =                                            \
+        $(GLIB_LIBS)                                            \
+        $(GDKPIXBUF_LIBS)                                       \
+        $(LIBARCHIVE_LIBS)                                      \
+        $(SOUP_LIBS)                                            \
+        $(YAML_LIBS)                                            \
+        $(lib_LTLIBRARIES)
+as_self_test_CFLAGS = -DTESTDATADIR=\""$(top_srcdir)/data/tests"\"
+
+TESTS = as-self-test
+```
+
+`meson.build`:
+
+```meson
+selftest = executable(
+  'as-self-test', 'as-self-test.c',
+  include_directories : include_directories('@0@/..'.format(meson.current_build_dir())),
+  dependencies : deps,
+  c_args : '-DTESTDATADIR="@0@/../data/tests"'.format(meson.current_source_dir()),
+  link_with : asglib)
+test('as-self-test', selftest)
+```
+
+### GObject Introspection
+
+`Makefile.am`:
+
+```make
+introspection_sources =                                         \
+        as-app.c                                                \
+        as-app-validate.c                                       \
+        as-app.h                                                \
+        as-bundle.c                                             \
+        as-bundle.h                                             \
+        as-enums.c                                              \
+        as-enums.h                                              \
+        as-icon.c                                               \
+        as-icon.h                                               \
+        as-image.c                                              \
+        as-image.h                                              \
+        as-inf.c                                                \
+        as-inf.h                                                \
+        as-node.c                                               \
+        as-node.h                                               \
+        as-problem.c                                            \
+        as-problem.h                                            \
+        as-provide.c                                            \
+        as-provide.h                                            \
+        as-release.c                                            \
+        as-release.h                                            \
+        as-screenshot.c                                         \
+        as-screenshot.h                                         \
+        as-store.c                                              \
+        as-store.h                                              \
+        as-tag.c                                                \
+        as-tag.h                                                \
+        as-utils.c                                              \
+        as-utils.h                                              \
+        as-version.h
+
+AppStreamGlib-1.0.gir: libappstream-glib.la
+AppStreamGlib_1_0_gir_INCLUDES = GObject-2.0 Gio-2.0 GdkPixbuf-2.0
+AppStreamGlib_1_0_gir_CFLAGS = $(AM_CPPFLAGS)
+AppStreamGlib_1_0_gir_SCANNERFLAGS = --identifier-prefix=As \
+                                --symbol-prefix=as_ \
+                                --warn-all \
+                                --add-include-path=$(srcdir)
+AppStreamGlib_1_0_gir_EXPORT_PACKAGES = appstream-glib
+AppStreamGlib_1_0_gir_LIBS = libappstream-glib.la
+AppStreamGlib_1_0_gir_FILES = $(introspection_sources)
+INTROSPECTION_GIRS += AppStreamGlib-1.0.gir
+
+girdir = $(datadir)/gir-1.0
+gir_DATA = $(INTROSPECTION_GIRS)
+
+typelibdir = $(libdir)/girepository-1.0
+typelib_DATA = $(INTROSPECTION_GIRS:.gir=.typelib)
+
+CLEANFILES += $(gir_DATA) $(typelib_DATA)
+```
+
+`meson.build`:
+
+```meson
+introspection_sources = 
+  'as-app.c',
+  'as-app-validate.c',
+  'as-app.h',
+  'as-bundle.c',
+  'as-bundle.h',
+  'as-enums.c',
+  'as-enums.h',
+  'as-icon.c',
+  'as-icon.h',
+  'as-image.c',
+  'as-image.h',
+  'as-inf.c',
+  'as-inf.h',
+  'as-node.c',
+  'as-node.h',
+  'as-problem.c',
+  'as-problem.h',
+  'as-provide.c',
+  'as-provide.h',
+  'as-release.c',
+  'as-release.h',
+  'as-screenshot.c',
+  'as-screenshot.h',
+  'as-store.c',
+  'as-store.h',
+  'as-tag.c',
+  'as-tag.h',
+  'as-utils.c',
+  'as-utils.h',
+  'as-version.h'
+
+gnome.generate_gir(asglib,
+  sources : introspection_sources,
+  nsversion : '1.0',
+  namespace : 'AppStreamGlib',
+  symbol_prefix : 'as_',
+  identifier_prefix : 'As',
+  export_packages : 'appstream-glib',
+  includes : 'GObject-2.0', 'Gio-2.0', 'GdkPixbuf-2.0',
+  install : true
+)
+```
+
+### GSettings
+
+`configure.ac`:
+```sh
+GLIB_GSETTINGS
+```
+
+`Makefile.am`:
+```make
+gsettings_SCHEMAS = foo.gschema.xml
+@GSETTINGS_RULES@
+```
+
+`meson.build`:
+```meson
+install_data('foo.gschema.xml', install_dir: get_option('datadir') / 'glib-2.0' / 'schemas')
+meson.add_install_script('meson_post_install.py')
+```
+
+`meson_post_install.py`:
+```python
+#!/usr/bin/env python3
+
+import os
+import subprocess
+
+schemadir = os.path.join(os.environ'MESON_INSTALL_PREFIX', 'share', 'glib-2.0', 'schemas')
+
+if not os.environ.get('DESTDIR'):
+    print('Compiling gsettings schemas...')
+    subprocess.call('glib-compile-schemas', schemadir)
+```
+
+### gettext
+
+Note this example does not include `intltool` usage.
+
+`configure.ac`:
+```m4
+AM_GNU_GETTEXT(external)
+AM_GNU_GETTEXT_VERSION(0.19.7)
+
+GETTEXT_PACKAGE=foo
+AC_SUBST(GETTEXT_PACKAGE)
+AC_DEFINE_UNQUOTED(GETTEXT_PACKAGE, "$GETTEXT_PACKAGE", The prefix for our gettext translation domains.)
+```
+
+`po/Makevars`:
+```make
+XGETTEXT_OPTIONS =  --from-code=UTF-8 --keyword=_ --keyword=N_ --keyword=C_:1c,2 --keyword=NC_:1c,2 --keyword=g_dngettext:2,3 --add-comments
+```
+
+`Makefile.am`:
+```make
+%.desktop: %.desktop.in
+    $(AM_V_GEN)$(MSGFMT) --desktop --template $< -d $(top_srcdir)/po -o $@
+
+%.appdata.xml: %.appdata.xml.in
+    $(AM_V_GEN)$(MSGFMT) --xml --template $< -d $(top_srcdir)/po -o $@
+```
+
+`meson.build`:
+```meson
+i18n = import('i18n')
+
+gettext_package = 'foo'
+add_project_arguments('-DGETTEXT_PACKAGE=' + gettext_package, language: 'c')
+subdir('po')
+
+i18n.merge_file(
+  input: 'foo.desktop.in',
+  output: 'foo.desktop',
+  type: 'desktop',
+  po_dir: 'po',
+  install: true,
+  install_dir: get_option('datadir') / 'applications'
+)
+
+i18n.merge_file(
+  input: 'foo.appdata.xml.in',
+  output: 'foo.appdata.xml',
+  po_dir: 'po',
+  install: true,
+  install_dir: get_option('datadir') / 'appdata'
+)
+```
+
+`po/meson.build`:
+```meson
+i18n.gettext(gettext_package, preset: 'glib')
+```

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/Precompiled-headers.md Added

@@ -0,0 +1,119 @@
+---
+short-description: Using precompiled headers to reduce compilation time
+...
+
+# Precompiled headers
+
+Parsing header files of system libraries is surprisingly expensive. A
+typical source file has less than one thousand lines of code. In
+contrast the headers of large libraries can be tens of thousands of
+lines. This is especially problematic with C++, where header-only
+libraries are common and they may contain extremely complex code. This
+makes them slow to compile.
+
+Precompiled headers are a tool to mitigate this issue. Basically what
+they do is parse the headers and then serialize the compiler's
+internal state to disk. The downside of precompiled headers is that
+they are tricky to set up. Meson has native support for precompiled
+headers, but using them takes a little work.
+
+A precompiled header file is relatively simple. It is a header file
+that contains `#include` directives for the system headers to
+precompile. Here is a C++ example.
+
+```cpp
+    #include<vector>
+    #include<string>
+    #include<map>
+```
+
+In Meson, precompiled header files are always per-target. That is, the
+given precompiled header is used when compiling every single file in
+the target. Due to limitations of the underlying compilers, this
+header file must not be in the same subdirectory as any of the source
+files. It is strongly recommended that you create a subdirectory
+called `pch` in the target directory and put the header files (and
+nothing else) there.
+
+Toggling the usage of precompiled headers
+--
+
+If you wish to compile your project without precompiled headers, you
+can change the value of the pch option by passing `-Db_pch=false`
+argument to Meson at configure time or later with `meson configure`.
+You can also toggle the use of pch in a configured build directory
+with the GUI tool. You don't have to do any changes to the source
+code. Typically this is done to test whether your project compiles
+cleanly without pch (that is, checking that its #includes are in
+order) and working around compiler bugs.
+
+Using precompiled headers with GCC and derivatives
+--
+
+Once you have a file to precompile, you can enable the use of pch for
+a given target with a *pch* keyword argument. As an example, let's
+assume you want to build a small C binary with precompiled headers.
+Let's say the source files of the binary use the system headers
+`stdio.h` and `string.h`. Then you create a header file
+`pch/myexe_pch.h` with this content:
+
+```c
+#include <stdio.h>
+#include <string.h>
+```
+
+And add this to Meson:
+
+```meson
+executable('myexe', sources : sourcelist, c_pch : 'pch/myexe_pch.h')
+```
+
+That's all. You should note that your source files must _not_ include
+the file `myexe_pch.h` and you must _not_ add the pch subdirectory to
+your search path. Any modification of the original program files is
+not necessary. Meson will make the compiler include the pch with
+compiler options. If you want to disable pch (because of, say,
+compiler bugs), it can be done entirely on the build system side with
+no changes to source code.
+
+You can use precompiled headers on any build target. If your target
+has multiple languages, you can specify multiple pch files like this.
+
+```meson
+executable('multilang', sources : srclist,
+           c_pch : 'pch/c_pch.h', cpp_pch : 'pch/cpp_pch.h')
+```
+
+Using precompiled headers with MSVC
+--
+Since Meson version 0.50.0, precompiled headers with MSVC work just like
+with GCC. Meson will automatically create the matching pch implementation
+file for you.
+
+Before version 0.50.0, in addition to the header file, Meson
+also requires a corresponding source file. If your header is called
+`foo_pch.h`, the corresponding source file is usually called
+`foo_pch.cpp` and it resides in the same `pch` subdirectory as the
+header. Its contents are this:
+
+```cpp
+#if !defined(_MSC_VER)
+#error "This file is only for use with MSVC."
+#endif
+
+#include "foo_pch.h"
+```
+
+To enable pch, simply list both files in the target definition:
+
+```meson
+executable('myexe', sources : srclist,
+           cpp_pch : 'pch/foo_pch.h', 'pch/foo_pch.cpp')
+```
+
+This form will work with both GCC and msvc, because Meson knows that
+GCC does not need a `.cpp` file and thus just ignores it.
+
+It should be noted that due to implementation details of the MSVC
+compiler, having precompiled headers for multiple languages in the
+same target is not guaranteed to work.

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/Project-templates.md Added

@@ -0,0 +1,49 @@
+---
+short-description: Project templates
+...
+
+# Project templates
+
+To make it easier for new developers to start working, Meson ships a
+tool to generate the basic setup of different kinds of projects. This
+functionality can be accessed with the `meson init` command. A typical
+project setup would go like this:
+
+```console
+$ mkdir project_name
+$ cd project_name
+$ meson init --language=c --name=myproject --version=0.1
+```
+
+This would create the build definitions for a helloworld type
+project. The result can be compiled as usual. For example it
+could be done like this:
+
+```
+$ meson setup builddir
+$ meson compile -C builddir
+```
+
+The generator has many different projects and settings. They can all
+be listed by invoking the command `meson init --help`.
+
+This feature is available since Meson version 0.45.0.
+
+# Generate a build script for an existing project
+
+With `meson init` you can generate a build script for an existing
+project with existing project files by running the command in the
+root directory of your project. Meson currently supports this
+feature for `executable`, and `jar` projects.
+
+# Build after generation of template
+
+It is possible to have Meson generate a build directory from the
+`meson init` command without running `meson setup`. This is done
+by passing `-b` or `--build` switch.
+
+```console
+$ mkdir project_name
+$ cd project_name
+$ meson init --language=c --name=myproject --version=0.1 --build
+```
\ No newline at end of file

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/Python-3-module.md Added

@@ -0,0 +1,57 @@
+# Python 3 module
+
+This module provides support for dealing with Python 3. It has the
+following methods.
+
+This module is deprecated and replaced by the
+python(Python-module.md) module.
+
+## find_python
+
+This is a cross platform way of finding the Python 3 executable, which
+may have a different name on different operating systems. Returns an
+@external_program
+object.
+
+*Added 0.38.0*
+
+Deprecated, replaced by
+`find_installation`(Python-module.md#find_installation) function
+from `python` module.
+
+## extension_module
+
+Creates a `shared_module` target that is named according to the naming
+conventions of the target platform. All positional and keyword
+arguments are the same as for
+shared_module.
+
+`extension_module` does not add any dependencies to the library so user may
+need to add `dependencies : dependency('python3')`, see
+Python3 dependency(Dependencies.md#python3).
+
+*Added 0.38.0*
+
+Deprecated, replaced by
+`extension_module`(Python-module.md#extension_module) method from
+`python` module.
+
+## language_version
+
+Returns a string with the Python language version such as `3.5`.
+
+*Added 0.40.0*
+
+Deprecated, replaced by
+`language_version`(Python-module.md#language_version) method from
+`python` module.
+
+## sysconfig_path
+
+Returns the Python sysconfig path without prefix, such as
+`lib/python3.6/site-packages`.
+
+*Added 0.40.0*
+
+Deprecated, replaced by `get_path`(Python-module.md#get_path)
+method from `python` module.

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/Python-module.md Added

@@ -0,0 +1,265 @@
+---
+short-description: Generic python module
+authors:
+    - name: Mathieu Duponchelle
+      email: mathieu@centricular.com
+      years: 2018
+      has-copyright: false
+...
+
+# Python module
+
+This module provides support for finding and building extensions against
+python installations, be they python 2 or 3.
+
+*Added 0.46.0*
+
+## Functions
+
+### `find_installation()`
+
+``` meson
+pymod.find_installation(name_or_path, ...)
+```
+
+Find a python installation matching `name_or_path`.
+
+That argument is optional, if not provided then the returned python
+installation will be the one used to run Meson.
+
+If provided, it can be:
+
+- A simple name, eg `python-2.7`, Meson will look for an external program
+  named that way, using find_program
+
+- A path, eg `/usr/local/bin/python3.4m`
+
+- One of `python2` or `python3`: in either case, the module will try
+  some alternative names: `py -2` or `py -3` on Windows, and `python`
+  everywhere. In the latter case, it will check whether the version
+  provided by the sysconfig module matches the required major version
+
+Keyword arguments are the following:
+
+- `required`: by default, `required` is set to `true` and Meson will
+  abort if no python installation can be found. If `required` is set to `false`,
+  Meson will continue even if no python installation was found. You can
+  then use the `.found()` method on the returned object to check
+  whether it was found or not. Since *0.48.0*  the value of a
+  `feature`(Build-options.md#features) option can also be passed to the
+  `required` keyword argument.
+- `disabler`: if `true` and no python installation can be found, return a
+  @disabler object instead of a not-found object.
+  *Since 0.49.0*
+- `modules`: a list of module names that this python installation must have.
+  *Since 0.51.0*
+- `pure`: On some platforms, architecture independent files are
+  expected to be placed in a separate directory. However, if the
+  python sources should be installed alongside an extension module
+  built with this module, this keyword argument can be used to
+  override the default behavior of `.install_sources()`.
+  *since 0.64.0*
+
+**Returns**: a python installation`python_installation` object
+
+## `python_installation` object
+
+The `python_installation` object is an @external_program, with several
+added methods.
+
+### Methods
+
+#### `path()`
+
+```meson
+str py_installation.path()
+```
+
+*Added 0.50.0*
+
+Works like the path method of other `ExternalProgram` objects. Was not
+provided prior to 0.50.0 due to a bug.
+
+#### `extension_module()`
+
+``` meson
+shared_module py_installation.extension_module(module_name, list_of_sources, ...)
+```
+
+Create a shared_module target that is named according to the naming
+conventions of the target platform.
+
+All positional and keyword arguments are the same as for
+shared_module, excluding `name_suffix` and `name_prefix`, and with
+the addition of the following:
+
+- `subdir`: By default, Meson will install the extension module in
+  the relevant top-level location for the python installation, eg
+  `/usr/lib/site-packages`. When subdir is passed to this method,
+  it will be appended to that location. This keyword argument is
+  mutually exclusive with `install_dir`
+
+Additionally, the following diverge from shared_module's default behavior:
+
+- `gnu_symbol_visibility`: if unset, it will default to `'hidden'` on versions
+  of Python that support this (the python headers define `PyMODINIT_FUNC` has
+  default visibility).
+
+*since 0.63.0* `extension_module` automatically adds a dependency to the library
+if one is not explicitly provided. To support older versions, the user may need to
+add `dependencies : py_installation.dependency()`, see dependency.
+
+**Returns**: a @build_tgt object
+
+#### `dependency()`
+
+``` meson
+python_dependency py_installation.dependency(...)
+```
+
+*since 0.53.0*
+
+This method accepts no positional arguments, and the same keyword
+arguments as the standard dependency function. It also supports the
+following keyword argument:
+
+- `embed`: *(since 0.53.0)* If true, Meson will try to find a python
+  dependency that can be used for embedding python into an
+  application.
+- `disabler` *(since 0.60.0)*: if `true` and the dependency couldn't be found,
+  returns a disabler object(#disabler-object) instead of a not-found dependency.
+
+**Returns**: a python dependency`python_dependency` object
+
+#### `install_sources()`
+
+``` meson
+void py_installation.install_sources(list_of_files, ...)
+```
+
+Install actual python sources (`.py`).
+
+All positional and keyword arguments are the same as for
+install_data, with the addition of the following:
+
+*Since 0.60.0* `python.platlibdir` and `python.purelibdir` options can be used
+to control the default installation path. See Python module options(Builtin-options.md#python-module).
+
+- `pure`: On some platforms, architecture independent files are
+  expected to be placed in a separate directory. However, if the
+  python sources should be installed alongside an extension module
+  built with this module, this keyword argument can be used to
+  override that behaviour. Defaults to the value specified in
+  `find_installation()`, or else `true`
+
+- `subdir`: See documentation for the argument of the same name to
+  `extension_module()`
+
+- `install_tag` *(since 0.60.0)*: A string used by `meson install --tags` command
+  to install only a subset of the files. By default it has the tag `python-runtime`.
+
+#### `get_install_dir()`
+
+``` meson
+string py_installation.get_install_dir(...)
+```
+
+Retrieve the directory `install_sources()` will install to.
+
+It can be useful in cases where `install_sources` cannot be used
+directly, for example when using configure_file.
+
+This function accepts no arguments, its keyword arguments are the same
+as `install_sources()`.
+
+*Since 0.60.0* `python.platlibdir` and `python.purelibdir` options can be used
+to control the default installation path. See Python module options(Builtin-options.md#python-module).
+
+**Returns**: A string
+
+#### `language_version()`
+
+``` meson
+string py_installation.language_version()
+```
+
+Get the major.minor python version, eg `2.7`.
+
+The version is obtained through the `sysconfig` module.
+
+This function expects no arguments or keyword arguments.
+
+**Returns**: A string
+
+#### `get_path()`
+
+``` meson
+string py_installation.get_path(path_name, fallback)
+```
+
+Get a path as defined by the `sysconfig` module.
+
+For example:
+
+``` meson
+purelib = py_installation.get_path('purelib')
+```
+
+This function requires at least one argument, `path_name`,
+which is expected to be a non-empty string.
+
+If `fallback` is specified, it will be returned if no path
+with the given name exists. Otherwise, attempting to read
+a non-existing path will cause a fatal error.
+
+**Returns**: A string
+
+#### `has_path()`
+
+``` meson
+    bool py_installation.has_path(path_name)
+```
+
+**Returns**: true if a path named `path_name` can be retrieved with
+`get_path()`, false otherwise.
+
+#### `get_variable()`
+
+``` meson
+string py_installation.get_variable(variable_name, fallback)
+```
+
+Get a variable as defined by the `sysconfig` module.
+
+For example:
+
+``` meson
+py_bindir = py_installation.get_variable('BINDIR', '')
+```
+
+This function requires at least one argument, `variable_name`,
+which is expected to be a non-empty string.
+
+If `fallback` is specified, it will be returned if no variable
+with the given name exists. Otherwise, attempting to read
+a non-existing variable will cause a fatal error.
+
+**Returns**: A string
+
+#### `has_variable()`
+
+``` meson
+    bool py_installation.has_variable(variable_name)
+```
+
+**Returns**: true if a variable named `variable_name` can be retrieved
+with `get_variable()`, false otherwise.
+
+## `python_dependency` object
+
+This @dep object subclass will try various methods to obtain
+the compiler and linker arguments, starting with pkg-config then
+potentially using information obtained from python's `sysconfig`
+module.
+
+It exposes the same methods as its parent class.

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/Qt4-module.md Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/Qt5-module.md Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/Qt6-module.md Added

@@ -0,0 +1,179 @@
+# Qt6 module
+
+*New in Meson 0.57.0*
+
+The Qt6 module provides tools to automatically deal with the various
+tools and steps required for Qt.
+
+## compile_resources
+
+*New in 0.59.0*
+
+Compiles Qt's resources collection files (.qrc) into c++ files for compilation.
+
+It takes no positional arguments, and the following keyword arguments:
+  - `name` (string | empty): if provided a single .cpp file will be generated,
+    and the output of all qrc files will be combined in this file, otherwise
+    each qrc file be written to it's own cpp file.
+  - `sources` (File | string | custom_target | custom_target index | generator_output):
+    A list of sources to be transpiled. Required, must have at least one source<br/>
+    *New in 0.60.0*: support for custom_target, custom_target_index, and generator_output.
+  - `extra_args` string: Extra arguments to pass directly to `qt-rcc`
+  - `method` string: The method to use to detect qt, see dependency
+
+## compile_ui
+
+*New in 0.59.0*
+
+Compiles Qt's ui files (.ui) into header files.
+
+It takes no positional arguments, and the following keyword arguments:
+  - `sources` (File | string | custom_target | custom_target index | generator_output):
+    A list of sources to be transpiled. Required, must have at least one source<br/>
+    *New in 0.60.0*: support for custom_target, custom_target_index, and generator_output.
+  - `extra_args` string: Extra arguments to pass directly to `qt-uic`
+  - `method` string: The method to use to detect qt, see dependency
+
+## compile_moc
+
+*New in 0.59.0*
+
+Compiles Qt's moc files (.moc) into header and/or source files. At least one of
+the keyword arguments `headers` and `sources` must be provided.
+
+It takes no positional arguments, and the following keyword arguments:
+  - `sources` (File | string | custom_target | custom_target index | generator_output):
+    A list of sources to be transpiled into .moc files for manual inclusion.<br/>
+    *New in 0.60.0*: support for custom_target, custom_target_index, and generator_output.
+  - `headers` (File | string | custom_target | custom_target index | generator_output):
+     A list of headers to be transpiled into .cpp files<br/>
+    *New in 0.60.0*: support for custom_target, custom_target_index, and generator_output.
+  - `extra_args` string: Extra arguments to pass directly to `qt-moc`
+  - `method` string: The method to use to detect qt, see dependency
+  - `dependencies`: dependency objects whose include directories are used by moc.
+  - `include_directories` (string | IncludeDirectory): A list of `include_directory()`
+    objects used when transpiling the .moc files
+
+## preprocess
+
+Consider using `compile_resources`, `compile_ui`, and `compile_moc` instead.
+
+Takes sources for moc, uic, and rcc, and converts them into c++ files for
+compilation.
+
+Has the following signature: `qt.preprocess(name: str | None, *sources: str)`
+
+If the `name` parameter is passed then all of the rcc files will be written to
+a single output file
+
+*Deprecated in 0.59.0*: Files given in the variadic `sources` arguments as well
+as the `sources` keyword argument, were passed unmodified through the preprocessor
+programs. Don't do this - just add the output of `preprocess()` to another sources
+list:
+```meson
+sources = files('a.cpp', 'main.cpp', 'bar.c')
+sources += qt.preprocess(qresources : 'resources')
+```
+
+This method takes the following keyword arguments:
+ - `qresources` (string | File): Passed to the RCC compiler
+ - `ui_files`: (string | File | CustomTarget): Passed the `uic` compiler
+ - `moc_sources`: (string | File | CustomTarget): Passed the `moc` compiler.
+   These are converted into .moc files meant to be `#include`ed
+ - `moc_headers`: (string | File | CustomTarget): Passied the `moc` compiler.
+   These will be converted into .cpp files
+ - `include_directories` (IncludeDirectories | string), the directories to add
+   to header search path for `moc`
+ - `moc_extra_arguments` string: any additional arguments to `moc`.
+ - `uic_extra_arguments` string: any additional arguments to `uic`.
+ - `rcc_extra_arguments` string: any additional arguments to `rcc`.
+ - `dependencies` Dependency: dependency objects needed by moc.
+ - *Deprecated in 0.59.0.*: `sources`: a list of extra sources, which are added
+   to the output unchanged.
+
+It returns an array of targets and sources to pass to a compilation target.
+
+## compile_translations
+
+This method generates the necessary targets to build translation files with
+lrelease, it takes no positional arguments, and the following keyword arguments:
+
+ - `ts_files` (File | string | custom_target | custom_target index | generator_output):
+    the list of input translation files produced by Qt's lupdate tool.<br/>
+    *New in 0.60.0*: support for custom_target, custom_target_index, and generator_output.
+ - `install` bool: when true, this target is installed during the install step (optional).
+ - `install_dir` string: directory to install to (optional).
+ - `build_by_default` bool: when set to true, to have this target be built by
+   default, that is, when invoking `meson compile`; the default value is false
+   (optional).
+ - `qresource` string: rcc source file to extract ts_files from; cannot be used
+   with ts_files kwarg.
+ - `rcc_extra_arguments` string: any additional arguments to `rcc` (optional),
+   when used with `qresource.
+
+Returns either: a list of custom targets for the compiled
+translations, or, if using a `qresource` file, a single custom target
+containing the processed source file, which should be passed to a main
+build target.
+
+## has_tools
+
+This method returns `true` if all tools used by this module are found,
+`false` otherwise.
+
+It should be used to compile optional Qt code:
+```meson
+qt6 = import('qt6')
+if qt6.has_tools(required: get_option('qt_feature'))
+  moc_files = qt6.preprocess(...)
+  ...
+endif
+```
+
+This method takes the following keyword arguments:
+- `required` bool | FeatureOption: by default, `required` is set to `false`. If `required` is set to
+  `true` or an enabled `feature`(Build-options.md#features) and some tools are
+  missing Meson will abort.
+- `method` string: The method to use to detect qt, see dependency
+
+## Dependencies
+
+See Qt dependencies(Dependencies.md#qt4-qt5)
+
+The 'modules' argument is used to include Qt modules in the project.
+See the Qt documentation for the list of
+modules(https://doc.qt.io/qt-6/qtmodules.html).
+
+The 'private_headers' argument allows usage of Qt's modules private
+headers.
+
+## Example
+A simple example would look like this:
+
+```meson
+qt6 = import('qt6')
+qt6_dep = dependency('qt6', modules: 'Core', 'Gui')
+inc = include_directories('includes')
+moc_files = qt6.compile_moc(headers : 'myclass.h',
+                            extra_arguments: '-DMAKES_MY_MOC_HEADER_COMPILE',
+                            include_directories: inc,
+                            dependencies: qt6_dep)
+translations = qt6.compile_translations(ts_files : 'myTranslation_fr.ts', build_by_default : true)
+executable('myprog', 'main.cpp', 'myclass.cpp', moc_files,
+           include_directories: inc,
+           dependencies : qt6_dep)
+```
+
+Sometimes, translations are embedded inside the binary using qresource
+files. In this case the ts files do not need to be explicitly listed,
+but will be inferred from the built qm files listed in the qresource
+file. For example:
+
+```meson
+qt6 = import('qt6')
+qt6_dep = dependency('qt6', modules: 'Core', 'Gui')
+lang_cpp = qt6.compile_translations(qresource: 'lang.qrc')
+executable('myprog', 'main.cpp', lang_cpp,
+           dependencies: qt6_dep)
+```
+

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/Quick-guide.md Added

@@ -0,0 +1,158 @@
+---
+title: Quickstart Guide
+short-description: Getting Started using Mesonbuild
+...
+
+# Using Meson
+
+Meson has been designed to be as simple to use as possible. This page
+outlines the initial steps needed for installation, troubleshooting,
+and standard use.
+
+For more advanced configuration please refer to the command line help
+`meson --help` or the Meson documentation located at the
+Mesonbuild(https://mesonbuild.com) website.
+
+Table of Contents:
+* Requirements(#requirements)
+* Installation using package manager(#installation-using-package-manager)
+* Installation using Python(#installation-using-python)
+* Installation from source(#installation-from-source)
+* Troubleshooting(#troubleshooting)
+* Compiling a Meson project(#compiling-a-meson-project)
+* Using Meson as a distro packager(#using-meson-as-a-distro-packager)
+
+Requirements
+--
+
+* Python 3(https://python.org)
+* Ninja(https://github.com/ninja-build/ninja/)
+
+*Ninja is only needed if you use the Ninja backend. Meson can also
+generate native VS and Xcode project files.*
+
+
+Installation using package manager
+--
+
+Ubuntu:
+
+```console
+$ sudo apt-get install python3 python3-pip python3-setuptools \
+                       python3-wheel ninja-build
+```
+*Due to our frequent release cycle and development speed, distro packaged software may quickly become outdated.*
+
+Installation using Python
+--
+Requirements: **pip3**
+
+The best way to receive the most up-to-date version of Mesonbuild.
+
+Install as a local user (recommended):
+```console
+$ pip3 install --user meson
+```
+Install as root:
+```console
+$ pip3 install meson
+```
+
+*If you are unsure whether to install as root or a local user, install
+ as a local user.*
+
+
+Installation from source
+--
+Requirements: **git**
+
+Meson can be run directly from the cloned git repository.
+
+```console
+$ git clone https://github.com/mesonbuild/meson.git /path/to/sourcedir
+```
+Troubleshooting:
+--
+Common Issues:
+```console
+$ meson setup builddir
+$ bash: /usr/bin/meson: No such file or directory
+```
+
+Description: The default installation prefix for the python pip module
+installation is not included in your shell environment PATH. The
+default prefix for python pip installation modules is located under
+``/usr/local``.
+
+**Resolution:
+This issue can be resolved by altering the default shell environment
+PATH to include ``/usr/local/bin``. **
+
+*Note: There are other ways of fixing this issue such as using
+ symlinks or copying the binaries to a default path and these methods
+ are not recommended or supported as they may break package management
+ interoperability.*
+
+
+Compiling a Meson project
+--
+
+The most common use case of Meson is compiling code on a code base you
+are working on. The steps to take are very simple.
+
+```console
+$ cd /path/to/source/root
+$ meson setup builddir && cd builddir
+$ meson compile
+$ meson test
+```
+
+The only thing to note is that you need to create a separate build
+directory. Meson will not allow you to build source code inside your
+source tree. All build artifacts are stored in the build directory.
+This allows you to have multiple build trees with different
+configurations at the same time. This way generated files are not
+added into revision control by accident.
+
+To recompile after code changes, just type `meson compile`. The build
+command is always the same. You can do arbitrary changes to source
+code and build system files and Meson will detect those and will do
+the right thing. If you want to build optimized binaries, just use the
+argument `--buildtype=debugoptimized` when running Meson. It is
+recommended that you keep one build directory for unoptimized builds
+and one for optimized ones. To compile any given configuration, just
+go into the corresponding build directory and run `meson compile`.
+
+Meson will automatically add compiler flags to enable debug
+information and compiler warnings (i.e. `-g` and `-Wall`). This means
+the user does not have to deal with them and can instead focus on
+coding.
+
+Using Meson as a distro packager
+--
+
+Distro packagers usually want total control on the build flags
+used. Meson supports this use case natively. The commands needed to
+build and install Meson projects are the following.
+
+```console
+$ cd /path/to/source/root
+$ meson --prefix /usr --buildtype=plain builddir -Dc_args=... -Dcpp_args=... -Dc_link_args=... -Dcpp_link_args=...
+$ meson compile -C builddir
+$ meson test -C builddir
+$ DESTDIR=/path/to/staging/root meson install -C builddir
+```
+
+The command line switch `--buildtype=plain` tells Meson not to add its
+own flags to the command line. This gives the packager total control
+on used flags.
+
+This is very similar to other build systems. The only difference is
+that the `DESTDIR` variable is passed as an environment variable
+rather than as an argument to `meson install`.
+
+As distro builds happen always from scratch, you might consider
+enabling unity builds(Unity-builds.md) on your packages because they
+are faster and produce better code. However there are many projects
+that do not build with unity builds enabled so the decision to use
+unity builds must be done by the packager on a case by case basis.

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/Reference-tables.md Added

@@ -0,0 +1,355 @@
+# Reference tables
+
+## Compiler ids
+
+These are return values of the `get_id` (Compiler family) and
+`get_argument_syntax` (Argument syntax) method in a compiler object.
+
+| Value     | Compiler family                  | Argument syntax |
+| -----     | ---------------                  | --------------- |
+| arm       | ARM compiler                     |                 |
+| armclang  | ARMCLANG compiler                |                 |
+| ccomp     | The CompCert formally-verified C compiler |        |
+| ccrx      | Renesas RX Family C/C++ compiler |                 |
+| clang     | The Clang compiler               | gcc             |
+| clang-cl  | The Clang compiler (MSVC compatible driver) | msvc |
+| dmd       | D lang reference compiler        |                 |
+| emscripten| Emscripten WASM compiler         |                 |
+| flang     | Flang Fortran compiler           |                 |
+| g95       | The G95 Fortran compiler         |                 |
+| gcc       | The GNU Compiler Collection      | gcc             |
+| intel     | Intel compiler (Linux and Mac)   | gcc             |
+| intel-cl  | Intel compiler (Windows)         | msvc            |
+| intel-llvm    | Intel oneAPI LLVM-based compiler            |                 |
+| intel-llvm-cl | Intel oneAPI LLVM-based compiler (Windows)  | msvc            |
+| lcc       | Elbrus C/C++/Fortran Compiler    |                 |
+| llvm      | LLVM-based compiler (Swift, D)   |                 |
+| mono      | Xamarin C# compiler              |                 |
+| msvc      | Microsoft Visual Studio          | msvc            |
+| nagfor    | The NAG Fortran compiler         |                 |
+| nvidia_hpc| NVidia HPC SDK compilers         |                 |
+| open64    | The Open64 Fortran Compiler      |                 |
+| pathscale | The Pathscale Fortran compiler   |                 |
+| pgi       | Portland PGI C/C++/Fortran compilers |             |
+| rustc     | Rust compiler                    |                 |
+| sun       | Sun Fortran compiler             |                 |
+| c2000     | Texas Instruments C/C++ Compiler (C2000) |                 |
+| ti        | Texas Instruments C/C++ Compiler |                 |
+| valac     | Vala compiler                    |                 |
+| xc16      | Microchip XC16 C compiler        |                 |
+| cython    | The Cython compiler              |                 |
+| nasm      | The NASM compiler (Since 0.64.0) |                 |
+| yasm      | The YASM compiler (Since 0.64.0) |                 |
+| ml        | Microsoft Macro Assembler for x86 and x86_64 (Since 0.64.0) | msvc |
+| armasm    | Microsoft Macro Assembler for ARM and AARCH64 (Since 0.64.0) | |
+
+## Linker ids
+
+These are return values of the `get_linker_id` method in a compiler object.
+
+| Value      | Linker family                               |
+| -----      | ---------------                             |
+| ld.bfd     | The GNU linker                              |
+| ld.gold    | The GNU gold linker                         |
+| ld.lld     | The LLVM linker, with the GNU interface     |
+| ld.mold    | The fast MOLD linker                        |
+| ld.solaris | Solaris and illumos                         |
+| ld.wasm    | emscripten's wasm-ld linker                 |
+| ld64       | Apple ld64                                  |
+| link       | MSVC linker                                 |
+| lld-link   | The LLVM linker, with the MSVC interface    |
+| xilink     | Used with Intel-cl only, MSVC like          |
+| optlink    | optlink (used with DMD)                     |
+| rlink      | The Renesas linker, used with CCrx only     |
+| xc16-ar    | The Microchip linker, used with XC16 only   |
+| ar2000     | The Texas Instruments linker, used with C2000 only |
+| ti-ar      | The Texas Instruments linker |
+| armlink    | The ARM linker (arm and armclang compilers) |
+| pgi        | Portland/Nvidia PGI                         |
+| nvlink     | Nvidia Linker used with cuda                |
+| ccomp      | CompCert used as the linker driver          |
+
+For languages that don't have separate dynamic linkers such as C# and Java, the
+`get_linker_id` will return the compiler name.
+
+## Script environment variables
+
+| Value               | Comment                         |
+| -----               | -------                         |
+| MESONINTROSPECT     | Command to run to run the introspection command, may be of the form `python /path/to/meson introspect`, user is responsible for splitting the path if necessary. |
+| MESON_BUILD_ROOT    | Absolute path to the build dir  |
+| MESON_DIST_ROOT     | Points to the root of the staging directory, only set when running `dist` scripts |
+| MESON_SOURCE_ROOT   | Absolute path to the source dir |
+| MESON_SUBDIR        | Current subdirectory, only set for `run_command` |
+
+## CPU families
+
+These are returned by the `cpu_family` method of `build_machine`,
+`host_machine` and `target_machine`. For cross compilation they are
+set in the cross file.
+
+| Value               | Comment                  |
+| -----               | -------                  |
+| aarch64             | 64 bit ARM processor     |
+| alpha               | DEC Alpha processor      |
+| arc                 | 32 bit ARC processor     |
+| arm                 | 32 bit ARM processor     |
+| avr                 | Atmel AVR processor      |
+| c2000               | 32 bit C2000 processor   |
+| csky                | 32 bit CSky processor    |
+| dspic               | 16 bit Microchip dsPIC   |
+| e2k                 | MCST Elbrus processor    |
+| ft32                | 32 bit Bridgetek MCU     |
+| ia64                | Itanium processor        |
+| loongarch64         | 64 bit Loongson processor|
+| m68k                | Motorola 68000 processor |
+| microblaze          | MicroBlaze processor     |
+| mips                | 32 bit MIPS processor    |
+| mips64              | 64 bit MIPS processor    |
+| msp430              | 16 bit MSP430 processor  |
+| parisc              | HP PA-RISC processor     |
+| pic24               | 16 bit Microchip PIC24   |
+| ppc                 | 32 bit PPC processors    |
+| ppc64               | 64 bit PPC processors    |
+| riscv32             | 32 bit RISC-V Open ISA   |
+| riscv64             | 64 bit RISC-V Open ISA   |
+| rl78                | Renesas RL78             |
+| rx                  | Renesas RX 32 bit MCU    |
+| s390                | IBM zSystem s390         |
+| s390x               | IBM zSystem s390x        |
+| sh4                 | SuperH SH-4              |
+| sparc               | 32 bit SPARC             |
+| sparc64             | SPARC v9 processor       |
+| wasm32              | 32 bit Webassembly       |
+| wasm64              | 64 bit Webassembly       |
+| x86                 | 32 bit x86 processor     |
+| x86_64              | 64 bit x86 processor     |
+
+Any cpu family not listed in the above list is not guaranteed to
+remain stable in future releases.
+
+Those porting from autotools should note that Meson does not add
+endianness to the name of the cpu_family. For example, autotools
+will call little endian PPC64 "ppc64le", Meson will not, you must
+also check the `.endian()` value of the machine for this information.
+
+## Operating system names
+
+These are provided by the `.system()` method call.
+
+| Value               | Comment                         |
+| -----               | -------                         |
+| android             | By convention only, subject to change |
+| cygwin              | The Cygwin environment for Windows |
+| darwin              | Either OSX or iOS |
+| dragonfly           | DragonFly BSD |
+| emscripten          | Emscripten's Javascript environment |
+| freebsd             | FreeBSD and its derivatives |
+| gnu                 | GNU Hurd |
+| haiku               | |
+| linux               | |
+| netbsd              | |
+| openbsd             | |
+| windows             | Any version of Windows |
+| sunos               | illumos and Solaris |
+
+Any string not listed above is not guaranteed to remain stable in
+future releases.
+
+## Language arguments parameter names
+
+These are the parameter names for passing language specific arguments to your build target.
+
+| Language      | compiler name | linker name       |
+| ------------- | ------------- | ----------------- |
+| C             | c_args        | c_link_args       |
+| C++           | cpp_args      | cpp_link_args     |
+| C#            | cs_args       | cs_link_args      |
+| D             | d_args        | d_link_args       |
+| Fortran       | fortran_args  | fortran_link_args |
+| Java          | java_args     | java_link_args    |
+| Objective C   | objc_args     | objc_link_args    |
+| Objective C++ | objcpp_args   | objcpp_link_args  |
+| Rust          | rust_args     | rust_link_args    |
+| Vala          | vala_args     | vala_link_args    |
+| Cython        | cython_args   | cython_link_args  |
+| NASM          | nasm_args     | N/A               |
+| MASM          | masm_args     | N/A               |
+
+All these `<lang>_*` options are specified per machine. See in
+specifying options per
+machine(Builtin-options.md#Specifying-options-per-machine) for on how
+to do this in cross builds.
+
+## Compiler and linker flag environment variables
+
+These environment variables will be used to modify the compiler and
+linker flags.
+
+It is recommended that you **do not use these**. They are provided
+purely to for backwards compatibility with other build systems. There
+are many caveats to their use, especially when rebuilding the project.
+It is **highly** recommended that you use the command line
+arguments(#language-arguments-parameter-names) instead.
+
+| Name        | Comment                                  |
+| -----       | -------                                  |
+| CFLAGS      | Flags for the C compiler                 |
+| CXXFLAGS    | Flags for the C++ compiler               |
+| OBJCFLAGS   | Flags for the Objective C compiler       |
+| FFLAGS      | Flags for the Fortran compiler           |
+| DFLAGS      | Flags for the D compiler                 |
+| VALAFLAGS   | Flags for the Vala compiler              |
+| RUSTFLAGS   | Flags for the Rust compiler              |
+| CYTHONFLAGS | Flags for the Cython compiler            |
+| LDFLAGS     | The linker flags, used for all languages |
+
+N.B. these settings are specified per machine, and so the environment
+variables actually come in pairs. See the environment variables per
+machine(#Environment-variables-per-machine) section for details.
+
+## Function Attributes
+
+These are the parameters names that are supported using
+`compiler.has_function_attribute()` or
+`compiler.get_supported_function_attributes()`
+
+### GCC `__attribute__`
+
+These values are supported using the GCC style `__attribute__` annotations,
+which are supported by GCC, Clang, and other compilers.
+
+
+| Name                     |
+|--------------------------|
+| alias                    |
+| aligned                  |
+| alloc_size               |
+| always_inline            |
+| artificial               |
+| cold                     |
+| const                    |
+| constructor              |
+| constructor_priority     |
+| deprecated               |
+| destructor               |
+| error                    |
+| externally_visible       |
+| fallthrough              |
+| flatten                  |
+| format                   |
+| format_arg               |
+| force_align_arg_pointer³ |
+| gnu_inline               |
+| hot                      |
+| ifunc                    |
+| malloc                   |
+| noclone                  |
+| noinline                 |
+| nonnull                  |
+| noreturn                 |
+| nothrow                  |
+| optimize                 |
+| packed                   |
+| pure                     |
+| retain⁴                  |
+| returns_nonnull          |
+| section⁵                 |
+| sentinel⁵                |
+| unused                   |
+| used                     |
+| visibility*              |
+| visibility:default†      |
+| visibility:hidden†       |
+| visibility:internal†     |
+| visibility:protected†    |
+| warning                  |
+| warn_unused_result       |
+| weak                     |
+| weakref                  |
+
+\* *Changed in 0.52.0* the "visibility" target no longer includes
+"protected", which is not present in Apple's clang.
+
+† *New in 0.52.0* These split visibility attributes are preferred to the plain
+"visibility" as they provide narrower checks.
+
+³ *New in 0.55.0*
+
+⁴ *New in 0.62.0*
+
+⁵ *New in 0.63.0*
+
+### MSVC __declspec
+
+These values are supported using the MSVC style `__declspec` annotation,
+which are supported by MSVC, GCC, Clang, and other compilers.
+
+| Name                 |
+|----------------------|
+| dllexport            |
+| dllimport            |
+
+
+## Dependency lookup methods
+
+These are the values that can be passed to `dependency` function's
+`method` keyword argument.
+
+| Name              | Comment                                      |
+| -----             | -------                                      |
+| auto              | Automatic method selection                   |
+| pkg-config        | Use Pkg-Config                               |
+| cmake             | Look up as a CMake module                    |
+| config-tool       | Use a custom dep tool such as `cups-config`  |
+| system            | System provided (e.g. OpenGL)                |
+| extraframework    | A macOS/iOS framework                        |
+
+
+## Compiler and Linker selection variables
+
+N.B. these settings are specified per machine, and so the environment
+variables actually come in pairs. See the environment variables per
+machine(#Environment-variables-per-machine) section for details.
+
+| Language      | Compiler | Linker    | Note                                        |
+|---------------|----------|-----------|---------------------------------------------|
+| C             | CC       | CC_LD     |                                             |
+| C++           | CXX      | CXX_LD    |                                             |
+| D             | DC       | DC_LD     | Before 0.54 D_LD*                           |
+| Fortran       | FC       | FC_LD     | Before 0.54 F_LD*                           |
+| Objective-C   | OBJC     | OBJC_LD   |                                             |
+| Objective-C++ | OBJCXX   | OBJCXX_LD | Before 0.54 OBJCPP_LD*                      |
+| Rust          | RUSTC    | RUSTC_LD  | Before 0.54 RUST_LD*                        |
+| Vala          | VALAC    |           | Use CC_LD. Vala transpiles to C             |
+| C#            | CSC      | CSC       | The linker is the compiler                  |
+| nasm          | NASM     |           | Uses the C linker                           |
+
+*The old environment variales are still supported, but are deprecated
+and will be removed in a future version of Meson.*
+
+## Environment variables per machine
+
+Since *0.54.0*, Following Autotool and other legacy build systems,
+environment variables that affect machine-specific settings come in
+pairs: for every bare environment variable `FOO`, there is a suffixed
+`FOO_FOR_BUILD`, where `FOO` just affects the host machine
+configuration, while `FOO_FOR_BUILD` just affects the build machine
+configuration. For example:
+
+ - `PKG_CONFIG_PATH_FOR_BUILD` controls the paths pkg-config will search for
+   just `native: true` dependencies (build machine).
+
+ - `PKG_CONFIG_PATH` controls the paths pkg-config will search for just
+   `native: false` dependencies (host machine).
+
+This mirrors the `build.` prefix used for (built-in) Meson options,
+which has the same meaning.
+
+This is useful for cross builds. In the native builds, build = host,
+and the unsuffixed environment variables alone will suffice.
+
+Prior to *0.54.0*, there was no `_FOR_BUILD`-suffixed variables, and
+most environment variables only effected native machine
+configurations, though this wasn't consistent (e.g. `PKG_CONFIG_PATH`
+still affected cross builds).

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/Release-notes-for-0.37.0.md Added

@@ -0,0 +1,173 @@
+---
+title: Release 0.37
+short-description: Release notes for 0.37
+...
+
+# New features
+
+## Mesontest
+
+Mesontest is a new testing tool that allows you to run your tests in
+many different ways. As an example you can run tests multiple times:
+
+    mesontest --repeat=1000 a_test
+
+or with an arbitrary wrapper executable:
+
+    mesontest --wrap='valgrind --tool=helgrind' a_test
+
+or under `gdb`, 1000 times in a row. This is handy for tests that fail
+spuriously, as when the crash happens you are given the full GDB
+command line:
+
+    mesontest --repeat=1000 --gdb a_test
+
+## Mesonrewriter
+
+Mesonrewriter is an experimental tool to manipulate your build
+definitions programmatically. It is not installed by default yet but
+those interested can run it from the source repository.
+
+As an example, here is how you would add a source file to a build target:
+
+    mesonrewriter add --target=program --filename=new_source.c
+
+## Shared modules
+
+The new `shared_module` function allows the creation of shared
+modules, that is, extension modules such as plugins that are meant to
+be used solely with `dlopen` rather than linking them to targets.
+
+## Gnome module
+
+- Detect required programs and print useful errors if missing
+
+### gtkdoc
+
+- Allow passing a list of directories to `src_dir` keyword argument
+- Add `namespace` keyword argument
+- Add `mode` keyword argument
+- Fix `gtkdoc-scangobj` finding local libraries
+
+### compile_resources
+
+- Add `gresource_bundle` keyword argument to output `.gresource` files
+- Add `export` and `install_header` keyword arguments
+- Use depfile support available in GLib >= 2.52.0
+
+## i18n module
+
+- Add `merge_file()` function for creating translated files
+- Add `preset` keyword argument to included common gettext flags
+- Read languages from `LINGUAS` file
+
+## LLVM IR compilation
+
+Meson has long had support for compiling assembler (GAS) files. In
+this release we add support for compiling LLVM IR files in a similar
+way when building with the Clang compiler. Just add it to the list of
+files when creating a `library` or `executable` target like any other
+source file. No special handling is required:
+
+```meson
+executable('some-exe', 'main.c', 'asm-file.S', 'ir-file.ll')
+```
+
+As always, you can also mix LLVM IR files with C++, C, and Assembly
+(GAS) sources.
+
+## ViM indent and syntax files
+
+We now include filetype, indent, and syntax files for ViM with the
+source
+tree(https://github.com/mesonbuild/meson/tree/master/data/syntax-highlighting/vim).
+Please file issues (or pull requests!) for enhancements or if you face
+any problems using them.
+
+## Push URLs in .wrap files
+
+.wrap files(Using-the-WrapDB.md) for subprojects can now include a
+separate push URL to allow developers to push changes directly from a
+subproject git checkout.
+
+## pkg-config dependencies
+
+Meson now supports multiple version restrictions while searching for pkg-config dependencies.
+
+```meson
+# Just want a lower limit
+dependency('zlib', version : '>1.2.1')
+# Want both a lower and an upper limit
+dependency('opencv', version : '>=2.3.0', '<=3.1.0')
+# Want to exclude one specific broken version
+dependency('foolite', version : '>=3.12.1', '!=3.13.99')
+```
+
+## Overriding more binaries with environment variables
+
+You can now specify the binary to be used for the following tools by
+setting the corresponding environment variable
+
+| Name | Environment variable |
+| ---- | -------------------- |
+| pkg-config | PKG_CONFIG     |
+| readelf    | READELF        |
+| nm         | NM             |
+
+## Support for `localstatedir`
+
+Similar to other options such as `bindir` and `datadir`, you can now
+specify the `localstatedir` for a project by passing
+`--localstatedir=dir` to `meson` or `-Dlocalstatedir=dir` to
+`mesonconf` after configuration. You can also access it from inside
+the `meson.build` file with `get_option('localstatedir')`.
+
+## New compiler function `symbols_have_underscore_prefix`
+
+Checks if the compiler prefixes an underscore to C global symbols with
+the default calling convention. This is useful when linking to
+compiled assembly code, or other code that does not have its C symbol
+mangling handled transparently by the compiler.
+
+```meson
+cc = meson.get_compiler('c')
+conf = configuration_data()
+if cc.symbols_have_underscore_prefix()
+    conf.set('SYMBOLS_HAVE_UNDERSCORE', true)
+endif
+```
+
+C symbol mangling is platform and architecture dependent, and a helper
+function is needed to detect it. For example, Windows 32-bit prefixes
+underscore, but 64-bit does not. Linux does not prefix an underscore
+but OS X does.
+
+## Vala
+
+GLib Resources compiled with
+`gnome.compile_resources`(Gnome-module.md#compile_resources) that
+are added to the sources of a Vala build target will now cause the
+appropriate `--gresources` flag to be passed to the Vala compiler so
+you don't need to add that yourself to `vala_args:`.
+
+## Improvements to install scripts
+
+You can now pass arguments to install scripts added with
+meson.add_install_script. All
+arguments after the script name will be passed to the script.
+
+The `MESON_INSTALL_DESTDIR_PREFIX` environment variable is now set
+when install scripts are called. This contains the values of the
+`DESTDIR` environment variable and the `prefix` option passed to Meson
+joined together. This is useful because both those are usually
+absolute paths, and joining absolute paths in a cross-platform way is
+tricky. `os.path.join` in
+Python(https://docs.python.org/3/library/os.path.html#os.path.join)
+will discard all previous path segments when it encounters an absolute
+path, and simply concatenating them will not work on Windows where
+absolute paths begin with the drive letter.
+
+## More install directories
+
+Added new options `sbindir` and `infodir` that can be used for
+installation.

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/Release-notes-for-0.38.0.md Added

@@ -0,0 +1,123 @@
+---
+title: Release 0.38
+short-description: Release notes for 0.38
+...
+
+## Uninstall target
+
+Meson allows you to uninstall an install step by invoking the
+uninstall target. This will remove all files installed as part of
+install. Note that this does not restore the original files. This also
+does not undo changes done by custom install scripts (because they can
+do arbitrary install operations).
+
+## Support for arbitrary test setups
+
+Sometimes you need to run unit tests with special settings. For
+example under Valgrind. Usually this requires extra command line
+options for the tool. This is supported with the new *test setup*
+feature. For example to set up a test run with Valgrind, you'd write
+this in a `meson.build` file:
+
+```meson
+add_test_setup('valgrind',
+  exe_wrapper : vg, '--error-exitcode=1', '--leak-check=full',
+  timeout_multiplier : 100)
+```
+
+This tells Meson to run tests with Valgrind using the given options
+and multiplying the test timeout values by 100. To run this test setup
+simply issue the following command:
+
+```console
+$ mesontest --setup=valgrind
+```
+
+## Intel C/C++ compiler support
+
+As usual, just set `CC=icc CXX=icpc` and Meson will use it as the
+C/C++ compiler. Currently only Linux is supported.
+
+## Get values from configuration data objects
+
+Now it is possible to query values stored in configuration data
+objects.
+
+```meson
+cdata.set('key', 'value')
+cdata.get('key') # returns 'value'
+cdata.get('nokey', 'default') # returns 'default'
+cdata.get('nokey') # halts with an error
+```
+
+## Python 3 module support
+
+Building Python 3 extension modules has always been possible, but it
+is now even easier:
+
+```meson
+py3_mod = import('python3')
+pylib = py3_mod.extension_module('modname',
+  'modsource.c',
+  dependencies : py3_dep)
+```
+
+## Default options to subprojects
+
+Projects can specify overriding values for subprojects'
+`default_options` when invoking a subproject:
+
+```meson
+subproject('foo', default_options : 'optname=overridevalue')
+dependency('some-dep', fallback : 'some_subproject', 'some_dep', default_options : 'optname=overridevalue')
+```
+
+The effect is the same as if the default options were written in the
+subproject's `project` call.
+
+## Set targets to be built (or not) by default
+
+Build targets got a new keyword `build_by_default` which tells whether
+the target should be built by default when running e.g. `ninja`.
+Custom targets are not built by default but other targets are. Any
+target that is tagged as installed or to be built always is also built
+by default, regardless of the value of this keyword.
+
+## Add option to mesonconf to wipe cached data.
+
+Meson caches the results of dependency lookups. Sometimes these may
+get out of sync with the system state. Mesonconf now has a
+`--clearcache` option to clear these values so they will be
+re-searched from the system upon next compile.
+
+## Can specify file permissions and owner when installing data
+
+The new `install_mode` keyword argument can be used to specify file
+permissions and uid/gid of files when doing the install. This allows
+you to, for example, install suid root scripts.
+
+## `has_header()` checks are now faster
+
+When using compilers that implement the `__has_include()`
+preprocessor
+macro(https://clang.llvm.org/docs/LanguageExtensions.html#include-file-checking-macros),
+the check is now ~40% faster.
+
+## Array indexing now supports fallback values
+
+The second argument to the array
+list.get function is now returned
+if the specified index could not be found
+
+```meson
+array = 10, 11, 12, 13
+array.get(0) # this will return `10`
+array.get(4) # this will give an error about invalid index
+array.get(4, 0) # this will return `0`
+```
+
+## Silent mode for Mesontest
+
+The Meson test executor got a new argument `-q` (and `--quiet`) that
+suppresses all output of successful tests. This makes interactive
+usage nicer because only errors are printed.

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/Release-notes-for-0.39.0.md Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/Release-notes-for-0.40.0.md Added

@@ -0,0 +1,152 @@
+---
+title: Release 0.40
+short-description: Release notes for 0.40
+...
+
+# New features
+
+## Outputs of generators can be used in custom targets in the VS backend
+
+This has been possible with the Ninja backend for a long time but now
+the Visual Studio backend works too.
+
+## `compute_int` method in the compiler objects
+
+This method can be used to evaluate the value of an expression. As an
+example:
+
+```meson
+cc = meson.get_compiler('c')
+two = cc.compute_int('1 + 1') # A very slow way of adding two numbers.
+```
+
+## Visual Studio 2017 support
+
+There is now a VS2017 backend (`--backend=vs2017`) as well as a
+generic VS backend (`--backend=vs`) that autodetects the currently
+active VS version.
+
+## Automatic initialization of subprojects that are git submodules
+
+If you have a directory inside your subprojects directory (usually
+`subprojects/`) that is a git submodule, Meson will automatically
+initialize it if your build files refer to it. This will be done
+without needing a wrap file since git contains all the information
+needed.
+
+## No download mode for wraps
+
+Added a new option `wrap-mode` that can be toggled to prevent Meson
+from downloading dependency projects. Attempting to do so will cause
+an error. This is useful for distro packagers and other cases where
+you must explicitly enforce that nothing is downloaded from the net
+during configuration or build.
+
+## Overriding options per target
+
+Build targets got a new keyword argument `override_options` that can
+be used to override system options. As an example if you have a target
+that you know can't be built with `-Werror` enabled you can override
+the value of the option like this:
+
+```meson
+executable('foo', 'foo.c', override_options : 'werror=false')
+```
+
+Note that this does not affect project options, only those options
+that come from Meson (language standards, unity builds etc).
+
+## Compiler object get define
+
+Compiler objects got a new method `get_define()` that returns the
+given preprocessor symbol as a string.
+
+```meson
+cc = meson.get_compiler('c')
+one = cc.get_define('__linux__') # returns '1' on Linux hosts
+```
+
+## Cygwin support
+
+Meson now works under Cygwin and we have added it to our CI test
+matrix.
+
+## Multiple install directories
+
+Custom targets can produce many output files. Previously it was only
+possible to install all of them in the same directory, but now you can
+install each output in its own directory like this:
+
+```meson
+custom_target('two_out',
+  output : 'diff.h', 'diff.sh',
+  command : creator, '@OUTDIR@',
+  install : true,
+  install_dir : 'dir1', 'dir2')
+```
+
+For backwards compatibility and for conciseness, if you only specify
+one directory all outputs will be installed into it.
+
+The same feature is also available for Vala build targets. For
+instance, to install a shared library built by valac, the generated
+header, and the generated VAPI (respectively) into the default
+locations, you can do:
+
+```meson
+shared_library('valalib', 'mylib.vala',
+  install : true,
+  install_dir : true, true, true)
+```
+
+To install any of the three in a custom directory, just pass it as a
+string instead of `true`. To not install it, pass `false`. You can
+also pass a single string (as before) and it will cause only the
+library to be installed, so this is a backwards-compatible change.
+
+## Can specify method of obtaining dependencies
+
+Some dependencies have many ways of being provided. As an example Qt
+can either be detected via `pkg-config` or `qmake`. Until now Meson
+has had a heuristic for selecting which method to choose but sometimes
+it does the wrong thing. This can now be overridden with the `method`
+keyword like this:
+
+```meson
+qt5_dep = dependency('qt5', modules : 'core', method : 'qmake')
+```
+
+## Link whole contents of static libraries
+
+The default behavior of static libraries is to discard all symbols
+that are not not directly referenced. This may lead to exported
+symbols being lost. Most compilers support "whole archive" linking
+that includes all symbols and code of a given static library. This is
+exposed with the `link_whole` keyword.
+
+```meson
+shared_library('foo', 'foo.c', link_whole : some_static_library)
+```
+
+Note that Visual Studio compilers only support this functionality on
+VS 2015 and newer.
+
+## Unity builds only for subprojects
+
+Up until now unity builds were either done for every target or none of
+them. Now unity builds can be specified to be enabled only for
+subprojects, which change seldom, and not for the master project,
+which changes a lot. This is enabled by setting the `unity` option to
+`subprojects`.
+
+## Running `mesonintrospect` from scripts
+
+Meson now sets the `MESONINTROSPECT` environment variable in addition
+to `MESON_SOURCE_ROOT` and other variables when running scripts. It is
+guaranteed to point to the correct `mesonintrospect` script, which is
+important when running Meson uninstalled from git or when your `PATH`s
+may not be set up correctly.
+
+Specifically, the following Meson functions will set it:
+`meson.add_install_script()`, `meson.add_postconf_script()`,
+`run_command()`, `run_target()`.

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/Release-notes-for-0.41.0.md Added

@@ -0,0 +1,84 @@
+---
+title: Release 0.41
+short-description: Release notes for 0.41
+...
+
+# New features
+
+## Dependency Handler for LLVM
+
+Native support for linking against LLVM using the `dependency` function.
+
+## vcs_tag keyword fallback is now optional
+
+The `fallback` keyword in `vcs_tag()` is now optional. If not given,
+its value defaults to the return value of `meson.project_version()`.
+
+## Better quoting of special characters in ninja command invocations
+
+The ninja backend now quotes special characters that may be
+interpreted by ninja itself, providing better interoperability with
+custom commands. This support may not be perfect; please report any
+issues found with special characters to the issue tracker.
+
+## Pkgconfig support for custom variables
+
+The Pkgconfig module object can add arbitrary variables to the generated .pc
+file with the new `variables` keyword:
+```meson
+pkg.generate(libraries : libs,
+             subdirs : h,
+             version : '1.0',
+             name : 'libsimple',
+             filebase : 'simple',
+             description : 'A simple demo library.',
+             variables : 'datadir=${prefix}/data')
+```
+
+## A target for creating tarballs
+
+Creating distribution tarballs is simple:
+
+    ninja dist
+
+This will create a `.tar.xz` archive of the source code including
+submodules without any revision control information. This command also
+verifies that the resulting archive can be built, tested and
+installed. This is roughly equivalent to the `distcheck` target in
+other build systems. Currently this only works for projects using Git
+and only with the Ninja backend.
+
+## Support for passing arguments to Rust compiler
+
+Targets for building rust now take a `rust_args` keyword.
+
+## Code coverage export for tests
+
+Code coverage can be generated for tests by passing the `--cov` argument to
+the `run_tests.py` test runner. Note, since multiple processes are used,
+coverage must be combined before producing a report (`coverage3 combine`).
+
+## Reproducible builds
+
+All known issues have been fixed and Meson can now build reproducible Debian
+packages out of the box.
+
+## Extended template substitution in configure_file
+
+The output argument of `configure_file()` is parsed for @BASENAME@ and
+@PLAINNAME@ substitutions.
+
+## Cross-config property for overriding whether an exe wrapper is needed
+
+The new `needs_exe_wrapper` property allows overriding auto-detection for
+cases where `build_machine` appears to be compatible with `host_machine`,
+but actually isn't. For example when:
+- `build_machine` is macOS and `host_machine` is the iOS Simulator
+- the `build_machine`'s libc is glibc but the `host_machine` libc is uClibc
+- code relies on kernel features not available on the `build_machine`
+
+## Support for capturing stdout of a command in configure_file
+
+`configure_file()` now supports a new keyword - `capture`. When this argument
+is set to true, Meson captures `stdout` of the `command` and writes it to
+the target file specified as `output`.

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/Release-notes-for-0.42.0.md Added

@@ -0,0 +1,148 @@
+---
+title: Release 0.42
+short-description: Release notes for 0.42
+...
+
+# New features
+
+## Distribution tarballs from Mercurial repositories
+
+Creating distribution tarballs can now be made out of projects based
+on Mercurial. As before, this remains possible only with the Ninja
+backend.
+
+## Keyword argument verification
+
+Meson will now check the keyword arguments used when calling any
+function and print a warning if any of the keyword arguments is not
+known. In the future this will become a hard error.
+
+## Add support for Genie to Vala compiler
+
+The Vala compiler has an alternative syntax, Genie, that uses the
+`.gs` file extension. Meson now recognises and uses Genie files.
+
+## Pkgconfig support for additional cflags
+
+The Pkgconfig module object can add arbitrary extra cflags to the Cflags
+value in the .pc file, using the "extra_cflags" keyword:
+```meson
+pkg.generate(libraries : libs,
+             subdirs : h,
+             version : '1.0',
+             name : 'libsimple',
+             filebase : 'simple',
+             description : 'A simple demo library.',
+             extra_cflags : '-Dfoo' )
+```
+
+## Base options accessible via get_option()
+
+Base options are now accessible via the get_option() function.
+```meson
+uses_lto = get_option('b_lto')
+```
+
+## Allow crate type configuration for Rust compiler
+
+Rust targets now take an optional `rust_crate_type` keyword, allowing
+you to set the crate type of the resulting artifact. Valid crate types
+are `dylib` or `cdylib` for shared libraries, and `rlib` or
+`staticlib` for static libraries. For more, see Rust's linkage
+referencerust-linkage.
+
+rust-linkage: https://doc.rust-lang.org/reference/linkage.html
+
+## Simultaneous use of Address- and Undefined Behavior Sanitizers
+
+Both the address- and undefined behavior sanitizers can now be used
+simultaneously by passing `-Db_sanitize=address,undefined` to Meson.
+
+## Unstable SIMD module
+
+A new experimental module to compile code with many different SIMD
+instruction sets and selecting the best one at runtime. This module
+is unstable, meaning its API is subject to change in later releases.
+It might also be removed altogether.
+
+
+## Import libraries for executables on Windows
+
+The new keyword `implib` to `executable()` allows generation of an import
+library for the executable.
+
+## Added build_rpath keyword argument
+
+You can specify `build_rpath : '/foo/bar'` in build targets and the
+given path will get added to the target's rpath in the build tree. It
+is removed during the install step.
+
+Meson will print a warning when the user tries to add an rpath linker
+flag manually, e.g. via `link_args` to a target. This is not
+recommended because having multiple rpath causes them to stomp on each
+other. This warning will become a hard error in some future release.
+
+## Vulkan dependency module
+
+Vulkan can now be used as native dependency. The dependency module
+will detect the VULKAN_SDK environment variable or otherwise try to
+receive the vulkan library and header via pkgconfig or from the
+system.
+
+## Limiting the maximum number of linker processes
+
+With the Ninja backend it is now possible to limit the maximum number of
+concurrent linker processes. This is usually only needed for projects
+that have many large link steps that cause the system to run out of
+memory if they are run in parallel. This limit can be set with the
+new `backend_max_links` option.
+
+## Disable implicit include directories
+
+By default Meson adds the current source and build directories to the
+header search path. On some rare occasions this is not desired. Setting
+the `implicit_include_directories` keyword argument to `false` these
+directories are not used.
+
+## Support for MPI dependency
+
+MPI is now supported as a dependency. Because dependencies are
+language-specific, you must specify the requested language with the
+`language` keyword, i.e., `dependency('mpi', language='c')` will
+request the C MPI headers and libraries. See the MPI
+dependency(Dependencies.md#mpi) for more information.
+
+## Allow excluding files or directories from `install_subdir`
+
+The install_subdir command
+accepts the new `exclude_files` and `exclude_directories` keyword
+arguments that allow specified files or directories to be excluded
+from the installed subdirectory.
+
+## Make all Meson functionality invocable via the main executable
+
+Previously Meson had multiple executables such as `mesonintrospect`
+and `mesontest`. They are now invocable via the main Meson executable
+like this:
+
+    meson configure <arguments> # equivalent to mesonconf <options>
+    meson test <arguments> # equivalent to mesontest <arguments>
+
+The old commands are still available but they are deprecated
+and will be removed in some future release.
+
+## Pcap dependency detector
+
+Meson will automatically obtain dependency information for pcap
+using the `pcap-config` tool. It is used like any other dependency:
+
+```meson
+pcap_dep = dependency('pcap', version : '>=1.0')
+```
+
+## GNOME module mkenums_simple() addition
+
+Most libraries and applications use the same standard templates for
+glib-mkenums. There is now a new `mkenums_simple()` convenience method
+that passes those default templates to glib-mkenums and allows some tweaks
+such as optional function decorators or leading underscores.

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/Release-notes-for-0.43.0.md Added

@@ -0,0 +1,125 @@
+---
+title: Release 0.43
+short-description: Release notes for 0.43
+...
+
+## Portability improvements to Boost Dependency
+
+The Boost dependency has been improved to better detect the various
+ways to install boost on multiple platforms. At the same time the
+`modules` semantics for the dependency has been changed. Previously it
+was allowed to specify header directories as `modules` but it wasn't
+required. Now, modules are only used to specify libraries that require
+linking.
+
+This is a breaking change and the fix is to remove all modules that aren't
+found.
+
+## Generator learned capture
+
+Generators can now be configured to capture the standard output. See
+`test cases/common/98 gen extra/meson.build` for an example.
+
+## Can index CustomTarget objects
+
+The `CustomTarget` object can now be indexed like an array. The
+resulting object can be used as a source file for other Targets, this
+will create a dependency on the original `CustomTarget`, but will only
+insert the generated file corresponding to the index value of the
+`CustomTarget`'s `output` keyword.
+
+```meson
+c = custom_target(
+  ...
+  output : 'out.h', 'out.c',
+)
+lib1 = static_library(
+  'lib1',
+  lib1_sources, c0,
+  ...
+)
+exec = executable(
+  'executable',
+  c1,
+  link_with : lib1,
+)
+```
+
+## Can override executables in the cross file
+
+The cross file can now be used for overriding the result of
+`find_program`. As an example if you want to find the `objdump`
+command and have the following definition in your cross file:
+
+```ini
+binaries
+...
+objdump = '/usr/bin/arm-linux-gnueabihf-objdump-6'
+```
+
+Then issuing the command `find_program('objdump')` will return the
+version specified in the cross file. If you need the build machine's
+objdump, you can specify the `native` keyword like this:
+
+```meson
+native_objdump = find_program('objdump', native : true)
+```
+
+## Easier handling of supported compiler arguments
+
+A common pattern for handling multiple desired compiler arguments, was
+to test their presence and add them to an array one-by-one, e.g.:
+
+```meson
+warning_flags_maybe = 
+  '-Wsomething',
+  '-Wanother-thing',
+  '-Wno-the-other-thing',
+
+warning_flags = 
+foreach flag : warning_flags_maybe
+  if cc.has_argument(flag)
+    warning_flags += flag
+  endif
+endforeach
+cc.add_project_argument(warning_flags)
+```
+
+A helper has been added for the foreach/has_argument pattern, so you
+can now simply do:
+
+```meson
+warning_flags =  ... 
+flags = cc.get_supported_arguments(warning_flags)
+```
+
+## Better support for shared libraries in non-system paths
+
+Meson has support for prebuilt object files and static libraries. This
+release adds feature parity to shared libraries that are either in
+non-standard system paths or shipped as part of your project. On
+systems that support rpath, Meson automatically adds rpath entries to
+built targets using manually found external libraries.
+
+This means that e.g. supporting prebuilt libraries shipped with your
+source or provided by subprojects or wrap definitions by writing a
+build file like this:
+
+```meson
+project('myprebuiltlibrary', 'c')
+
+cc = meson.get_compiler('c')
+prebuilt = cc.find_library('mylib', dirs : meson.current_source_dir())
+mydep = declare_dependency(include_directories : include_directories('.'),
+                           dependencies : prebuilt)
+```
+
+Then you can use the dependency object in the same way as any other.
+
+## wrap-svn
+
+The Wrap dependency system(Wrap-dependency-system-manual.md) now
+supports Subversion(https://subversion.apache.org/) (svn). This
+support is rudimentary. The repository url has to point to a specific
+(sub)directory containing the `meson.build` file (typically `trunk/`).
+However, providing a `revision` is supported.

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/Release-notes-for-0.44.0.md Added

@@ -0,0 +1,154 @@
+---
+title: Release 0.44
+short-description: Release notes for 0.44
+...
+
+# New features
+
+## Added warning function
+
+This function prints its argument to the console prefixed by
+"WARNING:" in yellow color. A simple example:
+
+warning('foo is deprecated, please use bar instead')
+
+
+## Adds support for additional Qt5-Module keyword `moc_extra_arguments`
+
+When `moc`-ing sources, the `moc` tool does not know about any
+preprocessor macros. The generated code might not match the input
+files when the linking with the moc input sources happens.
+
+This amendment allows to specify a a list of additional arguments
+passed to the `moc` tool. They are called `moc_extra_arguments`.
+
+
+## Prefix-dependent defaults for sysconfdir, localstatedir and sharedstatedir
+
+These options now default in a way consistent with
+FHS(http://refspecs.linuxfoundation.org/fhs.shtml) and common usage.
+
+If prefix is `/usr`, default sysconfdir to `/etc`, localstatedir to `/var` and
+sharedstatedir to `/var/lib`.
+
+If prefix is `/usr/local` (the default), default localstatedir to
+`/var/local` and sharedstatedir to `/var/local/lib`.
+
+
+## An array type for user options
+
+Previously to have an option that took more than one value a string
+value would have to be created and split, but validating this was
+difficult. A new array type has been added to the `meson_options.txt`
+for this case. It works like a 'combo', but allows more than one
+option to be passed. The values can optionally be validated against a
+list of valid values. When used on the command line (with -D), values
+are passed as a comma separated list.
+
+```meson
+option('array_opt', type : 'array', choices : 'one', 'two', 'three', value : 'one')
+```
+
+These can be overwritten on the command line,
+
+```meson
+meson _build -Darray_opt=two,three
+```
+
+## LLVM dependency supports both dynamic and static linking
+
+The LLVM dependency has been improved to consistently use dynamic
+linking. Previously recent version (>= 3.9) would link dynamically
+while older versions would link statically.
+
+Now LLVM also accepts the `static` keyword to enable statically
+linking to LLVM modules instead of dynamically linking.
+
+
+## Added `if_found` to subdir
+
+Added a new keyword argument to the `subdir` command. It is given a
+list of dependency objects and the function will only recurse in the
+subdirectory if they are all found. Typical usage goes like this.
+
+```meson
+d1 = dependency('foo') # This is found
+d2 = dependency('bar') # This is not found
+
+subdir('somedir', if_found : d1, d2)
+```
+
+In this case the subdirectory would not be entered since `d2` could
+not be found.
+
+## `get_unquoted()` method for the `configuration` data object
+
+New convenience method that allows reusing a variable value
+defined quoted. Useful in C for config.h strings for example.
+
+
+## Added disabler object
+
+A disabler object is a new kind of object that has very specific
+semantics. If it is used as part of any other operation such as an
+argument to a function call, logical operations etc, it will cause the
+operation to not be evaluated. Instead the return value of said
+operation will also be the disabler object.
+
+For example if you have an setup like this:
+
+```meson
+dep = dependency('foo')
+lib = shared_library('mylib', 'mylib.c',
+  dependencies : dep)
+exe = executable('mytest', 'mytest.c',
+  link_with : lib)
+test('mytest', exe)
+```
+
+If you replace the dependency with a disabler object like this:
+
+```meson
+dep = disabler()
+lib = shared_library('mylib', 'mylib.c',
+  dependencies : dep)
+exe = executable('mytest', 'mytest.c',
+  link_with : lib)
+test('mytest', exe)
+```
+
+Then the shared library, executable and unit test are not
+created. This is a handy mechanism to cut down on the number of `if`
+statements.
+
+
+## Config-Tool based dependencies gained a method to get arbitrary options
+
+A number of dependencies (CUPS, LLVM, pcap, WxWidgets, GnuStep) use a
+config tool instead of pkg-config. As of this version they now have a
+`get_configtool_variable` method, which is analogous to the
+`get_pkgconfig_variable` for pkg config.
+
+```meson
+dep_llvm = dependency('LLVM')
+llvm_inc_dir = dep_llvm.get_configtool_variable('includedir')
+```
+
+## Embedded Python in Windows MSI packages
+
+Meson now ships an internal version of Python in the MSI installer
+packages. This means that it can run Python scripts that are part of
+your build transparently. That is, if you do the following:
+
+```meson
+myprog = find_program('myscript.py')
+```
+
+Then Meson will run the script with its internal Python version if necessary.
+
+## Libwmf dependency now supports libwmf-config
+
+Earlier, `dependency('libwmf')` could only detect the library with
+pkg-config files. Now, if pkg-config files are not found, Meson will
+look for `libwmf-config` and if it's found, will use that to find the
+library.

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/Release-notes-for-0.45.0.md Added

@@ -0,0 +1,203 @@
+---
+title: Release 0.45
+short-description: Release notes for 0.45
+...
+
+# New features
+
+## Python minimum version is now 3.5
+
+Meson will from this version on require Python version 3.5 or newer.
+
+## Config-Tool based dependencies can be specified in a cross file
+
+Tools like LLVM and pcap use a config tool for dependencies, this is a
+script or binary that is run to get configuration information (cflags,
+ldflags, etc) from.
+
+These binaries may now be specified in the `binaries` section of a
+cross file.
+
+```ini
+binaries
+cc = ...
+llvm-config = '/usr/bin/llvm-config32'
+```
+
+## Visual Studio C# compiler support
+
+In addition to the Mono C# compiler we also support Visual Studio's C#
+compiler. Currently this is only supported on the Ninja backend.
+
+## Removed two deprecated features
+
+The standalone `find_library` function has been a no-op for a long
+time. Starting with this version it becomes a hard error.
+
+There used to be a keywordless version of `run_target` which looked
+like this:
+
+```meson
+run_target('targetname', 'command', 'arg1', 'arg2')
+```
+
+This is now an error. The correct format for this is now:
+
+```meson
+run_target('targetname',
+  command : 'command', 'arg1', 'arg2')
+```
+
+## Experimental FPGA support
+
+This version adds support for generating, analysing and uploading FPGA
+programs using the IceStorm
+toolchain(http://www.clifford.at/icestorm/). This support is
+experimental and is currently limited to the `iCE 40` series of FPGA
+chips.
+
+FPGA generation integrates with other parts of Meson seamlessly. As an
+example, here(https://github.com/jpakkane/lm32) is an example
+project that compiles a simple firmware into Verilog and combines that
+with an lm32 softcore processor.
+
+## Generator outputs can preserve directory structure
+
+Normally when generating files with a generator, Meson flattens the
+input files so they all go in the same directory. Some code
+generators, such as Protocol Buffers, require that the generated files
+have the same directory layout as the input files used to generate
+them. This can now be achieved like this:
+
+```meson
+g = generator(...) # Compiles protobuf sources
+generated = gen.process('com/mesonbuild/one.proto',
+  'com/mesonbuild/two.proto',
+  preserve_path_from : meson.current_source_dir())
+```
+
+This would cause the following files to be generated inside the target
+private directory:
+
+    com/mesonbuild/one.pb.h
+    com/mesonbuild/one.pb.cc
+    com/mesonbuild/two.pb.h
+    com/mesonbuild/two.pb.cc
+
+## Hexadecimal string literals
+
+Hexadecimal integer literals can now be used in build and option files.
+
+```meson
+int_255 = 0xFF
+```
+
+## b_ndebug : if-release
+
+The value `if-release` can be given for the `b_ndebug` project option.
+
+This will make the `NDEBUG` pre-compiler macro to be defined for
+release type builds as if the `b_ndebug` project option had had the
+value `true` defined for it.
+
+## `install_data()` defaults to `{datadir}/{projectname}`
+
+If `install_data()` is not given an `install_dir` keyword argument, the
+target directory defaults to `{datadir}/{projectname}` (e.g.
+`/usr/share/myproj`).
+
+## install_subdir() supports strip_directory
+
+If strip_directory=true install_subdir() installs directory contents
+instead of directory itself, stripping basename of the source directory.
+
+## Integer options
+
+There is a new integer option type with optional minimum and maximum
+values. It can be specified like this in the `meson_options.txt` file:
+
+```meson
+option('integer_option', type : 'integer', min : 0, max : 5, value : 3)
+```
+
+## New method meson.project_license()
+
+The `meson` builtin object now has a `project_license()` method that
+returns a list of all licenses for the project.
+
+## Rust cross-compilation
+
+Cross-compilation is now supported for Rust targets. Like other
+cross-compilers, the Rust binary must be specified in your cross file.
+It should specify a `--target` (as installed by `rustup target`) and a
+custom linker pointing to your C cross-compiler. For example:
+
+```ini
+binaries
+c = '/usr/bin/arm-linux-gnueabihf-gcc-7'
+rust = 
+    'rustc',
+    '--target', 'arm-unknown-linux-gnueabihf',
+    '-C', 'linker=/usr/bin/arm-linux-gnueabihf-gcc-7',
+
+```
+
+## Rust compiler-private library disambiguation
+
+When building a Rust target with Rust library dependencies, an
+`--extern` argument is now specified to avoid ambiguity between the
+dependency library, and any crates of the same name in `rustc`'s
+private sysroot.
+
+## Project templates
+
+Meson ships with predefined project templates. To start a new project
+from scratch, simply go to an empty directory and type:
+
+    meson init --name=myproject --type=executable --language=c
+
+## Improve test setup selection
+
+Test setups are now identified (also) by the project they belong to
+and it is possible to select the used test setup from a specific
+project. E.g.  to use a test setup `some_setup` from project
+`some_project` for all executed tests one can use
+
+    meson test --setup some_project:some_setup
+
+Should one rather want test setups to be used from the same project as
+where the current test itself has been defined, one can use just
+
+    meson test --setup some_setup
+
+In the latter case every (sub)project must have a test setup `some_setup`
+defined in it.
+
+## Can use custom targets as Windows resource files
+
+The `compile_resources()` function of the `windows` module can now be
+used on custom targets as well as regular files.
+
+## Can promote dependencies with wrap command
+
+The `promote` command makes it easy to copy nested dependencies to the
+top level.
+
+    meson wrap promote scommon
+
+This will search the project tree for a subproject called `scommon`
+and copy it to the top level.
+
+If there are many embedded subprojects with the same name, you have to
+specify which one to promote manually like this:
+
+    meson wrap promote subprojects/s1/subprojects/scommon
+
+## Yielding subproject option to superproject
+
+Normally project options are specific to the current project. However
+sometimes you want to have an option whose value is the same over all
+projects. This can be achieved with the new `yield` keyword for
+options. When set to `true`, getting the value of this option in
+`meson.build` files gets the value from the option with the same name
+in the master project (if such an option exists).

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/Release-notes-for-0.46.0.md Added

@@ -0,0 +1,329 @@
+---
+title: Release 0.46
+short-description: Release notes for 0.46
+...
+
+# New features
+
+## Allow early return from a script
+
+Added the function `subdir_done()`. Its invocation exits the current
+script at the point of invocation. All previously invoked build
+targets and commands are build/executed. All following ones are
+ignored. If the current script was invoked via `subdir()` the parent
+script continues normally.
+
+## Log output slightly changed
+
+The format of some human-readable diagnostic messages has changed in
+minor ways. In case you are parsing these messages, you may need to
+adjust your code.
+
+## ARM compiler for C and CPP
+
+Cross-compilation is now supported for ARM targets using ARM compiler
+- ARMCC. The current implementation does not support shareable
+libraries. The default extension of the output is .axf. The
+environment path should be set properly for the ARM compiler
+executables. The '--cpu' option with the appropriate target type
+should be mentioned in the cross file as shown in the snippet below.
+
+```ini
+properties
+c_args      = '--cpu=Cortex-M0plus'
+cpp_args    = '--cpu=Cortex-M0plus'
+
+```
+
+## Building both shared and static libraries
+
+A new function `both_libraries()` has been added to build both shared
+and static libraries at the same time. Source files will be compiled
+only once and object files will be reused to build both shared and
+static libraries, unless `b_staticpic` user option or `pic:` keyword
+argument are set to false in which case sources will be compiled
+twice.
+
+The returned `buildtarget` object always represents the shared library.
+
+## Compiler object can now be passed to run_command()
+
+This can be used to run the current compiler with the specified
+arguments to obtain additional information from it. One of the use
+cases is to get the location of development files for the GCC plugins:
+
+```meson
+cc = meson.get_compiler('c')
+result = run_command(cc, '-print-file-name=plugin')
+plugin_dev_path = result.stdout().strip()
+```
+
+## declare_dependency() now supports `link_whole:`
+
+`declare_dependency()` now supports the `link_whole:` keyword argument which
+transparently works for build targets which use that dependency.
+
+## Old command names are now errors
+
+The old executable names `mesonintrospect`, `mesonconf`,
+`mesonrewriter` and `mesontest` have been deprecated for a long time.
+Starting from this version they no longer do anything but instead
+always error out. All functionality is available as subcommands in the
+main `meson` binary.
+
+## Meson and meson configure now accept the same arguments
+
+Previously Meson required that builtin arguments (like prefix) be
+passed as `--prefix` to `meson` and `-Dprefix` to `meson configure`.
+`meson` now accepts -D form like `meson configure` has. `meson
+configure` also accepts the `--prefix` form, like `meson` has.
+
+## Recursively extract objects
+
+The `recursive:` keyword argument has been added to
+`extract_all_objects()`. When set to `true` it will also return
+objects passed to the `objects:` argument of this target. By default
+only objects built for this target are returned to maintain backward
+compatibility with previous versions. The default will eventually be
+changed to `true` in a future version.
+
+```meson
+lib1 = static_library('a', 'source.c', objects : 'prebuilt.o')
+lib2 = static_library('b', objects : lib1.extract_all_objects(recursive : true))
+```
+
+## Can override find_program()
+
+It is now possible to override the result of `find_program` to point
+to a custom program you want. The overriding is global and applies to
+every subproject from there on. Here is how you would use it.
+
+In master project
+
+```meson
+subproject('mydep')
+```
+
+In the called subproject:
+
+```meson
+prog = find_program('my_custom_script')
+meson.override_find_program('mycodegen', prog)
+```
+
+In master project (or, in fact, any subproject):
+
+```meson
+genprog = find_program('mycodegen')
+```
+
+Now `genprog` points to the custom script. If the dependency had come
+from the system, then it would point to the system version.
+
+You can also use the return value of `configure_file()` to override
+a program in the same way as above:
+
+```meson
+prog_script = configure_file(input : 'script.sh.in',
+                             output : 'script.sh',
+                             configuration : cdata)
+meson.override_find_program('mycodegen', prog_script)
+```
+
+## New functions: has_link_argument() and friends
+
+A new set of methods has been added to @compiler
+objects to test if the linker
+supports given arguments.
+
+- compiler.has_link_argument
+- compiler.has_multi_link_arguments
+- compiler.get_supported_link_arguments
+- compiler.first_supported_link_argument
+
+## "meson help" now shows command line help
+
+Command line parsing is now less surprising. "meson help" is now
+equivalent to "meson --help" and "meson help <subcommand>" is
+equivalent to "meson <subcommand> --help", instead of creating a build
+directory called "help" in these cases.
+
+## Autogeneration of simple meson.build files
+
+A feature to generate a meson.build file compiling given C/C++ source
+files into a single executable has been added to "meson init". By
+default, it will take all recognizable source files in the current
+directory. You can also specify a list of dependencies with the -d
+flag and automatically invoke a build with the -b flag to check if the
+code builds with those dependencies.
+
+For example,
+
+```meson
+meson init -fbd sdl2,gl
+```
+
+will look for C or C++ files in the current directory, generate a
+meson.build for them with the dependencies of sdl2 and gl and
+immediately try to build it, overwriting any previous meson.build and
+build directory.
+
+## install_data() supports `rename:`
+
+The `rename:` keyword argument is used to change names of the installed
+files. Here's how you install and rename the following files:
+
+- `file1.txt` into `share/myapp/dir1/data.txt`
+- `file2.txt` into `share/myapp/dir2/data.txt`
+
+```meson
+install_data('file1.txt', 'file2.txt',
+             rename : 'dir1/data.txt', 'dir2/data.txt',
+             install_dir : 'share/myapp')
+```
+
+## Support for lcc compiler for e2k (Elbrus) architecture
+
+In this version, a support for lcc compiler for Elbrus processors
+based on e2k
+microarchitecture(https://en.wikipedia.org/wiki/Elbrus_2000) has been
+added.
+
+Examples of such CPUs:
+* Elbrus-8S(https://en.wikipedia.org/wiki/Elbrus-8S);
+* Elbrus-4S;
+* Elbrus-2S+(https://en.wikipedia.org/wiki/Elbrus-2S%2B).
+
+Such compiler have a similar behavior as gcc (basic option compatibility),
+but, in is not strictly compatible with gcc as of current version.
+
+Major differences as of version 1.21.22:
+* it does not support LTO and PCH;
+* it suffers from the same dependency file creation error as icc;
+* it has minor differences in output, especially version output;
+* it differently reacts to lchmod() detection;
+* some backend messages are produced in ru_RU.KOI8-R even if LANG=C;
+* its preprocessor treats some characters differently.
+
+So every noted difference is properly handled now in Meson.
+
+## String escape character sequence update
+
+Single-quoted strings in Meson have been taught the same set of escape
+sequences as in Python. It is therefore now possible to use arbitrary
+bytes in strings, like for example `NUL` (`\0`) and other ASCII
+control characters. See the chapter about *Strings* in
+*Syntax*(Syntax.md#strings) for more details.
+
+Potential backwards compatibility issue: Any valid escape sequence
+according to the new rules will be interpreted as an escape sequence
+instead of the literal characters. Previously only the following
+escape sequences were supported in single-quote strings: `\'`, `\\`
+and `\n`.
+
+Note that the behaviour of triple-quoted (multiline) strings has not
+changed. They behave like raw strings and do not support any escape
+sequences.
+
+## New `forcefallback` wrap mode
+
+A new wrap mode was added, `--wrap-mode=forcefallback`. When this is
+set, dependencies for which a fallback was provided will always use
+it, even if an external dependency exists and satisfies the version
+requirements.
+
+## Relaxing of target name requirements
+
+In earlier versions of Meson you could only have one target of a given
+name for each type. For example you could not have two executables
+named `foo`. This requirement is now relaxed so that you can have
+multiple targets with the same name, as long as they are in different
+subdirectories.
+
+Note that projects that have multiple targets with the same name can
+not be built with the `flat` layout or any backend that writes outputs
+in the same directory.
+
+## Addition of OpenMP dependency
+
+An OpenMP dependency (`openmp`) has been added that encapsulates the
+various flags used by compilers to enable OpenMP and checks for the
+existence of the `omp.h` header. The `language` keyword may be passed
+to force the use of a specific compiler for the checks.
+
+## Added new partial_dependency method to dependencies and libraries
+
+It is now possible to use only part of a dependency in a target. This
+allows, for example, to only use headers with convenience libraries to
+avoid linking to the same library multiple times.
+
+```meson
+dep = dependency('xcb')
+
+helper = static_library(
+  'helper',
+  'helper1.c', 'helper2.c',
+  dependencies : dep.partial_dependency(includes : true),
+
+
+final = shared_library(
+  'final',
+  'final.c',
+  dependencyes : dep,
+)
+```
+
+A partial dependency will have the same name version as the full
+dependency it is derived from, as well as any values requested.
+
+## Improved generation of pkg-config files for static only libraries.
+
+Previously pkg-config files generated by the pkgconfig modules for
+static libraries with dependencies could only be used in a
+dependencies with `static: true`.
+
+Now the generated file contains the needed dependencies libraries
+directly within `Requires` and `Libs` for build static libraries
+passed via the `libraries` keyword argument.
+
+Projects that install both a static and a shared version of a library
+should use the result of
+both_libraries to the
+pkg-config file generator or use
+configure_file for more
+complicated setups.
+
+## Improvements to pkgconfig module
+
+A `StaticLibrary` or `SharedLibrary` object can optionally be passed
+as first positional argument of the `generate()` method. If one is provided a
+default value will be provided for all required fields of the pc file:
+- `install_dir` is set to `pkgconfig` folder in the same location than the provided library.
+- `description` is set to the project's name followed by the library's name.
+- `name` is set to the library's name.
+
+Generating a .pc file is now as simple as:
+
+```meson
+pkgconfig.generate(mylib)
+```
+
+## pkgconfig.generate() requires parameters non-string arguments
+
+`pkgconfig.generate()` `requires:` and `requires_private:` keyword
+arguments now accept pkgconfig-dependencies and libraries that
+pkgconfig-files were generated for.
+
+## Generic python module
+
+Meson now has is a revamped and generic (python 2 and 3) version of
+the python3 module. With this new interface(Python-module.md),
+projects can now fully specify the version of python they want to
+build against / install sources to, and can do so against multiple
+major or minor versions in parallel.
+
+## test() now supports the `depends:` keyword argument
+
+Build targets and custom targets can be listed in the `depends:`
+keyword argument of test function. These targets will be built before
+test is run even if they have `build_by_default : false`.

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/Release-notes-for-0.47.0.md Added

@@ -0,0 +1,312 @@
+---
+title: Release 0.47
+short-description: Release notes for 0.47
+...
+
+# New features
+
+## Allow early return from a script
+
+Added the function `subdir_done()`. Its invocation exits the current
+script at the point of invocation. All previously invoked build
+targets and commands are build/executed. All following ones are
+ignored. If the current script was invoked via `subdir()` the parent
+script continues normally.
+
+## Concatenate string literals returned from `get_define()`
+
+After obtaining the value of a preprocessor symbol consecutive string
+literals are merged into a single string literal. For example a
+preprocessor symbol's value `"ab" "cd"` is returned as `"abcd"`.
+
+## ARM compiler(version 6) for C and CPP
+
+Cross-compilation is now supported for ARM targets using ARM compiler
+version 6 - ARMCLANG. The required ARMCLANG compiler options for
+building a shareable library are not included in the current Meson
+implementation for ARMCLANG support, so it can not build shareable
+libraries. This current Meson implementation for ARMCLANG support can
+not build assembly files with arm syntax (we need to use armasm
+instead of ARMCLANG for the `.s` files with this syntax) and only
+supports GNU syntax.
+
+The default extension of the executable output is `.axf`. The
+environment path should be set properly for the ARM compiler
+executables. The `--target`, `-mcpu` options with the appropriate
+values should be mentioned in the cross file as shown in the snippet
+below.
+
+```ini
+properties
+c_args      = '--target=arm-arm-none-eabi', '-mcpu=cortex-m0plus'
+cpp_args    = '--target=arm-arm-none-eabi', '-mcpu=cortex-m0plus'
+```
+
+Note:
+- The current changes are tested on Windows only.
+- PIC support is not enabled by default for ARM,
+  if users want to use it, they need to add the required arguments
+  explicitly from cross-file(`c_args`/`cpp_args`) or some other way.
+
+## New base build option for LLVM (Apple) bitcode support
+
+When building with clang on macOS, you can now build your static and
+shared binaries with embedded bitcode by enabling the `b_bitcode`
+base option(Builtin-options.md#base-options) by passing
+`-Db_bitcode=true` to Meson.
+
+This is better than passing the options manually in the environment
+since Meson will automatically disable conflicting options such as
+`b_asneeded`, and will disable bitcode support on targets that don't
+support it such as `shared_module()`.
+
+Since this requires support in the linker, it is currently only
+enabled when using Apple ld. In the future it can be extended to clang
+on other platforms too.
+
+## New compiler check: `check_header()`
+
+The existing compiler check `has_header()` only checks if the header
+exists, either with the `__has_include` C++11 builtin, or by running
+the pre-processor.
+
+However, sometimes the header you are looking for is unusable on some
+platforms or with some compilers in a way that is only detectable at
+compile-time. For such cases, you should use `check_header()` which
+will include the header and run a full compile.
+
+Note that `has_header()` is much faster than `check_header()`, so it
+should be used whenever possible.
+
+## New action `copy:` for `configure_file()`
+
+In addition to the existing actions `configuration:` and `command:`,
+configure_file now accepts a
+keyword argument `copy:` which specifies a new action to copy the file
+specified with the `input:` keyword argument to a file in the build
+directory with the name specified with the `output:` keyword argument.
+
+These three keyword arguments are, as before, mutually exclusive. You
+can only do one action at a time.
+
+## New keyword argument `encoding:` for `configure_file()`
+
+Add a new keyword to
+configure_file that allows
+the developer to specify the input and output file encoding. The
+default value is the same as before: UTF-8.
+
+In the past, Meson would not handle non-UTF-8/ASCII files correctly,
+and in the worst case would try to coerce it to UTF-8 and mangle the
+data. UTF-8 is the standard encoding now, but sometimes it is
+necessary to process files that use a different encoding.
+
+For additional details see #3135(https://github.com/mesonbuild/meson/pull/3135).
+
+## New keyword argument `output_format:` for `configure_file()`
+
+When called without an input file, `configure_file` generates a C
+header file by default. A keyword argument was added to allow
+specifying the output format, for example for use with nasm or yasm:
+
+```meson
+conf = configuration_data()
+conf.set('FOO', 1)
+
+configure_file('config.asm',
+  configuration: conf,
+  output_format: 'nasm')
+```
+
+## Substitutions in `custom_target(depfile:)`
+
+The `depfile` keyword argument to `custom_target` now accepts the `@BASENAME@`
+and `@PLAINNAME@` substitutions.
+
+## Deprecated `build_always:` for custom targets
+
+Setting `build_always` to `true` for a custom target not only marks
+the target to be always considered out of date, but also adds it to
+the set of default targets. This option is therefore deprecated and
+the new option `build_always_stale` is introduced.
+
+`build_always_stale` *only* marks the target to be always considered
+out of date, but does not add it to the set of default targets. The
+old behaviour can be achieved by combining `build_always_stale` with
+`build_by_default`.
+
+The documentation has been updated accordingly.
+
+## New built-in object type: dictionary
+
+Meson dictionaries use a syntax similar to python's dictionaries, but
+have a narrower scope: they are immutable, keys can only be string
+literals, and initializing a dictionary with duplicate keys causes a
+fatal error.
+
+Example usage:
+
+```meson
+d = {'foo': 42, 'bar': 'baz'}
+
+foo = d.get('foo')
+foobar = d.get('foobar', 'fallback-value')
+
+foreach key, value : d
+  Do something with key and value
+endforeach
+```
+
+## Array options treat `-Dopt=` and `-Dopt=` as equivalent
+
+Prior to this change passing -Dopt= to an array opt would be
+interpreted as `''` (an array with an empty string), now `-Dopt=` is
+the same as `-Dopt=`, an empty list.
+
+## Feature detection based on `meson_version:` in `project()`
+
+Meson will now print a `WARNING:` message during configuration if you
+use a function or a keyword argument that was added in a Meson version
+that's newer than the version specified inside `project()`. For
+example:
+
+```meson
+project('featurenew', meson_version: '>=0.43')
+
+cdata = configuration_data()
+cdata.set('FOO', 'bar')
+message(cdata.get_unquoted('FOO'))
+```
+
+This will output:
+
+```
+The Meson build system
+Version: 0.47.0.dev1
+Source dir: C:\path\to\srctree
+Build dir: C:\path\to\buildtree
+Build type: native build
+Project name: featurenew
+Project version: undefined
+Build machine cpu family: x86_64
+Build machine cpu: x86_64
+WARNING: Project targeting '>=0.43' but tried to use feature introduced in '0.44.0': configuration_data.get_unquoted()
+Message: bar
+Build targets in project: 0
+WARNING: Project specifies a minimum meson_version '>=0.43' which conflicts with:
+ * 0.44.0: {'configuration_data.get_unquoted()'}
+```
+
+## New type of build option for features
+
+A new type of option called `feature`(Build-options.md#features) can
+be defined in `meson_options.txt` for the traditional `enabled /
+disabled / auto` tristate. The value of this option can be passed to
+the `required` keyword argument of functions `dependency()`,
+`find_library()`, `find_program()` and `add_languages()`.
+
+A new global option `auto_features` has been added to override the
+value of all `auto` features. It is intended to be used by packagers
+to have full control on which feature must be enabled or disabled.
+
+## New options to `gnome.gdbus_codegen()`
+
+You can now pass additional arguments to gdbus-codegen using the
+`extra_args` keyword. This is the same for the other gnome function
+calls.
+
+Meson now automatically adds autocleanup support to the generated
+code. This can be modified by setting the autocleanup keyword.
+
+For example:
+
+```meson
+sources += gnome.gdbus_codegen('com.mesonbuild.Test',
+  'com.mesonbuild.Test.xml',
+  autocleanup : 'none',
+  extra_args : '--pragma-once')
+```
+
+## Made 'install' a top level Meson command
+
+You can now run `meson install` in your build directory and it will do
+the install. It has several command line options you can toggle the
+behaviour that is not in the default `ninja install` invocation. This
+is similar to how `meson test` already works.
+
+For example, to install only the files that have changed, you can do:
+
+```console
+$ meson install --only-changed
+```
+
+## `install_mode:` keyword argument extended to all installable targets
+
+It is now possible to pass an `install_mode` argument to all
+installable targets, such as `executable()`, libraries, headers, man
+pages and custom/generated targets.
+
+The `install_mode` argument can be used to specify the file mode in
+symbolic format and optionally the owner/uid and group/gid for the
+installed files.
+
+## New built-in option `install_umask` with a default value 022
+
+This umask is used to define the default permissions of files and
+directories created in the install tree. Files will preserve their
+executable mode, but the exact permissions will obey the
+`install_umask`.
+
+The `install_umask` can be overridden in the Meson command-line:
+
+```console
+$ meson --install-umask=027 builddir/
+```
+
+A project can also override the default in the `project()` call:
+
+```meson
+project('myproject', 'c',
+  default_options : 'install_umask=027')
+```
+
+To disable the `install_umask`, set it to `preserve`, in which case
+permissions are copied from the files in their origin.
+
+## Octal and binary string literals
+
+Octal and binary integer literals can now be used in build and option files.
+
+```meson
+int_493 = 0o755
+int_1365 = 0b10101010101
+```
+
+## New keyword arguments: 'check' and 'capture' for `run_command()`
+
+If `check:` is `true`, then the configuration will fail if the command
+returns a non-zero exit status. The default value is `false` for
+compatibility reasons.
+
+`run_command()` used to always capture the output and stored it for
+use in build files. However, sometimes the stdout is in a binary
+format which is meant to be discarded. For that case, you can now set
+the `capture:` keyword argument to `false`.
+
+## Windows resource files dependencies
+
+The `compile_resources()` function of the `windows` module now takes
+the `depend_files:` and `depends:` keywords.
+
+When using binutils's `windres`, dependencies on files `#include`'d by
+the preprocessor are now automatically tracked.
+
+## Polkit support for privileged installation
+
+When running `install`, if installation fails with a permission error
+and `pkexec` is available, Meson will attempt to use it to spawn a
+permission dialog for privileged installation and retry the
+installation.
+
+If `pkexec` is not available, the old behaviour is retained and you
+will need to explicitly run the install step with `sudo`.

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/Release-notes-for-0.48.0.md Added

@@ -0,0 +1,343 @@
+---
+title: Release 0.48
+short-description: Release notes for 0.48
+...
+
+# New features
+
+## Toggles for build type, optimization and vcrt type
+
+Since the very beginning Meson has provided different project types to
+use, such as *debug* and *minsize*. There is also a *plain* type that
+adds nothing by default but instead makes it the user's responsibility
+to add everything by hand. This works but is a bit tedious.
+
+In this release we have added new new options to manually toggle e.g.
+optimization levels and debug info so those can be changed
+independently of other options. For example by default the debug
+buildtype has no optimization enabled at all. If you wish to use GCC's
+`-Og` instead, you could set it with the following command:
+
+```
+meson configure -Doptimization=g
+```
+
+Similarly we have added a toggle option to select the version of
+Visual Studio C runtime to use. By default it uses the debug runtime
+DLL debug builds and release DLL for release builds but this can be
+manually changed with the new base option `b_vscrt`.
+
+## Meson warns if two calls to `configure_file()` write to the same file
+
+If two calls to
+configure_file write to the
+same file Meson will print a `WARNING:` message during configuration.
+For example:
+
+```meson
+project('configure_file', 'cpp')
+
+configure_file(
+  input: 'a.in',
+  output: 'out',
+  command: './foo.sh'
+)
+configure_file(
+  input: 'a.in',
+  output: 'out',
+  command: './foo.sh'
+)
+```
+
+This will output:
+
+```
+The Meson build system
+Version: 0.47.0.dev1
+Source dir: /path/to/srctree
+Build dir: /path/to/buildtree
+Build type: native build
+Project name: configure_file
+Project version: undefined
+Build machine cpu family: x86_64
+Build machine cpu: x86_64
+Configuring out with command
+WARNING: Output file out for configure_file overwritten. First time written in line 3 now in line 8
+Configuring out with command
+Build targets in project: 0
+Found ninja-1.8.2 at /usr/bin/ninja
+```
+
+## New kwarg `console` for `custom_target()`
+
+This keyword argument conflicts with `capture`, and is meant for
+commands that are resource-intensive and take a long time to
+finish. With the Ninja backend, setting this will add this target to
+Ninja's `console`
+pool(https://ninja-build.org/manual.html#_the_literal_console_literal_pool),
+which has special properties such as not buffering stdout and
+serializing all targets in this pool.
+
+The primary use-case for this is to be able to run external commands
+that take a long time to exeute. Without setting this, the user does
+not receive any feedback about what the program is doing.
+
+## `dependency(version:)` now applies to all dependency types
+
+Previously, version constraints were only enforced for dependencies
+found using the pkg-config dependency provider. These constraints now
+apply to dependencies found using any dependency provider.
+
+Some combinations of dependency, host and method do not currently
+support discovery of the version. In these cases, the dependency will
+not be found if a version constraint is applied, otherwise the
+`version()` method for the dependency object will return `'unknown'`.
+
+(If discovering the version in one of these combinations is important
+to you, and a method exists to determine the version in that case,
+please file an issue with as much information as possible.)
+
+## python3 module is deprecated
+
+A generic module `python` has been added in Meson `0.46.0` and has a superset of
+the features implemented by the previous `python3` module.
+
+In most cases, it is a simple matter of renaming:
+```meson
+py3mod = import('python3')
+python = py3mod.find_python()
+```
+
+becomes
+
+```meson
+pymod = import('python')
+python = pymod.find_installation()
+```
+
+## Dictionary addition
+
+Dictionaries can now be added, values from the second dictionary overrides values
+from the first
+
+```meson
+d1 = {'a' : 'b'}
+d3 = d1 + {'a' : 'c'}
+d3 += {'d' : 'e'}
+```
+
+## Dist scripts
+
+You can now specify scripts that are run as part of the `dist`
+target. An example usage would go like this:
+
+```meson
+project('foo', 'c')
+
+# other stuff here
+
+meson.add_dist_script('dist_cleanup.py')
+```
+
+## Fatal warnings
+
+A new command line option has been added: `--fatal-meson-warnings`.
+When enabled, any warning message printed by Meson will be fatal and
+raise an exception. It is intended to be used by developers and CIs to
+easily catch deprecation warnings, or any other potential issues.
+
+## Helper methods added for checking GNU style attributes: `__attribute__(...)`
+
+A set of new helpers have been added to the C and C++ compiler objects
+for checking GNU style function attributes. These are not just simpler
+to use, they may be optimized to return fast on compilers that don't
+support these attributes. Currently this is true for MSVC.
+
+```meson
+cc = meson.get_compiler('c')
+if cc.has_function_attribute('aligned')
+   add_project_arguments('-DHAVE_ALIGNED', language : 'c')
+endif
+```
+
+Would replace code like:
+
+```meson
+if cc.compiles('''into foo(void) __attribute__((aligned(32)))''')
+   add_project_arguments('-DHAVE_ALIGNED', language : 'c')
+endif
+```
+
+Additionally, a multi argument version has been added:
+
+```meson
+foreach s : cc.get_supported_function_attributes('hidden', 'alias')
+   add_project_arguments('-DHAVE_@0@'.format(s.to_upper()), language : 'c')
+endforeach
+```
+
+## `gnome.generate_gir()` now optionally accepts multiple libraries
+
+The GNOME module can now generate a single gir for multiple libraries,
+which is something `g-ir-scanner` supported, but had not been exposed
+yet.
+
+gnome.generate_gir() will now accept multiple positional arguments, if
+none of these arguments are an `Executable` instance.
+
+## Hotdoc module
+
+A new module has been written to ease generation of
+hotdoc(https://hotdoc.github.io/) based documentation. It supports
+complex use cases such as hotdoc subprojects (to create documentation
+portals) and makes it straight forward to leverage full capabilities
+of hotdoc.
+
+Simple usage:
+
+``` meson
+hotdoc = import('hotdoc')
+
+hotdoc.generate_doc(
+  'foobar',
+  c_smart_index: true,
+  project_version: '0.1',
+  sitemap: 'sitemap.txt',
+  index: 'index.md',
+  c_sources: 'path/to/file.c',
+  languages: 'c',
+  install: true,
+)
+```
+
+## `i18n.merge_file()` now fully supports variable substitutions defined in `custom_target()`
+
+Filename substitutions like @BASENAME@ and @PLAINNAME@ were previously
+accepted but the name of the build target wasn't altered leading to
+colliding target names when using the substitution twice.
+i18n.merge_file() now behaves as custom_target() in this regard.
+
+## Projects args can be set separately for cross and native builds (potentially breaking change)
+
+It has been a longstanding bug (or let's call it a "delayed bug fix")
+that if you do this:
+
+```meson
+add_project_arguments('-DFOO', language : 'c')
+```
+
+Then the flag is used both in native and cross compilations. This is
+very confusing and almost never what you want. To fix this a new
+keyword `native` has been added to all functions that add arguments,
+namely `add_global_arguments`, `add_global_link_arguments`,
+`add_project_arguments` and `add_project_link_arguments` that behaves
+like the following:
+
+```meson
+# Added to native builds when compiling natively and to cross
+# compilations when doing cross compiles.
+add_project_arguments(...)
+
+# Added only to native compilations, not used in cross compilations.
+add_project_arguments(..., native : true)
+
+# Added only to cross compilations, not used in native compilations.
+add_project_arguments(..., native : false)
+```
+
+Also remember that cross compilation is a property of each target.
+There can be target that are compiled with the native compiler and
+some which are compiled with the cross compiler.
+
+Unfortunately this change is backwards incompatible and may cause some
+projects to fail building. However this should be very rare in
+practice.
+
+## More flexible `override_find_program()`.
+
+It is now possible to pass an `executable` to
+`override_find_program()` if the overridden program is not used during
+configure.
+
+This is particularly useful for fallback dependencies like Protobuf
+that also provide a tool like protoc.
+
+## `shared_library()` now supports setting dylib compatibility and current version
+
+Now, by default `shared_library()` sets `-compatibility_version` and
+`-current_version` of a macOS dylib using the `soversion`.
+
+This can be overridden by using the `darwin_versions:` kwarg to
+shared_library. As usual,
+you can also pass this kwarg to `library()` or `build_target()` and it
+will be used in the appropriate circumstances.
+
+## Version comparison
+
+`dependency(version:)` and other version constraints now handle
+versions containing non-numeric characters better, comparing versions
+using the rpmvercmp algorithm (as using the `pkg-config` autoconf
+macro `PKG_CHECK_MODULES` does).
+
+This is a breaking change for exact comparison constraints which rely
+on the previous comparison behaviour of extending the compared
+versions with `'0'` elements, up to the same length of `'.'`-separated
+elements.
+
+For example, a version of `'0.11.0'` would previously match a version
+constraint of `'==0.11'`, but no longer does, being instead considered
+strictly greater.
+
+Instead, use a version constraint which exactly compares with the
+precise version required, e.g. `'==0.11.0'`.
+
+## Keyword argument for GNU symbol visibility
+
+Build targets got a new keyword, `gnu_symbol_visibility` that controls
+how symbols are exported from shared libraries. This is most commonly
+used to hide implementation symbols like this:
+
+```meson
+shared_library('mylib', ...
+  gnu_symbol_visibility: 'hidden')
+```
+
+In this case only symbols explicitly marked as visible in the source
+files get exported.
+
+## Git wraps can now clone submodules automatically
+
+To enable this, the following needs to be added to the `.wrap` file:
+
+```ini
+clone-recursive=true
+```
+
+## `subproject()` function now supports the `required:` kwarg
+
+This allows you to declare an optional subproject. You can now call
+`found()` on the return value of the `subproject()` call to see if the
+subproject is available before calling `get_variable()` to fetch
+information from it.
+
+## `dependency()` objects now support the `.name()` method
+
+You can now fetch the name of the dependency that was searched like
+so:
+
+```meson
+glib_dep = dependency('glib-2.0')
+...
+message("dependency name is " + glib_dep.name())
+# This outputs `dependency name is glib-2.0`
+
+qt_dep = dependency('qt5')
+...
+message("dependency name is " + qt_dep.name())
+# This outputs `dependency name is qt5`
+
+decl_dep = declare_dependency()
+...
+message("dependency name is " + decl_dep.name())
+# This outputs `dependency name is internal`
+```

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/Release-notes-for-0.49.0.md Added

@@ -0,0 +1,327 @@
+---
+title: Release 0.49
+short-description: Release notes for 0.49
+...
+
+# New features
+
+## Libgcrypt dependency now supports libgcrypt-config
+
+Earlier, `dependency('libgcrypt')` could only detect the library with
+pkg-config files. Now, if pkg-config files are not found, Meson will
+look for `libgcrypt-config` and if it's found, will use that to find
+the library.
+
+## New `section` key for the buildoptions introspection
+
+Meson now has a new `section` key in each build option. This allows
+IDEs to group these options similar to `meson configure`.
+
+The possible values for `section` are:
+
+ - core
+ - backend
+ - base
+ - compiler
+ - directory
+ - user
+ - test
+
+## CC-RX compiler for C and CPP
+
+Cross-compilation is now supported for Renesas RX targets with the
+CC-RX compiler.
+
+The environment path should be set properly for the CC-RX compiler
+executables. The `-cpu` option with the appropriate value should be
+mentioned in the cross-file as shown in the snippet below.
+
+```ini
+properties
+c_args      = '-cpu=rx600'
+cpp_args    = '-cpu=rx600'
+```
+
+The default extension of the executable output is `.abs`. Other target
+specific arguments to the compiler and linker will need to be added
+explicitly from the
+cross-file(`c_args`/`c_link_args`/`cpp_args`/`cpp_link_args`) or some
+other way. Refer to the CC-RX User's manual for additional compiler
+and linker options.
+
+## CMake `find_package` dependency backend
+
+Meson can now use the CMake `find_package` ecosystem to detect
+dependencies. Both the old-style `<NAME>_LIBRARIES` variables as well
+as imported targets are supported. Meson can automatically guess the
+correct CMake target in most cases but it is also possible to manually
+specify a target with the `modules` property.
+
+```meson
+# Implicitly uses CMake as a fallback and guesses a target
+dep1 = dependency('KF5TextEditor')
+
+# Manually specify one or more CMake targets to use
+dep2 = dependency('ZLIB', method : 'cmake', modules : 'ZLIB::ZLIB')
+```
+
+CMake is automatically used after `pkg-config` fails when
+no `method` (or `auto`) was provided in the dependency options.
+
+## New compiler method `get_argument_syntax`
+
+The compiler object now has `get_argument_syntax` method, which
+returns a string value of `gcc`, `msvc`, or an undefined value string
+value. This can be used to determine if a compiler uses gcc syntax
+(`-Wfoo`), msvc syntax (`/w1234`), or some other kind of arguments.
+
+```meson
+cc = meson.get_compiler('c')
+
+if cc.get_argument_syntax() == 'msvc'
+  if cc.has_argument('/w1235')
+    add_project_arguments('/w1235', language : 'c')
+  endif
+elif cc.get_argument_syntax() == 'gcc'
+  if cc.has_argument('-Wfoo')
+    add_project_arguments('-Wfoo', language : 'c')
+  endif
+elif cc.get_id() == 'some other compiler'
+  add_project_arguments('--error-on-foo', language : 'c')
+endif
+```
+
+## Return `Disabler()` instead of not-found object
+
+Functions such as `dependency()`, `find_library()`, `find_program()`,
+and `python.find_installation()` have a new keyword argument:
+`disabler`. When set to `true` those functions return `Disabler()`
+objects instead of not-found objects.
+
+## `introspect --projectinfo` can now be used without configured build directory
+
+This allows IDE integration to get information about the project
+before the user has configured a build directory.
+
+Before you could use `meson.py introspect --projectinfo
+build-directory`. Now you also can use `meson.py introspect
+--projectinfo project-dir/meson.build`.
+
+The output is similar to the output with a build directory but
+additionally also includes information from `introspect
+--buildsystem-files`.
+
+For example `meson.py introspect --projectinfo test\ cases/common/47\
+subproject\ options/meson.build` This outputs (pretty printed for
+readability):
+
+```
+{
+    "buildsystem_files": 
+        "meson_options.txt",
+        "meson.build"
+    ,
+    "name": "suboptions",
+    "version": null,
+    "descriptive_name": "suboptions",
+    "subprojects": 
+        {
+            "buildsystem_files": 
+                "subprojects/subproject/meson_options.txt",
+                "subprojects/subproject/meson.build"
+            ,
+            "name": "subproject",
+            "version": "undefined",
+            "descriptive_name": "subproject"
+        }
+    
+}
+```
+
+Both usages now include a new `descriptive_name` property which always
+shows the name set in the project.
+
+## Can specify keyword arguments with a dictionary
+
+You can now specify keyword arguments for any function and method call
+with the `kwargs` keyword argument. This is perhaps best described
+with an example:
+
+```meson
+options = {'include_directories': include_directories('inc')}
+
+...
+
+executable(...
+  kwargs: options)
+```
+
+The above code is identical to this:
+
+```meson
+executable(...
+  include_directories: include_directories('inc'))
+```
+
+That is, Meson will expand the dictionary given to `kwargs` as if the
+entries in it had been given as keyword arguments directly.
+
+Note that any individual argument can be specified either directly or
+with the `kwarg` dict but not both. If a key is specified twice, it
+is a hard error.
+
+## Manpages are no longer compressed implicitly
+
+Earlier, the `install_man` command has automatically compressed
+installed manpages into `.gz` format. This collided with manpage
+compression hooks already used by various distributions. Now, manpages
+are installed uncompressed and distributors are expected to handle
+compressing them according to their own compression preferences.
+
+## Native config files
+
+Native files (`--native-file`) are the counterpart to cross files
+(`--cross-file`), and allow specifying information about the build
+machine, both when cross compiling and when not.
+
+Currently the native files only allow specifying the names of
+binaries, similar to the cross file, for example:
+
+```ini
+binaries
+llvm-config = "/opt/llvm-custom/bin/llvm-config"
+```
+
+Will override the llvm-config used for *native* binaries. Targets for
+the host machine will continue to use the cross file.
+
+## Foreach `break` and `continue`
+
+`break` and `continue` keywords can be used inside foreach loops.
+
+```meson
+items = 'a', 'continue', 'b', 'break', 'c'
+result = 
+foreach i : items
+  if i == 'continue'
+    continue
+  elif i == 'break'
+    break
+  endif
+  result += i
+endforeach
+# result is 'a', 'b'
+```
+
+You can check if an array contains an element like this:
+```meson
+my_array = 1, 2
+if 1 in my_array
+# This condition is true
+endif
+if 1 not in my_array
+# This condition is false
+endif
+```
+
+You can check if a dictionary contains a key like this:
+```meson
+my_dict = {'foo': 42, 'foo': 43}
+if 'foo' in my_dict
+# This condition is true
+endif
+if 42 in my_dict
+# This condition is false
+endif
+if 'foo' not in my_dict
+# This condition is false
+endif
+```
+
+## Joining paths with /
+
+For clarity and conciseness, we recommend using the `/` operator to separate
+path elements:
+
+```meson
+joined = 'foo' / 'bar'
+```
+
+Before Meson 0.49, joining path elements was done with the legacy
+`join_paths` function, but the `/` syntax above is now recommended.
+
+```meson
+joined = join_paths('foo', 'bar')
+```
+
+This only works for strings.
+
+## Position-independent executables
+
+When `b_pie` option, or `executable()`'s `pie` keyword argument is set
+to `true`, position-independent executables are built. All their
+objects are built with `-fPIE` and the executable is linked with
+`-pie`. Any static library they link must be built with `pic` set to
+`true` (see `b_staticpic` option).
+
+## Deprecation warning in pkg-config generator
+
+All libraries passed to the `libraries` keyword argument of the
+`generate()` method used to be associated with that generated
+pkg-config file. That means that any subsequent call to `generate()`
+where those libraries appear would add the filebase of the
+`generate()` that first contained them into `Requires:` or
+`Requires.private:` field instead of adding an `-l` to `Libs:` or
+`Libs.private:`.
+
+This behaviour is now deprecated. The library that should be
+associated with the generated pkg-config file should be passed as
+first positional argument instead of in the `libraries` keyword
+argument. The previous behaviour is maintained but prints a
+deprecation warning and support for this will be removed in a future
+Meson release. If you can not create the needed pkg-config file
+without this warning, please file an issue with as much details as
+possible about the situation.
+
+For example this sample will write `Requires: liba` into `libb.pc` but
+print a deprecation warning:
+
+```meson
+liba = library(...)
+pkg.generate(libraries : liba)
+
+libb = library(...)
+pkg.generate(libraries : liba, libb)
+```
+
+It can be fixed by passing `liba` as first positional argument::
+```meson
+liba = library(...)
+pkg.generate(liba)
+
+libb = library(...)
+pkg.generate(libb, libraries : liba)
+```
+
+## Subprojects download, checkout, update command-line
+
+New command-line tool has been added to manage subprojects:
+
+- `meson subprojects download` to download all subprojects that have a wrap file.
+- `meson subprojects update` to update all subprojects to latest version.
+- `meson subprojects checkout` to checkout or create a branch in all git subprojects.
+
+## New keyword argument `is_default` to `add_test_setup()`
+
+The keyword argument `is_default` may be used to set whether the test
+setup should be used by default whenever `meson test` is run without
+the `--setup` option.
+
+```meson
+add_test_setup('default', is_default: true, env: 'G_SLICE=debug-blocks')
+add_test_setup('valgrind', env: 'G_SLICE=always-malloc', ...)
+test('mytest', exe)
+```
+
+For the example above, running `meson test` and `meson test
+--setup=default` is now equivalent.

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/Release-notes-for-0.50.0.md Added

@@ -0,0 +1,350 @@
+---
+title: Release 0.50.0
+short-description: Release notes for 0.50.0
+...
+
+# New features
+
+## Added `cmake_module_path` and `cmake_args` to dependency
+
+The CMake dependency backend can now make use of existing
+`Find<name>.cmake` files by setting the `CMAKE_MODULE_PATH` with the
+new `dependency()` property `cmake_module_path`. The paths given to
+`cmake_module_path` should be relative to the project source
+directory.
+
+Furthermore the property `cmake_args` was added to give CMake
+additional parameters.
+
+## Added PGI compiler support
+
+Nvidia / PGI C, C++ and Fortran
+no-cost(https://www.pgroup.com/products/community.htm) compilers are
+now supported. They have been tested on Linux so far.
+
+
+
+## Fortran Coarray
+
+Fortran 2008 / 2018 coarray support was added via `dependency('coarray')`
+
+## Libdir defaults to `lib` when cross compiling
+
+Previously `libdir` defaulted to the value of the build machine such
+as `lib/x86_64-linux-gnu`, which is almost always incorrect when cross
+compiling. It now defaults to plain `lib` when cross compiling. Native
+builds remain unchanged and will point to the current system's library
+dir.
+
+## Native and Cross File Paths and Directories
+
+A new `paths` section has been added to native and cross files. This
+can be used to set paths such a prefix and libdir in a persistent way.
+
+## Add warning_level 0 option
+
+Adds support for a warning level 0 which does not enable any static
+analysis checks from the compiler
+
+## A builtin target to run clang-format
+
+If you have `clang-format` installed and there is a `.clang-format`
+file in the root of your master project, Meson will generate a run
+target called `clang-format` so you can reformat all files with one
+command:
+
+```meson
+ninja clang-format
+```
+
+
+## Added `.path()` method to object returned by `python.find_installation()`
+
+`ExternalProgram` objects as well as the object returned by the
+`python3` module provide this method, but the new `python` module did
+not.
+
+## Fix ninja console log from generators with multiple output nodes
+
+This resolves issue
+#4760(https://github.com/mesonbuild/meson/issues/4760) where a
+generator with multiple output nodes printed an empty string to the
+console
+
+## `introspect --buildoptions` can now be used without configured build directory
+
+It is now possible to run `meson introspect --buildoptions /path/to/meson.build`
+without a configured build directory.
+
+Running `--buildoptions` without a build directory produces the same
+output as running it with a freshly configured build directory.
+
+However, this behavior is not guaranteed if subprojects are
+present. Due to internal limitations all subprojects are processed
+even if they are never used in a real Meson run.  Because of this
+options for the subprojects can differ.
+
+## `include_directories` accepts a string
+
+The `include_directories` keyword argument now accepts plain strings
+rather than an include directory object. Meson will transparently
+expand it so that a declaration like this:
+
+```meson
+executable(..., include_directories: 'foo')
+```
+
+Is equivalent to this:
+
+```meson
+foo_inc = include_directories('foo')
+executable(..., include_directories: foo_inc)
+```
+
+## Fortran submodule support
+
+Initial support for Fortran `submodule` was added, where the submodule
+is in the same or different file than the parent `module`. The
+submodule hierarchy specified in the source Fortran code `submodule`
+statements are used by Meson to resolve source file dependencies. For
+example:
+
+```fortran
+submodule (ancestor:parent) child
+```
+
+
+## Add `subproject_dir` to `--projectinfo` introspection output
+
+This allows applications interfacing with Meson (such as IDEs) to know
+about an overridden subproject directory.
+
+## Find library with its headers
+
+The `find_library()` method can now also verify if the library's
+headers are found in a single call, using the `has_header()` method
+internally.
+
+```meson
+# Aborts if the 'z' library is found but not its header file
+zlib = find_library('z', has_headers : 'zlib.h')
+# Returns not-found if the 'z' library is found but not its header file
+zlib = find_library('z', has_headers : 'zlib.h', required : false)
+```
+
+Any keyword argument with the `header_` prefix passed to
+`find_library()` will be passed to the `has_header()` method with the
+prefix removed.
+
+```meson
+libfoo = find_library('foo',
+  has_headers : 'foo.h', 'bar.h',
+  header_prefix : '#include <baz.h>',
+  header_include_directories : include_directories('.'))
+```
+
+## NetCDF
+
+NetCDF support for C, C++ and Fortran is added via pkg-config.
+
+## Added the Flang compiler
+
+Flang(https://github.com/flang-compiler/flang/releases) Fortran
+compiler support was added.  As with other Fortran compilers, flang is
+specified using `FC=flang meson ..` or similar.
+
+## New `not_found_message` for `dependency()`
+
+You can now specify a `not_found_message` that will be printed if the
+specified dependency was not found. The point is to convert constructs
+that look like this:
+
+```meson
+d = dependency('something', required: false)
+if not d.found()
+  message('Will not be able to do something.')
+endif
+```
+
+Into this:
+
+```meson
+d = dependency('something',
+  required: false,
+  not_found_message: 'Will not be able to do something.')
+```
+
+Or constructs like this:
+
+```meson
+d = dependency('something', required: false)
+if not d.found()
+  error('Install something by doing XYZ.')
+endif
+```
+
+into this:
+
+```meson
+d = dependency('something',
+  not_found_message: 'Install something by doing XYZ.')
+```
+
+Which works, because the default value of `required` is `true`.
+
+## Cuda support
+
+Compiling Cuda source code is now supported, though only with the
+Ninja backend. This has been tested only on Linux for now.
+
+Because NVidia's Cuda compiler does not produce `.d` dependency files,
+dependency tracking does not work.
+
+## `run_command()` accepts `env` kwarg
+
+You can pass @env
+object to run_command, just
+like to `test`:
+
+```meson
+env = environment()
+env.set('FOO', 'bar')
+run_command('command', 'arg1', 'arg2', env: env)
+```
+
+## `extract_objects:` accepts `File` arguments
+
+The `extract_objects` function now supports File objects to tell it
+what to extract. Previously, file paths could only be passed as strings.
+
+## Changed the JSON format of the introspection
+
+All paths used in the Meson introspection JSON format are now
+absolute. This affects the `filename` key in the targets introspection
+and the output of `--buildsystem-files`.
+
+Furthermore, the `filename` and `install_filename` keys in the targets
+introspection are now lists of strings with identical length.
+
+The `--target-files` option is now deprecated, since the same information
+can be acquired from the `--tragets` introspection API.
+
+## Meson file rewriter
+
+This release adds the functionality to perform some basic modification
+on the `meson.build` files from the command line. The currently
+supported operations are:
+
+- For build targets:
+  - Add/Remove source files
+  - Add/Remove targets
+  - Modify a select set of kwargs
+  - Print some JSON information
+- For dependencies:
+  - Modify a select set of kwargs
+- For the project function:
+  - Modify a select set of kwargs
+  - Modify the default options list
+
+For more information see the rewriter documentation.
+
+## `introspect --scan-dependencies` can now be used to scan for dependencies used in a project
+
+It is now possible to run `meson introspect --scan-dependencies
+/path/to/meson.build` without a configured build directory to scan for
+dependencies.
+
+The output format is as follows:
+
+```json
+
+  {
+    "name": "The name of the dependency",
+    "required": true,
+    "conditional": false,
+    "has_fallback": false
+  }
+
+```
+
+The `required` keyword specifies whether the dependency is marked as
+required in the `meson.build` (all dependencies are required by
+default). The `conditional` key indicates whether the `dependency()`
+function was called inside a conditional block. In a real Meson run
+these dependencies might not be used, thus they _may_ not be required,
+even if the `required` key is set. The `has_fallback` key just
+indicates whether a fallback was directly set in the `dependency()`
+function.
+
+## `introspect --targets` can now be used without configured build directory
+
+It is now possible to run `meson introspect --targets
+/path/to/meson.build` without a configured build directory.
+
+The generated output is similar to running the introspection with a
+build directory. However, there are some key differences:
+
+- The paths in `filename` now are _relative_ to the future build directory
+- The `install_filename` key is completely missing
+- There is only one entry in `target_sources`:
+  - With the language set to `unknown`
+  - Empty lists for `compiler` and `parameters` and `generated_sources`
+  - The `sources` list _should_ contain all sources of the target
+
+There is no guarantee that the sources list in `target_sources` is
+correct. There might be differences, due to internal limitations. It
+is also not guaranteed that all targets will be listed in the output.
+It might even be possible that targets are listed, which won't exist
+when Meson is run normally. This can happen if a target is defined
+inside an if statement. Use this feature with care.
+
+## Added option to introspect multiple parameters at once
+
+Meson introspect can now print the results of multiple introspection
+commands in a single call. The results are then printed as a single
+JSON object.
+
+The format for a single command was not changed to keep backward
+compatibility.
+
+Furthermore the option `-a,--all`, `-i,--indent` and
+`-f,--force-object-output` were added to print all introspection
+information in one go, format the JSON output (the default is still
+compact JSON) and force use the new output format, even if only one
+introspection command was given.
+
+A complete introspection dump is also stored in the `meson-info`
+directory. This dump will be (re)generated each time meson updates the
+configuration of the build directory.
+
+Additionlly the format of `meson introspect target` was changed:
+
+  - New: the `sources` key. It stores the source files of a target and their compiler parameters.
+  - New: the `defined_in` key. It stores the Meson file where a target is defined
+  - New: the `subproject` key. It stores the name of the subproject where a target is defined.
+  - Added new target types (`jar`, `shared module`).
+
+## `meson configure` can now print the default options of an unconfigured project
+
+With this release, it is also possible to get a list of all build
+options by invoking `meson configure` with the project source
+directory or the path to the root `meson.build`. In this case, Meson
+will print the default values of all options.
+
+## HDF5
+
+HDF5 support is added via pkg-config.
+
+## Added the `meson-info.json` introspection file
+
+Meson now generates a `meson-info.json` file in the `meson-info`
+directory to provide introspection information about the latest Meson
+run. This file is updated when the build configuration is changed and
+the build files are (re)generated.
+
+## New kwarg `install:` for `configure_file()`
+
+Previously when using `configure_file()`, you could install the
+outputted file by setting the `install_dir:` keyword argument. Now,
+there is an explicit kwarg `install:` to enable/disable it. Omitting
+it will maintain the old behaviour.

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/Release-notes-for-0.51.0.md Added

@@ -0,0 +1,337 @@
+---
+title: Release 0.51.0
+short-description: Release notes for 0.51.0
+...
+
+# New features
+
+## (C) Preprocessor flag handling
+
+Meson previously stored `CPPFLAGS` and per-language compilation flags
+separately. (That latter would come from `CFLAGS`, `CXXFLAGS`, etc.,
+along with `<lang>_args` options whether specified no the command-line
+interface (`-D..`), `meson.build` (`default_options`), or cross file
+(`properties`).) This was mostly unobservable, except for certain
+preprocessor-only checks like `check_header` would only use the
+preprocessor flags, leading to confusion if some `-isystem` was in
+`CFLAGS` but not `CPPFLAGS`. Now, they are lumped together, and
+`CPPFLAGS`, for the languages which are deemed to care to about, is
+just another source of compilation flags along with the others already
+listed.
+
+## Sanity checking compilers with user flags
+
+Sanity checks previously only used user-specified flags for cross
+compilers, but now do in all cases.
+
+All compilers Meson might decide to use for the build are "sanity
+checked" before other tests are run. This usually involves building
+simple executable and trying to run it. Previously user flags
+(compilation and/or linking flags) were used for sanity checking cross
+compilers, but not native compilers. This is because such flags might
+be essential for a cross binary to succeed, but usually aren't for a
+native compiler.
+
+In recent releases, there has been an effort to minimize the
+special-casing of cross or native builds so as to make building more
+predictable in less-tested cases. Since this the user flags are
+necessary for cross, but not harmful for native, it makes more sense
+to use them in all sanity checks than use them in no sanity checks, so
+this is what we now do.
+
+## New `sourceset` module
+
+A new module, `sourceset`, was added to help building many binaries
+from the same source files. Source sets associate source files and
+dependencies to keys in a `configuration_data` object or a dictionary;
+they then take multiple `configuration_data` objects or dictionaries,
+and compute the set of source files and dependencies for each of those
+configurations.
+
+## n_debug=if-release and buildtype=plain means no asserts
+
+Previously if this combination was used then assertions were enabled,
+which is fairly surprising behavior.
+
+## `target_type` in `build_targets` accepts the value 'shared_module'
+
+The `target_type` keyword argument in `build_target()` now accepts the
+value `'shared_module'`.
+
+The statement
+
+```meson
+build_target(..., target_type: 'shared_module')
+```
+
+is equivalent to this:
+
+```meson
+shared_module(...)
+```
+
+## New modules kwarg for python.find_installation
+
+This mirrors the modules argument that some kinds of dependencies
+(such as qt, llvm, and cmake based dependencies) take, allowing you to
+check that a particular module is available when getting a python
+version.
+
+```meson
+py = import('python').find_installation('python3', modules : 'numpy')
+```
+
+## Support for the Intel Compiler on Windows (ICL)
+
+Support has been added for ICL.EXE and ifort on windows. The support
+should be on part with ICC support on Linux/MacOS. The ICL C/C++
+compiler behaves like Microsoft's CL.EXE rather than GCC/Clang like
+ICC does, and has a different id, `intel-cl` to differentiate it.
+
+```meson
+cc = meson.get_compiler('c')
+if cc.get_id == 'intel-cl'
+  add_project_argument('/Qfoobar:yes', language : 'c')
+endif
+```
+
+## Added basic support for the Xtensa CPU toolchain
+
+You can now use `xt-xcc`, `xt-xc++`, `xt-nm`, etc... on your cross
+compilation file and Meson won't complain about an unknown toolchain.
+
+
+## Dependency objects now have a get_variable method
+
+This is a generic replacement for type specific variable getters such as
+`ConfigToolDependency.get_configtool_variable` and
+`PkgConfigDependency.get_pkgconfig_variable`, and is the only way to query
+such variables from cmake dependencies.
+
+This method allows you to get variables without knowing the kind of
+dependency you have.
+
+```meson
+dep = dependency('could_be_cmake_or_pkgconfig')
+# cmake returns 'YES', pkg-config returns 'ON'
+if 'YES', 'ON'.contains(dep.get_variable(pkgconfig : 'var-name', cmake : 'COP_VAR_NAME', default_value : 'NO'))
+  error('Cannot build your project when dep is built with var-name support')
+endif
+```
+
+## CMake prefix path overrides
+
+When using pkg-config as a dependency resolver we can pass
+`-Dpkg_config_path=$somepath` to extend or overwrite where pkg-config
+will search for dependencies. Now cmake can do the same, as long as
+the dependency uses a ${Name}Config.cmake file (not a
+Find{$Name}.cmake file), by passing
+`-Dcmake_prefix_path=list,of,paths`. It is important that point this
+at the prefix that the dependency is installed into, not the cmake
+path.
+
+If you have installed something to `/tmp/dep`, which has a layout like:
+```
+/tmp/dep/lib/cmake
+/tmp/dep/bin
+```
+
+then invoke Meson as `meson setup builddir/ -Dcmake_prefix_path=/tmp/dep`
+
+## Tests that should fail but did not are now errors
+
+You can tag a test as needing to fail like this:
+
+```meson
+test('shoulfail', exe, should_fail: true)
+```
+
+If the test passes the problem is reported in the error logs but due
+to a bug it was not reported in the test runner's exit code. Starting
+from this release the unexpected passes are properly reported in the
+test runner's exit code. This means that test runs that were passing
+in earlier versions of Meson will report failures with the current
+version. This is a good thing, though, since it reveals an error in
+your test suite that has, until now, gone unnoticed.
+
+## New target keyword argument: `link_language`
+
+There may be situations for which the user wishes to manually specify
+the linking language.  For example, a C++ target may link C, Fortran,
+etc. and perhaps the automatic detection in Meson does not pick the
+desired compiler.  The user can manually choose the linker by language
+per-target like this example of a target where one wishes to link with
+the Fortran compiler:
+
+```meson
+executable(..., link_language : 'fortran')
+```
+
+A specific case this option fixes is where for example the main
+program is Fortran that calls C and/or C++ code. The automatic
+language detection of Meson prioritizes C/C++, and so an compile-time
+error results like `undefined reference to main`, because the linker
+is C or C++ instead of Fortran, which is fixed by this per-target
+override.
+
+## New module to parse kconfig output files
+
+The new module `unstable-kconfig` adds the ability to parse and use
+kconfig output files from `meson.build`.
+
+
+## Add new `meson subprojects foreach` command
+
+`meson subprojects` has learned a new `foreach` command which accepts
+a command with arguments and executes it in each subproject directory.
+
+For example this can be useful to check the status of subprojects
+(e.g. with `git status` or `git diff`) before performing other actions
+on them.
+
+
+## Added c17 and c18 as c_std values for recent GCC and Clang Versions
+
+For gcc version 8.0 and later, the values c17, c18, gnu17, and gnu18
+were added to the accepted values for built-in compiler option c_std.
+
+For Clang version 10.0 and later on Apple OSX (Darwin), and for
+version 7.0 and later on other platforms, the values c17 and gnu17
+were added as c_std values.
+
+## gpgme dependency now supports gpgme-config
+
+Previously, we could only detect GPGME with custom invocations of
+`gpgme-config` or when the GPGME version was recent enough (>=1.13.0)
+to install pkg-config files. Now we added support to Meson allowing us
+to use `dependency('gpgme')` and fall back on `gpgme-config` parsing.
+
+## Can link against custom targets
+
+The output of `custom_target` and `custom_targeti` can be used in
+`link_with` and `link_whole` keyword arguments. This is useful for
+integrating custom code generator steps, but note that there are many
+limitations:
+
+ - Meson can not know about link dependencies of the custom target. If
+   the target requires further link libraries, you need to add them manually
+
+ - The user is responsible for ensuring that the code produced by
+   different toolchains are compatible.
+
+ - `custom_target` may only be used when it has a single output file.
+   Use `custom_targeti` when dealing with multiple output files.
+
+ - The output file must have the correct file name extension.
+
+
+## Removed the deprecated `--target-files` API
+
+The `--target-files` introspection API is now no longer available. The same
+information can be queried with the `--targets` API introduced in 0.50.0.
+
+## Generators have a new `depends` keyword argument
+
+Generators can now specify extra dependencies with the `depends`
+keyword argument. It matches the behaviour of the same argument in
+other functions and specifies that the given targets must be built
+before the generator can be run. This is used in cases such as this
+one where you need to tell a generator to indirectly invoke a
+different program.
+
+```meson
+exe = executable(...)
+cg = generator(program_runner,
+    output: '@BASENAME@.c',
+    arguments: '--use-tool=' + exe.full_path(), '@INPUT@', '@OUTPUT@',
+    depends: exe)
+```
+
+## Specifying options per mer machine
+
+Previously, no cross builds were controllable from the command line.
+Machine-specific options like the pkg-config path and compiler options
+only affected native targets, that is to say all targets in native
+builds, and `native: true` targets in cross builds. Now, prefix the
+option with `build.` to affect build machine targets, and leave it
+unprefixed to affect host machine targets.
+
+For those trying to ensure native and cross builds to the same
+platform produced the same result, the old way was frustrating because
+very different invocations were needed to affect the same targets, if
+it was possible at all. Now, the same command line arguments affect
+the same targets everywhere --- Meson is closer to ignoring whether
+the "overall" build is native or cross, and just caring about whether
+individual targets are for the build or host machines.
+
+
+## subproject.get_variable() now accepts a `fallback` argument
+
+Similar to `get_variable`, a fallback argument can now be passed to
+`subproject.get_variable()`, it will be returned if the requested
+variable name did not exist.
+
+``` meson
+var = subproject.get_variable('does-not-exist', 'fallback-value')
+```
+
+## Add keyword `static` to `find_library`
+
+`find_library` has learned the `static` keyword. They keyword must be
+a boolean, where `true` only searches for static libraries and `false`
+only searches for dynamic/shared. Leaving the keyword unset will keep
+the old behavior of first searching for dynamic and then falling back
+to static.
+
+## Fortran `include` statements recursively parsed
+
+While non-standard and generally not recommended, some legacy Fortran
+programs use `include` directives to inject code inline. Since v0.51,
+Meson can handle Fortran `include` directives recursively.
+
+DO NOT list `include` files as sources for a target, as in general
+their syntax is not correct as a standalone target. In general
+`include` files are meant to be injected inline as if they were copy
+and pasted into the source file.
+
+`include` was never standard and was superseded by Fortran 90 `module`.
+
+The `include` file is only recognized by Meson if it has a Fortran
+file suffix, such as `.f` `.F` `.f90` `.F90` or similar. This is to
+avoid deeply nested scanning of large external legacy C libraries that
+only interface to Fortran by `include biglib.h` or similar.
+
+## CMake subprojects
+
+Meson can now directly consume CMake based subprojects with the
+CMake module.
+
+Using CMake subprojects is similar to using the "normal" Meson
+subprojects. They also have to be located in the `subprojects`
+directory.
+
+Example:
+
+```cmake
+add_library(cm_lib SHARED ${SOURCES})
+```
+
+```meson
+cmake = import('cmake')
+
+# Configure the CMake project
+sub_proj = cmake.subproject('libsimple_cmake')
+
+# Fetch the dependency object
+cm_lib = sub_proj.dependency('cm_lib')
+
+executable(exe1, 'sources', dependencies: cm_lib)
+```
+
+It should be noted that not all projects are guaranteed to work. The
+safest approach would still be to create a `meson.build` for the
+subprojects in question.
+
+## Multiple cross files can be specified
+
+`--cross-file` can be passed multiple times, with the configuration files overlaying the same way as `--native-file`.

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/Release-notes-for-0.52.0.md Added

@@ -0,0 +1,252 @@
+---
+title: Release 0.52.0
+short-description: Release notes for 0.52.0
+...
+
+# New features
+
+## Gettext targets are ignored if `gettext` is not installed
+
+Previously the `i18n` module has errored out when `gettext` tools are
+not installed on the system. Starting with this version they will
+become no-ops instead. This makes it easier to build projects on
+minimal environments (such as when bootstrapping) that do not have
+translation tools installed.
+
+## Support taking environment values from a dictionary
+
+`environment()` now accepts a dictionary as first argument.  If
+provided, each key/value pair is added into the `environment_object`
+as if `set()` method was called for each of them.
+
+On the various functions that take an `env:` keyword argument, you may
+now give a dictionary.
+
+## alias_target
+
+``` meson
+runtarget alias_target(target_name, dep1, ...)
+```
+
+This function creates a new top-level target. Like all top-level
+targets, this integrates with the selected backend. For instance, with
+Ninja you can run it as `ninja target_name`. This is a dummy target
+that does not execute any command, but ensures that all dependencies
+are built. Dependencies can be any build target (e.g. return value of
+executable(), custom_target(), etc)
+
+
+## Enhancements to the pkg_config_path argument
+
+Setting sys_root in the properties section of your cross file will
+now set PKG_CONFIG_SYSROOT_DIR automatically for host system
+dependencies when cross compiling.
+
+## The Meson test program now accepts an additional "--gdb-path" argument to specify the GDB binary
+
+`meson test --gdb testname` invokes GDB with the specific test case. However, sometimes GDB is not in the path or a GDB replacement is wanted.
+Therefore, a `--gdb-path` argument was added to specify which binary is executed (per default `gdb`):
+
+```console
+$ meson test --gdb --gdb-path /my/special/location/for/gdb testname
+$ meson test --gdb --gdb-path cgdb testname
+```
+
+## Better support for illumos and Solaris
+
+illumos (and hopefully Solaris) support has been dramatically
+improved, and one can reasonably expect projects to compile.
+
+## Splitting of Compiler.get_function_attribute('visibility')
+
+On macOS there is no `protected` visibility, which results in the
+visibility check always failing. 0.52.0 introduces two changes to
+improve this situation:
+
+1. the "visibility" check no longer includes "protected"
+2. a new set of "split" checks are introduced which check for a single
+   attribute instead of all attributes.
+
+These new attributes are:
+* visibility:default
+* visibility:hidden
+* visibility:internal
+* visibility:protected
+
+## Clang-tidy target
+
+If `clang-tidy` is installed and the project's source root contains a
+`.clang-tidy` (or `_clang-tidy`) file, Meson will automatically define
+a `clang-tidy` target that runs Clang-Tidy on all source files.
+
+If you have defined your own `clang-tidy` target, Meson will not
+generate its own target.
+
+## Add blocks dependency
+
+Add `dependency('blocks')` to use the Clang blocks extension.
+
+## Meson's builtin b_lundef is now supported on macOS
+
+This has always been possible, but there are some additional
+restrictions on macOS (mainly do to Apple only features). With the
+linker internal re-architecture this has become possible
+
+## Compiler and dynamic linker representation split
+
+0.52.0 includes a massive refactor of the representaitons of compilers to
+tease apart the representations of compilers and dynamic linkers (ld). This
+fixes a number of compiler/linker combinations. In particular this fixes
+use GCC and vanilla clang on macOS.
+
+## Add `depth` option to `wrap-git`
+
+To allow shallow cloning, an option `depth` has been added to `wrap-git`.
+This applies recursively to submodules when `clone-recursive` is set to `true`.
+
+Note that the git server may have to be configured to support shallow cloning
+not only for branches but also for tags.
+
+## Enhancements to the source_set module
+
+`SourceSet` objects now provide the `all_dependencies()` method, that
+complement the existing `all_sources()` method.
+
+## added `--only test(s)` option to run_project_tests.py
+
+Individual tests or a list of tests from run_project_tests.py can be selected like:
+```
+python run_project_tests.py --only fortran
+
+python run_project_tests.py --only fortran python3
+```
+
+This assists Meson development by only running the tests for the
+portion of Meson being worked on during local development.
+
+## Experimental Webassembly support via Emscripten
+
+Meson now supports compiling code to Webassembly using the Emscripten
+compiler. As with most things regarding Webassembly, this support is
+subject to change.
+
+## Version check in `find_program()`
+
+A new `version` keyword argument has been added to `find_program` to
+specify the required version. See `dependency()`(#dependency) for
+argument format. The version of the program is determined by running
+`program_name --version` command. If stdout is empty it fallbacks to
+stderr. If the output contains more text than simply a version number,
+only the first occurrence of numbers separated by dots is kept. If the
+output is more complicated than that, the version checking will have
+to be done manually using `run_command()`(#run_command).
+
+## Added `vs_module_defs` to `shared_module()`
+
+Like `shared_library()`, `shared_module()` now accepts
+`vs_module_defs` argument for controlling symbol exports, etc.
+
+## Improved support for static libraries
+
+Static libraries had numerous shortcomings in the past, especially
+when using uninstalled static libraries. This release brings many
+internal changes in the way they are handled, including:
+
+- `link_whole:` of static libraries. In the example below, lib2 used to miss
+  symbols from lib1 and was unusable.
+```meson
+lib1 = static_library(sources)
+lib2 = static_library(other_sources, link_whole : lib1, install : true)
+```
+- `link_with:` of a static library with an uninstalled static library. In the
+example below, lib2 now implicitly promote `link_with:` to `link_whole:` because
+the installed lib2 would oterhwise be unusable.
+```meson
+lib1 = static_library(sources, install : false)
+lib2 = static_library(sources, link_with : lib1, install : true)
+```
+- pkg-config generator do not include uninstalled static libraries. In the example
+  below, the generated `.pc` file used to be unusable because it contained
+  `Libs.private: -llib1` and `lib1.a` is not installed. `lib1` is now omitted
+  from the `.pc` file because the `link_with:` has been promoted to
+  `link_whole:` (see above) and thus lib1 is not needed to use lib2.
+```meson
+lib1 = static_library(sources, install : false)
+lib2 = both_libraries(sources, link_with : lib1, install : true)
+pkg.generate(lib2)
+```
+
+Many projects have been using `extract_all_objects()` to work around
+those issues, and hopefully those hacks could now be removed. Since
+this is a pretty large change, please double check if your static
+libraries behave correctly, and report any regression.
+
+## Enhancements to the kconfig module
+
+`kconfig.load()` may now accept a `configure_file()` as input file.
+
+## Added `include_type` kwarg to `dependency`
+
+The `dependency()` function now has a `include_type` kwarg. It can take the
+values `'preserve'`, `'system'` and `'non-system'`. If it is set to `'system'`,
+all include directories of the dependency are marked as system dependencies.
+
+The default value of `include_type` is `'preserve'`.
+
+Additionally, it is also possible to check and change the
+`include_type` state of an existing dependency object with the new
+`include_type()` and `as_system()` methods.
+
+## Enhancements to `configure_file()`
+
+`input:` now accepts multiple input file names for `command:`-configured file.
+
+`depfile:` keyword argument is now accepted. The dependency file can
+list all the additional files the configure target depends on.
+
+## Projects args can be set separately for build and host machines (potentially breaking change)
+
+Simplify `native` flag behavior in `add_global_arguments`,
+`add_global_link_arguments`, `add_project_arguments` and
+`add_project_link_arguments`. The rules are now very simple:
+
+ - `native: true` affects `native: true` targets
+
+ - `native: false` affects `native: false` targets
+
+ - No native flag is the same as `native: false`
+
+This further simplifies behavior to match the "build vs host" decision
+done in last release with `c_args` vs `build_c_args`. The underlying
+motivation in both cases is to execute the same commands whether the
+overall build is native or cross.
+
+## Allow checking if a variable is a disabler
+
+Added the function `is_disabler(var)`. Returns true if a variable is a disabler
+and false otherwise.
+
+
+## gtkdoc-check support
+
+`gnome.gtkdoc()` now has a `check` keyword argument. If `true` runs it
+will run `gtkdoc-check` when running unit tests. Note that this has
+the downside of rebuilding the doc for each build, which is often very
+slow. It usually should be enabled only in CI.
+
+## `gnome.gtkdoc()` returns target object
+
+`gnome.gtkdoc()` now returns a target object that can be passed as
+dependency to other targets using generated doc files (e.g. in
+`content_files` of another doc).
+
+## Dist is now a top level command
+
+Previously creating a source archive could only be done with `ninja
+dist`. Starting with this release Meson provides a top level `dist`
+that can be invoked directly. It also has a command line option to
+determine which kinds of archives to create:
+
+```meson
+meson dist --formats=xztar,zip
+```

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/Release-notes-for-0.53.0.md Added

@@ -0,0 +1,219 @@
+---
+title: Release 0.53.0
+short-description: Release notes for 0.53.0
+...
+
+# New features
+
+## A new module for filesystem operations
+
+The new `fs` module can be used to examine the contents of the current
+file system.
+
+```meson
+fs = import('fs')
+assert(fs.exists('important_file'),
+       'The important file is missing.')
+```
+
+## meson dist --include-subprojects
+
+`meson dist` command line now gained `--include-subprojects` command
+line option. When enabled, the source tree of all subprojects used by
+the current build will also be included in the final tarball. This is
+useful to distribute self contained tarball that can be built offline
+(i.e. `--wrap-mode=nodownload`).
+
+## Added new Meson templates for `Dlang`, `Rust`, `Objective-C`
+
+Meson now ships with predefined project templates for `Dlang`,
+`Fortran`, `Rust`, `Objective-C`, and by passing the associated flags `d`,
+`fortran`, `rust`, `objc` to `meson init --language`.
+
+## Add a new summary() function
+
+A new function summary has been
+added to summarize build configuration at the end of the build
+process.
+
+Example:
+```meson
+project('My Project', version : '1.0')
+summary({'bindir': get_option('bindir'),
+         'libdir': get_option('libdir'),
+         'datadir': get_option('datadir'),
+        }, section: 'Directories')
+summary({'Some boolean': false,
+         'Another boolean': true,
+         'Some string': 'Hello World',
+         'A list': 'string', 1, true,
+        }, section: 'Configuration')
+```
+
+Output:
+```
+My Project 1.0
+
+  Directories
+             prefix: /opt/gnome
+             bindir: bin
+             libdir: lib/x86_64-linux-gnu
+            datadir: share
+
+  Configuration
+       Some boolean: False
+    Another boolean: True
+        Some string: Hello World
+             A list: string
+                     1
+                     True
+```
+
+## Generic Overrider for Dynamic Linker selection
+
+Previous to Meson 0.52.0 you set the dynamic linker using compiler
+specific flags passed via language flags and hoped things worked out.
+In version 0.52.0 Meson started detecting the linker and making
+intelligent decisions about using it. Unfortunately this broke
+choosing a non-default linker.
+
+Now there is a generic mechanism for doing this. In 0.53.0, you can
+use the `LD` environment variable. **In 0.53.1** this was changed to
+`<compiler_variable>_LD`, such as `CC_LD`, `CXX_LD`, `D_LD`, etc due
+to regressions. The usual Meson environment variable
+rules(https://mesonbuild.com/Running-Meson.html#environment-variables)
+apply. Alternatively, you can add the following to a cross or native
+file:
+
+In 0.53.0:
+
+```ini
+binaries
+ld = 'gold'
+```
+
+**In 0.53.1 or newer**:
+
+```ini
+binaries
+c = 'gcc'
+c_ld = 'gold'
+```
+
+```ini
+binaries
+c = 'clang'
+c_ld = 'lld'
+```
+
+And Meson will select the linker if possible.
+
+## `fortran_std` option
+
+**new in 0.53.0** Akin to the `c_std` and `cpp_std` options, the
+`fortran_std` option sets Fortran compilers to warn or error on
+non-Fortran standard code. Only the Gfortran and Intel Fortran
+compilers have support for this option. Other Fortran compilers ignore
+the `fortran_std` option.
+
+Supported values for `fortran_std` include:
+
+* `legacy` for non-conforming code--this is especially important for Gfortran, which by default errors on old non-compliant Fortran code
+* `f95` for Fortran 95 compliant code.
+* `f2003` for Fortran 2003 compliant code.
+* `f2008` for Fortran 2008 compliant code.
+* `f2018` for Fortran 2018 compliant code.
+
+## python.dependency() embed kwarg
+
+Added the `embed` kwarg to the python module dependency function to
+select the python library that can be used to embed python into an
+application.
+
+## Scalapack
+
+added in **0.53.0**:
+
+```meson
+scalapack = dependency('scalapack')
+```
+
+Historically and through today, typical Scalapack setups have broken
+and incomplete pkg-config or FindScalapack.cmake. Meson handles
+finding Scalapack on setups including:
+
+* Linux: Intel MKL or OpenMPI + Netlib
+* MacOS: Intel MKL or OpenMPI + Netlib
+* Windows: Intel MKL (OpenMPI not available on Windows)
+
+## Search directories for `find_program()`
+
+It is now possible to give a list of absolute paths where `find_program()` should
+also search, using the `dirs` keyword argument.
+
+For example on Linux `/sbin` and `/usr/sbin` are not always in the `$PATH`:
+```meson
+prog = find_program('mytool', dirs : '/usr/sbin', '/sbin')
+```
+
+## Source tags targets
+
+When the respective tools are available, 'ctags', 'TAGS' and 'cscope'
+targets will be generated by Meson, unless you have defined your own.
+
+## Dictionary entry using string variable as key
+
+Keys can now be any expression evaluating to a string value, not limited
+to string literals any more.
+```meson
+d = {'a' + 'b' : 42}
+k = 'cd'
+d += {k : 43}
+```
+
+## Improved CMake subprojects support
+
+With this release even more CMake projects are supported via CMake
+subprojects(CMake-module.md#cmake-subprojects) due to these internal
+improvements:
+
+- Use the CMake file API for CMake >=3.14
+- Handle the explicit dependencies via `add_dependency`
+- Basic support for `add_custom_target`
+- Improved `add_custom_command` support
+- Object library support on Windows
+
+## compiler.get_linker_id()
+
+since 0.53.0, `compiler.get_linker_id()` allows retrieving a lowercase
+name for the linker. Since each compiler family can typically use a
+variety of linkers depending on operating system, this helps users
+define logic for corner cases not otherwise easily handled.
+
+## CUDA dependency
+
+Native support for compiling and linking against the CUDA Toolkit
+using the `dependency` function:
+
+```meson
+project('CUDA test', 'cpp', meson_version: '>= 0.53.0')
+exe = executable('prog', 'prog.cc', dependencies: dependency('cuda'))
+```
+
+See the CUDA dependency(Dependencies.md#cuda) for more information.
+
+## Added global option to disable C++ RTTI
+
+The new boolean option is called `cpp_rtti`.
+
+## Introspection API changes
+
+dependencies (--dependencies, intro-dependencies.json):
+- added the `version` key
+
+scanning dependencies (--scan-dependencies):
+- added the `version` key containing the required dependency version
+
+tests and benchmarks (--tests, --benchmarks, intro-tests.json,
+intro-benchmarks.json):
+- added the `protocol` key

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/Release-notes-for-0.54.0.md Added

@@ -0,0 +1,394 @@
+---
+title: Release 0.54.0
+short-description: Release notes for 0.54.0
+...
+
+# New features
+
+## Emscripten (emcc) now supports threads
+
+In addition to properly setting the compile and linker arguments, a
+new Meson builtin has been added to control the PTHREAD_POOL_SIZE
+option, `-D<lang>_thread_count`, which may be set to any integer value
+greater than 0. If it set to 0 then the PTHREAD_POOL_SIZE option will
+not be passed.
+
+## Introduce dataonly for the pkgconfig module
+
+This allows users to disable writing out the inbuilt variables to the
+pkg-config file as they might actually not be required.
+
+One reason to have this is for architecture-independent pkg-config
+files in projects which also have architecture-dependent outputs.
+
+```
+pkgg.generate(
+  name : 'libhello_nolib',
+  description : 'A minimalistic pkgconfig file.',
+  version : libver,
+  dataonly: true
+)
+```
+
+## Consistently report file locations relative to cwd
+
+The paths for filenames in error and warning locations are now
+consistently reported relative to the current working directory (when
+possible), or as absolute paths (when a relative path does not exist,
+e.g. a Windows path starting with a different drive letter to the
+current working directory).
+
+(The previous behaviour was to report a path relative to the source
+root for all warnings and most errors, and relative to cwd for certain
+parser errors)
+
+## `dependency()` consistency
+
+The first time a dependency is found, using `dependency('foo', ...)`,
+the return value is now cached. Any subsequent call will return the
+same value as long as version requested match, otherwise not-found
+dependency is returned. This means that if a system dependency is
+first found, it won't fallback to a subproject in a subsequent call
+any more and will rather return not-found instead if the system
+version does not match. Similarly, if the first call returns the
+subproject fallback dependency, it will also return the subproject
+dependency in a subsequent call even if no fallback is provided.
+
+For example, if the system has `foo` version 1.0:
+```meson
+# d2 is set to foo_dep and not the system dependency, even without fallback argument.
+d1 = dependency('foo', version : '>=2.0', required : false,
+                fallback : 'foo', 'foo_dep')
+d2 = dependency('foo', version : '>=1.0', required : false)
+```
+```meson
+# d2 is not-found because the first call returned the system dependency, but its version is too old for 2nd call.
+d1 = dependency('foo', version : '>=1.0', required : false)
+d2 = dependency('foo', version : '>=2.0', required : false,
+                fallback : 'foo', 'foo_dep')
+```
+
+## Override `dependency()`
+
+It is now possible to override the result of `dependency()` to point
+to any dependency object you want. The overriding is global and
+applies to every subproject from there on.
+
+For example, this subproject provides 2 libraries with version 2.0:
+
+```meson
+project(..., version : '2.0')
+
+libfoo = library('foo', ...)
+foo_dep = declare_dependency(link_with : libfoo)
+meson.override_dependency('foo', foo_dep)
+
+libbar = library('bar', ...)
+bar_dep = declare_dependency(link_with : libbar)
+meson.override_dependency('bar', bar_dep)
+```
+
+Assuming the system has `foo` and `bar` 1.0 installed, and master project does this:
+```meson
+foo_dep = dependency('foo', version : '>=2.0', fallback : 'foo', 'foo_dep')
+bar_dep = dependency('bar')
+```
+
+This used to mix system 1.0 version and subproject 2.0 dependencies,
+but thanks to the override `bar_dep` is now set to the subproject's
+version instead.
+
+Another case this can be useful is to force a subproject to use a
+specific dependency. If the subproject does `dependency('foo')` but
+the main project wants to provide its own implementation of `foo`, it
+can for example call `meson.override_dependency('foo',
+declare_dependency(...))` before configuring the subproject.
+
+## Simplified `dependency()` fallback
+
+In the case a subproject `foo` calls
+`meson.override_dependency('foo-2.0', foo_dep)`, the parent project
+can omit the dependency variable name in fallback keyword argument:
+`dependency('foo-2.0', fallback : 'foo')`.
+
+## Backend agnostic compile command
+
+A new `meson compile` command has been added to support backend
+agnostic compilation. It accepts two arguments, `-j` and `-l`, which
+are used if possible (`-l` does nothing with msbuild). A `-j` or `-l`
+value < 1 lets the backend decide how many threads to use. For msbuild
+this means `-m`, for ninja it means passing no arguments.
+
+```console
+meson setup builddir --backend vs
+meson compile -C builddir -j0  # this is the same as `msbuild builddir/my.sln -m`
+```
+
+```console
+meson setup builddir
+meson compile -C builddir -j3  # this is the same as `ninja -C builddir -j3`
+```
+
+Additionally `meson compile` provides a `--clean` switch to clean the
+project.
+
+A complete list of arguments is always documented via `meson compile --help`
+
+## Native (build machine) compilers not always required
+
+`add_languages()` gained a `native:` keyword, indicating if a native or cross
+compiler is to be used.
+
+For the benefit of existing simple build definitions which don't
+contain any `native: true` targets, without breaking backwards
+compatibility for build definitions which assume that the native
+compiler is available after `add_languages()`, if the `native:`
+keyword is absent the languages may be used for either the build or
+host machine, but are never required for the build machine.
+
+This changes the behaviour of the following Meson fragment (when
+cross-compiling but a native compiler is not available) from reporting
+an error at `add_language` to reporting an error at `executable`.
+
+```
+add_language('c')
+executable('main', 'main.c', native: true)
+```
+
+## Summary improvements
+
+A new `list_sep` keyword argument has been added to `summary()`
+function. If defined and the value is a list, elements will be
+separated by the provided string instead of being aligned on a new
+line.
+
+The automatic `subprojects` section now also print the number of
+warnings encountered during that subproject configuration, or the
+error message if the configuration failed.
+
+## Add a system type dependency for zlib
+
+This allows zlib to be detected on macOS and FreeBSD without the use
+of pkg-config or cmake, neither of which are part of the base install
+on those OSes (but zlib is).
+
+A side effect of this change is that `dependency('zlib')` also works
+with cmake instead of requiring `dependency('ZLIB')`.
+
+## Added 'name' method
+
+Build target objects (as returned by executable(), library(), ...) now
+have a name() method.
+
+## New option `--quiet` to `meson install`
+
+Now you can run `meson install --quiet` and Meson will not verbosely
+print every file as it is being installed. As before, the full log is
+always available inside the builddir in `meson-logs/install-log.txt`.
+
+When this option is passed, install scripts will have the environment
+variable `MESON_INSTALL_QUIET` set.
+
+Numerous speed-ups were also made for the install step, especially on
+Windows where it is now 300% to 1200% faster than before depending on
+your workload.
+
+## Property support emscripten's wasm-ld
+
+Before 0.54.0 we treated emscripten as both compiler and linker, which
+isn't really true. It does have a linker, called wasm-ld (Meson's name
+is ld.wasm). This is a special version of clang's lld. This will now
+be detected properly.
+
+## Skip sanity tests when cross compiling
+
+For certain cross compilation environments it is not possible to
+compile a sanity check application. This can now be disabled by adding
+the following entry to your cross file's `properties` section:
+
+```
+skip_sanity_check = true
+```
+
+## Support for overriding the linker with ldc and gdc
+
+LDC (the llvm D compiler) and GDC (The Gnu D Compiler) now honor D_LD
+linker variable (or d_ld in the cross file) and is able to pick
+different linkers.
+
+GDC supports all of the same values as GCC, LDC supports ld.bfd,
+ld.gold, ld.lld, ld64, link, and lld-link.
+
+## Native file properties
+
+As of Meson 0.54.0, the `--native-file nativefile.ini` can contain:
+
+* binaries
+* paths
+* properties
+
+which are defined and used the same way as in cross files. The
+`properties` are new for Meson 0.54.0, and are read like:
+
+```meson
+x = meson.get_external_property('foobar', 'foo')
+```
+
+where `foobar` is the property name, and the optional `foo` is the
+fallback string value.
+
+For cross-compiled projects, `get_external_property()` reads the
+cross-file unless `native: true` is specified.
+
+## Changed the signal used to terminate a test process (group)
+
+A test process (group) is now terminated via SIGTERM instead of
+SIGKILL allowing the signal to be handled. However, it is now the
+responsibility of the custom signal handler (if any) to ensure that
+any process spawned by the top-level test processes is correctly
+killed.
+
+## Dynamic Linker environment variables actually match docs
+
+The docs have always claimed that the Dynamic Linker environment
+variable should be `${COMPILER_VAR}_LD`, but that's only the case for
+about half of the variables. The other half are different. In 0.54.0
+the variables match. The old variables are still supported, but are
+deprecated and raise a deprecation warning.
+
+## Per subproject `default_library` and `werror` options
+
+The `default_library` and `werror` built-in options can now be defined
+per subproject. This is useful for example when building shared
+libraries in the main project, but static link a subproject, or when
+the main project must build with no warnings but some subprojects
+cannot.
+
+Most of the time this would be used either by the parent project by
+setting subproject's default_options (e.g. `subproject('foo',
+default_options: 'default_library=static')`), or by the user using the
+command line `-Dfoo:default_library=static`.
+
+The value is overridden in this order:
+- Value from parent project
+- Value from subproject's default_options if set
+- Value from subproject() default_options if set
+- Value from command line if set
+
+## Environment Variables with Cross Builds
+
+Previously in Meson, variables like `CC` effected both the host and
+build platforms for native builds, but the just the build platform for
+cross builds. Now `CC_FOR_BUILD` is used for the build platform in
+cross builds.
+
+This old behavior is inconsistent with the way Autotools works, which
+undermines the purpose of distro-integration that is the only reason
+environment variables are supported at all in Meson. The new behavior
+is not quite the same, but doesn't conflict: Meson doesn't always
+repond to an environment when Autoconf would, but when it does it
+interprets it as Autotools would.
+
+## Added 'pkg_config_libdir' property
+
+Allows to define a list of folders used by pkg-config for a cross
+build and avoid a system directories use.
+
+## More new sample Meson templates for (`Java`, `Cuda`, and more)
+
+Meson now ships with predefined project templates for `Java`, `Cuda`,
+`Objective-C++`, and `C#`, we provided with associated values for
+corresponding languages, available for both library, and executable.
+
+## Ninja version requirement bumped to 1.7
+
+Meson now uses the Implicit
+outputs(https://ninja-build.org/manual.html#ref_outputs) feature of
+Ninja for some types of targets that have multiple outputs which may
+not be listed on the command-line. This feature requires Ninja 1.7+.
+
+Note that the latest version of Ninja available in Ubuntu
+16.04(https://packages.ubuntu.com/search?keywords=ninja-build&searchon=names&suite=xenial-backports&section=all)
+(the oldest Ubuntu LTS at the time of writing) is 1.7.1. If your
+distro does not ship with a new-enough Ninja, you can download the
+latest release from Ninja's GitHub page:
+https://github.com/ninja-build/ninja/releases
+
+## Added `-C` argument to `meson init` command
+
+The Meson init assumes that it is run inside the project root
+directory. If this isn't the case, you can now use `-C` to specify the
+actual project source directory.
+
+## More than one argument to `message()` and `warning()`
+
+Arguments passed to `message()` and `warning()` will be printed
+separated by space.
+
+## Added `has_tools` method to qt module
+
+It should be used to compile optional Qt code:
+```meson
+qt5 = import('qt5')
+if qt5.has_tools(required: get_option('qt_feature'))
+  moc_files = qt5.preprocess(...)
+  ...
+endif
+```
+
+## The MSI installer is only available in 64 bit version
+
+Microsoft ended support for Windows 7, so only 64 bit Windows OSs are
+officially supported. Thus only a 64 bit MSI installer will be
+provided going forward. People needing a 32 bit version can build
+their own with the `msi/createmsi.py` script in Meson's source
+repository.
+
+## Uninstalled pkg-config files
+
+**Note**: the functionality of this module is governed by Meson's
+  rules on mixing build systems(Mixing-build-systems.md).
+
+The `pkgconfig` module now generates uninstalled pc files as well. For
+any generated `foo.pc` file, an extra `foo-uninstalled.pc` file is
+placed into `<builddir>/meson-uninstalled`. They can be used to build
+applications against libraries built by Meson without installing them,
+by pointing `PKG_CONFIG_PATH` to that directory. This is an
+experimental feature provided on a best-effort basis, it might not
+work in all use-cases.
+
+## CMake find_package COMPONENTS support
+
+It is now possible to pass components to the CMake dependency backend
+via the new `components` kwarg in the `dependency` function.
+
+## Added Microchip XC16 C compiler support
+
+Make sure compiler executables are setup correctly in your path
+Compiler is available from the Microchip website for free
+
+
+## Added Texas Instruments C2000 C/C++ compiler support
+
+Make sure compiler executables are setup correctly in your path
+Compiler is available from Texas Instruments website for free
+
+## Unity file block size is configurable
+
+Traditionally the unity files that Meson autogenerates contain all
+source files that belong to a single target. This is the most
+efficient setting for full builds but makes incremental builds slow.
+This release adds a new option `unity_size` which specifies how many
+source files should be put in each unity file.
+
+The default value for block size is 4. This means that if you have a
+target that has eight source files, Meson will generate two unity
+files each of which includes four source files. The old behaviour can
+be replicated by setting `unity_size` to a large value, such as 10000.
+
+## Verbose mode for `meson compile`
+
+The new option `--verbose` has been added to `meson compile` that will
+enable more verbose compilation logs. Note that for VS backend it
+means that logs will be less verbose by default (without `--verbose`
+option).

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/Release-notes-for-0.55.0.md Added

@@ -0,0 +1,331 @@
+---
+title: Release 0.55.0
+short-description: Release notes for 0.55.0
+...
+
+# New features
+
+## rpath removal now more careful
+
+On Linux-like systems, Meson adds rpath entries to allow running apps
+in the build tree, and then removes those build-time-only rpath
+entries when installing. Rpath entries may also come in via LDFLAGS
+and via .pc files. Meson used to remove those latter rpath entries by
+accident, but is now more careful.
+
+## Added ability to specify targets in `meson compile`
+
+It's now possible to specify targets in `meson compile`, which will
+result in building only the requested targets.
+
+Usage: `meson compile TARGET TARGET...`
+`TARGET` has the following syntax: `PATH/NAME:TYPE`.
+`NAME`: name of the target from `meson.build` (e.g. `foo` from `executable('foo', ...)`).
+`PATH`: path to the target relative to the root `meson.build` file. Note: relative path for a target specified in the root `meson.build` is `./`.
+`TYPE`: type of the target (e.g. `shared_library`, `executable` and etc)
+
+`PATH` and/or `TYPE` can be omitted if the resulting `TARGET` can be used to uniquely identify the target in `meson.build`.
+
+For example targets from the following code:
+```meson
+shared_library('foo', ...)
+static_library('foo', ...)
+executable('bar', ...)
+```
+can be invoked with `meson compile foo:shared_library foo:static_library bar`.
+
+## Test protocol for gtest
+
+Due to the popularity of Gtest (google test) among C and C++
+developers Meson now supports a special protocol for gtest. With this
+protocol Meson injects arguments to gtests to output JUnit, reads that
+JUnit, and adds the output to the JUnit it generates.
+
+## meson.add_*_script methods accept new types
+
+All three (`add_install_script`, `add_dist_script`, and
+`add_postconf_script`) now accept ExternalPrograms (as returned by
+`find_program`), Files, and the output of `configure_file`. The dist and
+postconf methods cannot accept other types because of when they are run.
+While dist could, in theory, take other dependencies, it would require more
+extensive changes, particularly to the backend.
+
+```meson
+meson.add_install_script(find_program('foo'), files('bar'))
+meson.add_dist_script(find_program('foo'), files('bar'))
+meson.add_postconf_script(find_program('foo'), files('bar'))
+```
+
+The install script variant is also able to accept custom_targets,
+custom_target indexes, and build targets (executables, libraries), and
+can use built executables a the script to run
+
+```meson
+installer = executable('installer', ...)
+meson.add_install_script(installer, ...)
+meson.add_install_script('foo.py', installer)
+```
+
+## Machine file constants
+
+Native and cross files now support string and list concatenation using
+the `+` operator, and joining paths using the `/` operator. Entries
+defined in the `constants` section can be used in any other section.
+An entry defined in any other section can be used only within that
+same section and only after it has been defined.
+
+```ini
+constants
+toolchain = '/toolchain'
+common_flags = '--sysroot=' + toolchain + '/sysroot'
+
+properties
+c_args = common_flags + '-DSOMETHING'
+cpp_args = c_args + '-DSOMETHING_ELSE'
+
+binaries
+c = toolchain + '/gcc'
+```
+
+## Configure CMake subprojects with Meson.subproject_options
+
+Meson now supports passing configuration options to CMake and
+overriding certain build details extracted from the CMake subproject.
+
+The new CMake configuration options object is very similar to the
+@cfg_data object object returned
+by configuration_data. It
+is generated by the `subproject_options` function
+
+All configuration options have to be set *before* the subproject is
+configured and must be passed to the `subproject` method via the
+`options` key. Altering the configuration object won't have any effect
+on previous `cmake.subproject` calls.
+
+**Note:** The `cmake_options` kwarg for the `subproject` function is
+now deprecated since it is replaced by the new `options` system.
+
+## find_program: Fixes when the program has been overridden by executable
+
+When a program has been overridden by an executable, the returned
+object of find_program() had some issues:
+
+```meson
+# In a subproject:
+exe = executable('foo', ...)
+meson.override_find_program('foo', exe)
+
+# In main project:
+# The version check was crashing Meson.
+prog = find_program('foo', version : '>=1.0')
+
+# This was crashing Meson.
+message(prog.path())
+
+# New method to be consistent with built objects.
+message(prog.full_path())
+```
+
+## Response files enabled on Linux, reined in on Windows
+
+Meson used to always use response files on Windows,
+but never on Linux.
+
+It now strikes a happier balance, using them on both platforms,
+but only when needed to avoid command line length limits.
+
+## `unstable-kconfig` module renamed to `unstable-keyval`
+
+The `unstable-kconfig` module is now renamed to `unstable-keyval`. We
+expect this module to become stable once it has some usage experience,
+specifically in the next or the following release
+
+
+## Fatal warnings in `gnome.generate_gir()`
+
+`gnome.generate_gir()` now has `fatal_warnings` keyword argument to
+abort when a warning is produced. This is useful for example in CI
+environment where it's important to catch potential issues.
+
+## b_ndebug support for D language compilers
+
+D Language compilers will now set -release/--release/-frelease (depending on
+the compiler) when the b_ndebug flag is set.
+
+## Meson test now produces JUnit xml from results
+
+Meson will now generate a JUnit compatible XML file from test results.
+it will be in the `meson-logs` directory and is called
+`testlog.junit.xml`.
+
+## Config tool based dependencies no longer search PATH for cross compiling
+
+Before 0.55.0 config tool based dependencies (llvm-config,
+cups-config, etc), would search system $PATH if they weren't defined
+in the cross file. This has been a source of bugs and has been
+deprecated. It is now removed, config tool binaries must be specified
+in the cross file now or the dependency will not be found.
+
+## Rename has_exe_wrapper -> can_run_host_binaries
+
+The old name was confusing as it didn't really match the behavior of
+the function. The old name remains as an alias (the behavior hasn't
+changed), but is now deprecated.
+
+## String concatenation in meson_options.txt
+
+It is now possible to use string concatenation (with the `+`
+opperator) in the `meson_options.txt` file. This allows splitting long
+option descriptions.
+
+```meson
+option(
+  'testoption',
+  type : 'string',
+  value : 'optval',
+  description : 'An option with a very long description' +
+                'that does something in a specific context'
+)
+```
+
+## Wrap fallback URL
+
+Wrap files can now define `source_fallback_url` and
+`patch_fallback_url` to be used in case the main server is temporarily
+down.
+
+## Clang coverage support
+
+llvm-cov is now used to generate coverage information when clang is
+used as the compiler.
+
+## Local wrap source and patch files
+
+It is now possible to use the `patch_filename` and `source_filename`
+value in a `.wrap` file without `*_url` to specify a local source /
+patch file. All local files must be located in the
+`subprojects/packagefiles` directory. The `*_hash` entries are
+optional with this setup.
+
+## Local wrap patch directory
+
+Wrap files can now specify `patch_directory` instead of
+`patch_filename` in the case overlay files are local. Every files in
+that directory, and subdirectories, will be copied to the subproject
+directory. This can be used for example to add `meson.build` files to
+a project not using Meson build system upstream. The patch directory
+must be placed in `subprojects/packagefiles` directory.
+
+## Patch on all wrap types
+
+`patch_*` keys are not limited to `wrap-file` any more, they can be
+specified for all wrap types.
+
+## link_language argument added to all targets
+
+Previously the `link_language` argument was only supposed to be
+allowed in executables, because the linker used needs to be the linker
+for the language that implements the main function. Unfortunately it
+didn't work in that case, and, even worse, if it had been implemented
+properly it would have worked for *all* targets. In 0.55.0 this
+restriction has been removed, and the bug fixed. It now is valid for
+`executable` and all derivative of `library`.
+
+## meson dist --no-tests
+
+`meson dist` has a new option `--no-tests` to skip build and tests of
+generated packages. It can be used to not waste time for example when
+done in CI that already does its own testing.
+
+## Force fallback for
+
+A newly-added `--force-fallback-for` command line option can now be
+used to force fallback for specific subprojects.
+
+Example:
+
+```
+meson setup builddir/ --force-fallback-for=foo,bar
+```
+
+## Implicit dependency fallback
+
+`dependency('foo')` now automatically fallback if the dependency is
+not found on the system but a subproject wrap file or directory exists
+with the same name.
+
+That means that simply adding `subprojects/foo.wrap` is enough to add
+fallback to any `dependency('foo')` call. It is however requires that
+the subproject call `meson.override_dependency('foo', foo_dep)` to
+specify which dependency object should be used for `foo`.
+
+## Wrap file `provide` section
+
+Wrap files can define the dependencies it provides in the `provide`
+section. When `foo.wrap` provides the dependency `foo-1.0` any call do
+`dependency('foo-1.0')` will automatically fallback to that subproject
+even if no `fallback` keyword argument is given. See Wrap
+documentation(Wrap-dependency-system-manual.md#provide_section).
+
+## `find_program()` fallback
+
+When a program cannot be found on the system but a wrap file has its
+name in the `provide` section, that subproject will be used as
+fallback.
+
+## Test scripts are given the exe wrapper if needed
+
+Meson will now set the `MESON_EXE_WRAPPER` as the properly wrapped and
+joined representation. For Unix-like OSes this means python's
+shelx.join, on Windows an implementation that attempts to properly
+quote windows argument is used. This allow wrapper scripts to run test
+binaries, instead of just skipping.
+
+for example, if the wrapper is `'emulator', '--script'`, it will be passed
+as `MESON_EXE_WRAPPER="emulator --script"`.
+
+## Added ability to specify backend arguments in `meson compile`
+
+It's now possible to specify backend specific arguments in `meson compile`.
+
+Usage: `meson compile --vs-args=args --ninja-args=args`
+
+```
+  --ninja-args NINJA_ARGS    Arguments to pass to `ninja` (applied only on `ninja` backend).
+  --vs-args VS_ARGS          Arguments to pass to `msbuild` (applied only on `vs` backend).
+```
+
+These arguments use the following syntax:
+
+If you only pass a single string, then it is considered to have all
+values separated by commas. Thus invoking the following command:
+
+```
+$ meson compile --ninja-args=-n,-d,explain
+```
+
+would add `-n`, `-d` and `explain` arguments to ninja invocation.
+
+If you need to have commas or spaces in your string values, then you
+need to pass the value with proper shell quoting like this:
+
+```
+$ meson compile "--ninja-args='a,b', 'c d'"
+```
+
+## Introspection API changes
+
+dumping the AST (--ast): **new in 0.55.0**
+- prints the AST of a meson.build as JSON
+
+## `--backend=vs` now matches `-Db_vscrt=from_buildtype` behaviour in the Ninja backend
+
+When `--buildtype=debugoptimized` is used with the Ninja backend, the
+VS CRT option used is `/MD`, which is the behaviour documented for
+all
+backends(https://mesonbuild.com/Builtin-options.html#b_vscrt-from_buildtype).
+However, the Visual Studio backend was pass `/MT` in that case, which
+is inconsistent.
+
+If you need to use the MultiThreaded CRT, you should explicitly pass
+`-Db_vscrt=mt`

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/Release-notes-for-0.56.0.md Added

@@ -0,0 +1,375 @@
+---
+title: Release 0.56.0
+short-description: Release notes for 0.56.0
+...
+
+# New features
+
+## Python 3.5 support will be dropped in the next release
+
+The final Python 3.5 release was 3.5.10 in
+September(https://www.python.org/dev/peps/pep-0478/#id4). This
+release series is now End-of-Life (EOL). The only LTS distribution
+that still only ships Python 3.5 is Ubuntu 16.04, which will be EOL
+in April 2021(https://ubuntu.com/about/release-cycle).
+
+Python 3.6 has numerous features that we find useful such as improved
+support for the `typing` module, f-string support, and better
+integration with the `pathlib` module.
+
+As a result, we will begin requiring Python 3.6 or newer in Meson
+0.57, which is the next release. Starting with Meson 0.56, we now
+print a `NOTICE:` when a `meson` command is run on Python 3.5 to
+inform users about this. This notice has also been backported into the
+0.55.2 stable release.
+
+## `meson test` can now filter tests by subproject
+
+You could always specify a list of tests to run by passing the names
+as arguments to `meson test`. If there were multiple tests with that
+name (in the same project or different subprojects), all of them would
+be run. Now you can:
+
+1. Run all tests with the specified name from a specific subproject: `meson test subprojname:testname`
+1. Run all tests defined in a specific subproject: `meson test subprojectname:`
+
+As before, these can all be specified multiple times and mixed:
+
+```sh
+# Run:
+# * All tests called 'name1' or 'name2' and
+# * All tests called 'name3' in subproject 'bar' and
+# * All tests in subproject 'foo'
+$ meson test name1 name2 bar:name3 foo:
+```
+
+## Native (build machine) compilers not always required by `project()`
+
+When cross-compiling, native (build machine) compilers for the
+languages specified in `project()` are not required, if no targets use
+them.
+
+## New `extra_files` key in target introspection
+
+The target introspection (`meson introspect --targets`,
+`intro-targets.json`) now has the new `extra_files` key which lists
+all files specified via the `extra_files` kwarg of a build target (see
+`executable()`, etc.)
+
+
+## Preliminary AIX support
+
+AIX is now supported when compiling with gcc. A number of features are
+not supported yet. For example, only gcc is supported (not xlC).
+Archives with both 32-bit and 64-bit dynamic libraries are not
+generated automatically. The rpath includes both the build and install
+rpath, no attempt is made to change the rpath at install time. Most
+advanced features (eg. link\_whole) are not supported yet.
+
+## Wraps from subprojects are automatically promoted
+
+It is not required to promote wrap files for subprojects into the main
+project any more. When configuring a subproject, Meson will look for
+any wrap file or directory in the subproject's `subprojects/`
+directory and add them into the global list of available subprojects,
+to be used by any future `subproject()` call or `dependency()`
+fallback. If a subproject with the same name already exists, the new
+wrap file or directory is ignored. That means that the main project
+can always override any subproject's wrap files by providing their
+own, it also means the ordering in which subprojects are configured
+matters, if 2 subprojects provide foo.wrap only the one from the first
+subproject to be configured will be used.
+
+This new behavior can be disabled by passing `--wrap-mode=nopromote`.
+
+## `meson.build_root()` and `meson.source_root()` are deprecated
+
+Those function are common source of issue when used in a subproject
+because they point to the parent project root which is rarely what is
+expected and is a violation of subproject isolation.
+
+`meson.current_source_dir()` and `meson.current_build_dir()` should be
+used instead and have been available in all Meson versions. New
+functions `meson.project_source_root()` and
+`meson.project_build_root()` have been added in Meson 0.56.0 to get
+the root of the current (sub)project.
+
+## `dep.as_link_whole()`
+
+Dependencies created with `declare_dependency()` now has new method
+`as_link_whole()`. It returns a copy of the dependency object with all
+link_with arguments changed to link_whole. This is useful for example
+for fallback dependency from a subproject built with
+`default_library=static`.
+
+```meson
+somelib = static_library('somelib', ...)
+dep = declare_dependency(..., link_with: somelib)
+library('someotherlib', ..., dependencies: dep.as_link_whole())
+```
+
+## Add support for all Windows subsystem types
+
+It is now possible to build things like Windows kernel drivers with
+the new `win_subsystem` keyword argument. This replaces the old
+`gui_app` keyword argument, which is now deprecated. You should update
+your project to use the new style like this:
+
+```meson
+# Old way
+executable(..., gui_app: 'true')
+# New way
+executable(..., win_subsystem: 'windows')
+```
+
+The argument supports versioning as described on MSDN
+documentation(https://docs.microsoft.com/en-us/cpp/build/reference/subsystem-specify-subsystem).
+Thus to build a Windows kernel driver with a specific version you'd
+write something like this:
+
+```meson
+executable(..., win_subsystem: 'native,6.02')
+```
+
+## Added NVidia HPC SDK compilers
+
+Added support for `nvidia_hpc` NVidia HPC SDK compilers, which are currently in public beta testing.
+
+## Project and built-in options can be set in native or cross files
+
+A new set of sections has been added to the cross and native files,
+`project options` and `<subproject_name>:project options`, where
+`subproject_name` is the name of a subproject. Any options that are
+allowed in the project can be set from this section. They have the
+lowest precedent, and will be overwritten by command line arguments.
+
+
+```meson
+option('foo', type : 'string', value : 'foo')
+```
+
+```ini
+project options
+foo = 'other val'
+```
+
+```console
+meson setup builddir/ --native-file my.ini
+```
+
+Will result in the option foo having the value `other val`,
+
+```console
+meson setup builddir/ --native-file my.ini -Dfoo='different val'
+```
+
+Will result in the option foo having the value `different val`,
+
+
+Subproject options are assigned like this:
+
+```ini
+zlib:project options
+foo = 'some val'
+```
+
+Additionally Meson level options can be set in the same way, using the
+`built-in options` section.
+
+```ini
+built-in options
+c_std = 'c99'
+```
+
+These options can also be set on a per-subproject basis, although only
+`default_library` and `werror` can currently be set:
+```ini
+zlib:built-in options
+default_library = 'static'
+```
+
+## `unstable-keyval` is now stable `keyval`
+
+The `unstable-keyval` has been renamed to `keyval` and now promises stability
+guarantees.
+
+Meson will print a warning when you load an `unstable-` module that has been
+stabilised (so `unstable-keyval` is still accepted for example).
+
+## CMake subproject cross compilation support
+
+Meson now supports cross compilation for CMake subprojects. Meson will
+try to automatically guess most of the required CMake toolchain
+variables from existing entries in the cross and native files. These
+variables will be stored in an automatically generate CMake toolchain
+file in the build directory. The remaining variables that can't be
+guessed can be added by the user in the new `cmake` cross/native
+file section.
+
+## Machine file keys are stored case sensitive
+
+Previous the keys were always lowered, which worked fine for the
+values that were allowed in the machine files. With the addition of
+per-project options we need to make these sensitive to case, as the
+options in meson_options.txt are sensitive to case already.
+
+## Consistency between `declare_dependency()` and `pkgconfig.generate()` variables
+
+The `variables` keyword argument in `declare_dependency()` used to
+only support dictionary and `pkgconfig.generate()` only list of
+strings. They now both support dictionary and list of strings in the
+format `'name=value'`. This makes easier to share a common set of
+variables for both:
+
+```meson
+vars = {'foo': 'bar'}
+dep = declare_dependency(..., variables: vars)
+pkg.generate(..., variables: vars)
+```
+
+## Qt5 compile_translations now supports qresource preprocessing
+
+When using qtmod.preprocess() in combination with
+qtmod.compile_translations() to embed translations using rcc, it is no
+longer required to do this:
+
+```meson
+ts_files = 'list', 'of', 'files'
+qtmod.compile_translations(ts_files)
+# lang.qrc also contains the duplicated list of files
+lang_cpp = qtmod.preprocess(qresources: 'lang.qrc')
+```
+
+Instead, use:
+```meson
+lang_cpp = qtmod.compile_translations(qresource: 'lang.qrc')
+```
+
+which will automatically detect and generate the needed
+compile_translations targets.
+
+## Controlling subproject dependencies with  `dependency(allow_fallback: ...)`
+
+As an alternative to the `fallback` keyword argument to `dependency`,
+you may use `allow_fallback`, which accepts a boolean value. If `true`
+and the dependency is not found on the system, Meson will fallback to
+a subproject that provides this dependency, even if the dependency is
+optional. If `false`, Meson will not fallback even if a subproject
+provides this dependency.
+
+## Custom standard library
+
+- It is not limited to cross builds any more, `<lang>_stdlib` property can be
+  set in native files.
+- The variable name parameter is no longer required as long as the subproject
+  calls `meson.override_dependency('c_stdlib', mylibc_dep)`.
+
+## Improvements for the builtin curses dependency
+
+This method has been extended to use config-tools, and a fallback to
+find_library for lookup as well as pkg-config.
+
+## HDF5 dependency improvements
+
+HDF5 has been improved so that the internal representations have been
+split. This allows selecting pkg-config and config-tool dependencies
+separately. Both work as proper dependencies of their type, so
+`get_variable` and similar now work correctly.
+
+It has also been fixed to use the selected compiler for the build instead of
+the default compiler.
+
+## External projects
+
+A new experimental module `unstable-external_project` has been added
+to build code using other build systems than Meson. Currently only
+supporting projects with a configure script that generates Makefiles.
+
+```meson
+project('My Autotools Project', 'c',
+  meson_version : '>=0.56.0',
+)
+
+mod = import('unstable-external_project')
+
+p = mod.add_project('configure',
+  configure_options : '--prefix=@PREFIX@',
+                       '--libdir=@LIBDIR@',
+                       '--incdir=@INCLUDEDIR@',
+                       '--enable-foo',
+                      ,
+)
+
+mylib_dep = p.dependency('mylib')
+```
+
+
+## Per subproject `warning_level` option
+
+`warning_level` can now be defined per subproject, in the same way as
+`default_library` and `werror`.
+
+## `meson subprojects` command
+
+A new `--types` argument has been added to all subcommands to run the
+command only on wraps with the specified types. For example this
+command will only print `Hello` for each git subproject: `meson
+subprojects foreach --types git echo "Hello"`. Multiple types can be
+set as comma separated list e.g. `--types git,file`.
+
+Subprojects with no wrap file are now taken into account as well. This
+happens for example for subprojects configured as git submodule, or
+downloaded manually by the user and placed into the `subprojects/`
+directory.
+
+The `checkout` subcommand now always stash any pending changes before
+switching branch. Note that `update` subcommand was already stashing
+changes before updating the branch.
+
+If the command fails on any subproject the execution continues with
+other subprojects, but at the end an error code is now returned.
+
+The `update` subcommand has been reworked:
+- In the case the URL of `origin` is different as the `url` set in wrap file,
+  the subproject will not be updated unless `--reset` is specified (see below).
+- In the case a subproject directory exists and is not a git repository but has
+  a `wrap-git`, Meson used to run git commands that would wrongly apply to the
+  main project. It now skip the subproject unless `--reset` is specified (see below).
+- The `--rebase` behaviour is now the default for consistency: it was
+  already rebasing when current branch and revision are the same, it is
+  less confusing to rebase when they are different too.
+- Add `--reset` mode that checkout the new branch and hard reset that
+  branch to remote commit. This new mode guarantees that every
+  subproject are exactly at the wrap's revision. In addition the URL of `origin`
+  is updated in case it changed in the wrap file. If the subproject directory is
+  not a git repository but has a `wrap-git` the directory is deleted and the
+  new repository is cloned.
+- Local changes are always stashed first to avoid any data loss. In the
+  worst case scenario the user can always check reflog and stash list to
+  rollback.
+
+## Added CompCert C compiler
+
+Added experimental support for the CompCert formally-verified C
+compiler(https://github.com/AbsInt/CompCert). The current state of
+the implementation is good enough to build the picolibc
+project(https://github.com/picolibc/picolibc) with CompCert, but
+might still need additional adjustments for other projects.
+
+## Dependencies listed in test and benchmark introspection
+
+The introspection data for tests and benchmarks now includes the
+target ids for executables and built files that are needed by the
+test. IDEs can use this feature to update the build more quickly
+before running a test.
+
+## `include_type` support for the CMake subproject object dependency method
+
+The `dependency()` method of the CMake subproject object now also
+supports the `include_type` kwarg which is similar to the sane kwarg
+in the `dependency()` function.
+
+## Deprecate Dependency.get_pkgconfig_variable and Dependency.get_configtool_variable
+
+These have been replaced with the more versatile `get_variable()` method
+already, and shouldn't be used anymore.

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/Release-notes-for-0.57.0.md Added

@@ -0,0 +1,359 @@
+---
+title: Release 0.57.0
+short-description: Release notes for 0.57.0
+...
+
+# New features
+
+## Project version can be specified with a file
+
+Meson can be instructed to load a project's version string from an
+external file like this:
+
+```meson
+project('foo', 'c', version: files('VERSION'))
+```
+
+The version file must contain exactly one line of text which will
+be used as the project's version. If the line ends in a newline
+character, it is removed.
+
+## Support for reading files at configuration time with the `fs` module
+
+Reading text files during configuration is now supported. This can be done at
+any time after `project` has been called
+
+```meson
+project('myproject', 'c')
+license_text = run_command(
+    find_program('python3'), '-c', 'print(open("COPYING").read())'
+).stdout().strip()
+about_header = configuration_data()
+about_header.add('COPYRIGHT', license_text)
+about_header.add('ABOUT_STRING', meson.project_name())
+...
+```
+
+There are several problems with the above approach:
+1. It's ugly and confusing
+2. If `COPYING` changes after configuration, Meson won't correctly rebuild when
+   configuration data is based on the data in COPYING
+3. It has extra overhead
+
+`fs.read` replaces the above idiom thus:
+```meson
+project('myproject', 'c')
+fs = import('fs')
+license_text = fs.read('COPYING').strip()
+about_header = configuration_data()
+about_header.add('COPYRIGHT', license_text)
+about_header.add('ABOUT_STRING', meson.project_name())
+...
+```
+
+They are not equivalent, though. Files read with `fs.read` create a
+configuration dependency on the file, and so if the `COPYING` file is modified,
+Meson will automatically reconfigure, guaranteeing the build is consistent. It
+can be used for any properly encoded text files. It supports specification of
+non utf-8 encodings too, so if you're stuck with text files in a different
+encoding, it can be passed as an argument. See the @meson
+documentation for details.
+
+## meson install --dry-run
+
+New option to meson install command that does not actually install files, but
+only prints messages.
+
+## Experimental support for C++ modules in Visual Studio
+
+Modules are a new C++ 20 feature for organising source code aiming to
+increase compilation speed and reliability. This support is
+experimental and may change in future releases. It only works with the
+latest preview release of Visual Studio.
+
+## Qt6 module
+
+A module for Qt6 is now available with the same functionality as the Qt5
+module.
+
+Currently finding Qt6 is only available via `qmake` as pkg-config files aren't
+generated (see QTBUG-86080(https://bugreports.qt.io/browse/QTBUG-86080)) and
+CMake support is not available for this module yet.
+
+## Unstable Rust module
+
+A new unstable module has been added to make using Rust with Meson easier.
+Currently, it adds a single function to ease defining Rust tests, as well as a
+wrapper around bindgen, making it easier to use.
+
+## Meson test() now accepts `protocol : 'rust'`
+
+This allows native Rust tests to be run and parsed by Meson; simply set the
+protocol to `rust` and Meson takes care of the rest.
+
+## MSVC/Clang-Cl Argument Changes/Cleanup
+
+* "Disable Debug" (`/Od`) is no longer manually specified for optimization levels {`0`,`g`} (it is already the default for MSVC).
+* "Run Time Checking" (`/RTC1`) removed from `debug` buildtype by default
+* Clang-CL `debug` buildtype arguments now match MSVC arguments
+* There is now no difference between `buildtype` flags and `debug` + `optimization` flags
+
+The /Od flag has been removed, as it is already the default in the MSVC compilers, and conflicts with other user options.
+
+/RTC1 conflicts with other RTC argument types as there are many different options, and has been removed by default.
+Run Time Checking can be enabled by manually adding `/RTC1` or other RTC flags of your choice.
+
+The `debug` buildtype for clang-cl added additional arguments compared to MSVC, which had more to do with optimization than debug. The arguments removed are `/Ob0`, `/Od`, `/RTC1`. (`/Zi` was also removed, but it is already added by default when debug is enabled.)
+
+If these are important issues for you and would like builtin toggle options,
+please file an issue in the Meson bug tracker.
+
+## Buildtype remains even if dependent options are changed
+
+Setting the `buildtype` option to a value sets the `debug` and
+`optimization` options to predefined values. Traditionally setting the
+options to other values would then change the buildtype to `custom`.
+This is confusing and means that you can't use, for example, debug
+level `g` in `debug` buildtype even though it would make sense under
+many circumstances.
+
+Starting with this release, the buildtype is only changed when the user
+explicitly sets it; setting the build type modifies the `debug` and
+`optimization` options as before.
+
+## Passing internal dependencies to the compiler object
+
+Methods on the compiler object (such as `compiles`, `links`, `has_header`)
+can be passed dependencies returned by `declare_dependency`, as long as they
+only specify compiler/linker arguments or other dependencies that satisfy
+the same requirements.
+
+## `unstable-external_project` improvements
+
+- Default arguments are added to `add_project()` in case some tags are not found
+  in `configure_options`: `'--prefix=@PREFIX@'`, `'--libdir=@PREFIX@/@LIBDIR@'`,
+  and `'--includedir=@PREFIX@/@INCLUDEDIR@'`. It was previously considered a fatal
+  error to not specify them.
+
+- When the `verbose` keyword argument is not specified, or is false, command outputs
+  are written on file in `<builddir>/meson-logs/`.
+
+- The `LD` environment variable is not passed any more when running the configure
+  script. It caused issues because Meson sets `LD` to the `CC` linker wrapper but
+  autotools expects it to be a real linker (e.g. `/usr/bin/ld`).
+
+## `gnome.post_install()`
+
+Post-install update of various system wide caches. Each script will be executed
+only once even if `gnome.post_install()` is called multiple times from multiple
+subprojects. If `DESTDIR` is specified during installation all scripts will be
+skipped.
+
+Currently supports `glib-compile-schemas`, `gio-querymodules`, and
+`gtk-update-icon-cache`.
+
+## "Edit and continue" (/ZI) is no longer used by default for Visual Studio
+
+Meson was adding the `/ZI` compiler argument as an argument for Visual Studio
+in debug mode. This enables the `edit-and-continue` debugging in
+Visual Studio IDE's.
+
+Unfortunately, it is also extremely expensive and breaks certain use cases such
+as link time code generation. Edit and continue can be enabled by manually by
+adding `/ZI` to compiler arguments.
+
+The `/ZI` argument has now been replaced by the `/Zi` argument for debug builds.
+
+If this is an important issue for you and would like a builtin toggle option,
+please file an issue in the Meson bug tracker.
+
+## Minimum required Python version updated to 3.6
+
+Meson now requires at least Python version 3.6 to run as Python 3.5
+reaches EOL on September 2020. In practice this should only affect
+people developing on Ubuntu Xenial, which will similarly reach EOL in
+April 2021.
+
+## Packaging a subproject
+
+The `meson dist` command can now create a distribution tarball for a subproject
+in the same git repository as the main project. This can be useful if parts of
+the project (e.g. libraries) can be built and distributed separately. In that
+case they can be moved into `subprojects/mysub` and running `meson dist` in that
+directory will now create a tarball containing only the source code from that
+subdir and not the rest of the main project or other subprojects.
+
+For example:
+```sh
+git clone https://github.com/myproject
+cd myproject/subprojects/mysubproject
+meson setup builddir
+meson dist -C builddir
+```
+
+## `custom_target()` and `run_target()` now accepts an `env` keyword argument
+
+Environment variables can now be passed to the `custom_target()` command.
+
+```meson
+env = environment()
+env.append('PATH', '/foo')
+custom_target(..., env: env)
+custom_target(..., env: {'MY_ENV': 'value'})
+custom_target(..., env: 'MY_ENV=value')
+```
+
+## `summary()` accepts external programs or dependencies
+
+External program objects and dependency objects can be passed to
+`summary()` as the value to be printed.
+
+## CMake `find_package` version support
+
+It is now possible to specify a requested package version for the CMake
+dependency backend via the new `cmake_package_version` kwarg in the
+`dependency` function.
+
+## `meson test` only rebuilds test dependencies
+
+Until now, `meson test` rebuilt the whole project independent of the
+requested tests and their dependencies.  With this release, `meson test`
+will only rebuild what is needed for the tests or suites that will be run.
+This feature can be used, for example, to speed up bisecting regressions
+using commands like the following:
+
+    git bisect start <broken commit> <working commit>
+    git bisect run meson test <failing test name>
+
+This would find the broken commit automatically while at each step
+rebuilding only those pieces of code needed to run the test.
+
+However, this change could cause failures when upgrading to 0.57, if the
+dependencies are not specified correctly in `meson.build`.
+
+## The `add_*_script` methods now accept a File as the first argument
+
+Meson now accepts `file` objects, including those produced by
+`configure_file`, as the first parameter of the various
+`add_*_script` methods
+
+```meson
+install_script = configure_file(
+  configuration : conf,
+  input : 'myscript.py.in',
+  output : 'myscript.py',
+)
+
+meson.add_install_script(install_script, other, params)
+```
+
+## Unity build with Vala disabled
+
+The approach that meson has used for Vala unity builds is incorrect, we
+combine the generated C files like we would any other C file. This is very
+fragile however, as the Vala compiler generates helper functions and macros
+which work fine when each file is a separate translation unit, but fail when
+they are combined.
+
+## New logging format for `meson test`
+
+The console output format for `meson test` has changed in several ways.
+The major changes are:
+
+* if stdout is a tty, `meson` includes a progress report.
+
+* if `--print-errorlogs` is specified, the logs are printed as tests run
+rather than afterwards.  All the error logs are printed rather than only
+the first ten.
+
+* if `--verbose` is specified and `--num-processes` specifies more than
+one concurrent test, test output is buffered and printed after the
+test finishes.
+
+* the console logs include a reproducer command.  If `--verbose` is
+specified, the command is printed for all tests at the time they start;
+otherwise, it is printed for failing tests at the time the test finishes.
+
+* for TAP and Rust tests, Meson is able to report individual subtests.  If
+`--verbose` is specified, all tests are reported.  If `--print-errorlogs`
+is specified, only failures are.
+
+In addition, if `--verbose` was specified, Meson used not to generate
+logs.  This limitation has now been removed.
+
+These changes make the default `ninja test` output more readable, while
+`--verbose` output provides detailed, human-readable logs that
+are well suited to CI environments.
+
+## Specify DESTDIR on command line
+
+`meson install` command now has a `--destdir` argument that overrides `DESTDIR`
+from environment.
+
+## Skip install scripts if DESTDIR is set
+
+`meson.add_install_script()` now has `skip_if_destdir` keyword argument. If set
+to `true` the script won't be run if `DESTDIR` is set during installation. This is
+useful in the case the script updates system wide caches, or performs other tasks
+that are only needed when copying files into final destination.
+
+## Add support for prelinked static libraries
+
+The static library gains a new `prelink` keyword argument that can be
+used to prelink object files in that target. This is currently only
+supported for the GNU toolchain, patches to add it to other compilers
+are most welcome.
+
+## Rust now has an `std` option
+
+Rust calls these `editions`, however, Meson generally refers to such language
+versions as "standards", or `std` for short.  Therefore, Meson's Rust support
+uses `std` for consistency with other languages.
+
+## Ctrl-C behavior in `meson test`
+
+Starting from this version, sending a `SIGINT` signal (or pressing `Ctrl-C`)
+to `meson test` will interrupt the longest running test.  Pressing `Ctrl-C`
+three times within a second will exit `meson test`.
+
+## Support added for LLVM's thinLTO
+
+A new `b_lto_mode` option has been added, which may be set to `default` or
+`thin`. Thin only works for clang, and only with gnu gold, lld variants, or
+ld64.
+
+## `test()` timeout and timeout_multiplier value <= 0
+
+`test(..., timeout: 0)`, or negative value, used to abort the test immediately
+but now instead allow infinite duration. Note that omitting the `timeout`
+keyword argument still defaults to 30s timeout.
+
+Likewise, `add_test_setup(..., timeout_multiplier: 0)`, or
+`meson test --timeout-multiplier 0`, or negative value, disable tests timeout.
+
+
+## Knob to control LTO thread
+
+Both the gnu linker and lld support using threads for speeding up LTO, meson
+now provides a knob for this: `-Db_lto_threads`. Currently this is only
+supported for clang and gcc. Any positive integer is supported, `0` means
+`auto`. If the compiler or linker implements its own `auto` we use that,
+otherwise the number of threads on the machine is used.
+
+## `summary()` now uses left alignment for both keys and values
+
+Previously it aligned keys toward the center, but this was deemed harder
+to read than having everything left aligned.
+
+## `//` is now allowed as a function id for `meson rewrite`.
+
+msys bash may expand `/` to a path, breaking
+`meson rewrite kwargs set project / ...`. Passing `//` will be converted to
+`/` by msys bash but in order to keep usage shell-agnostic, this release
+also allows `//` as the id.  This way, `meson rewrite kwargs set project
+// ...` will work in both msys bash and other shells.
+
+## Get keys of configuration data object
+
+All keys of the `configuration_data` object can be obtained with the `keys()`
+method as an alphabetically sorted array.

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/Release-notes-for-0.58.0.md Added

@@ -0,0 +1,356 @@
+---
+title: Release 0.58.0
+short-description: Release notes for 0.58.0
+...
+
+# New features
+
+## New `meson.global_build_root()` and `meson.global_source_root()` methods
+
+Returns the root source and build directory of the main project.
+
+Those are direct replacement for `meson.build_root()` and `meson.source_root()`
+that have been deprecated since 0.56.0. In some rare occasions they could not be
+replaced by `meson.project_source_root()` or `meson.current_source_dir()`, in
+which case the new methods can now be used instead. Old methods are still
+deprecated because their names are not explicit enough and created many issues
+when a project is being used as a subproject.
+
+## Developer environment
+
+New method `meson.add_devenv()` adds an `environment()`(#environment) object
+to the list of environments that will be applied when using `meson devenv`
+command line. This is useful for developers who wish to use the project without
+installing it, it is often needed to set for example the path to plugins
+directory, etc. Alternatively, a list or dictionary can be passed as first
+argument.
+
+``` meson
+devenv = environment()
+devenv.set('PLUGINS_PATH', meson.current_build_dir())
+...
+meson.add_devenv(devenv)
+```
+
+New command line has been added: `meson devenv -C builddir <command>`.
+It runs a command, or open interactive shell if no command is provided, with
+environment setup to run project from the build directory, without installation.
+
+These variables are set in environment in addition to those set using `meson.add_devenv()`:
+- `MESON_DEVENV` is defined to `'1'`.
+- `MESON_PROJECT_NAME` is defined to the main project's name.
+- `PKG_CONFIG_PATH` includes the directory where Meson generates `-uninstalled.pc`
+  files.
+- `PATH` includes every directory where there is an executable that would be
+  installed into `bindir`. On windows it also includes every directory where there
+  is a DLL needed to run those executables.
+- `LD_LIBRARY_PATH` includes every directory where there is a shared library that
+  would be installed into `libdir`. This allows to run system application using
+  custom build of some libraries. For example running system GEdit when building
+  GTK from git. On OSX the environment variable is `DYLD_LIBRARY_PATH` and
+  `PATH` on Windows.
+- `GI_TYPELIB_PATH` includes every directory where a GObject Introspection
+  typelib is built. This is automatically set when using `gnome.generate_gir()`.
+
+## `-pipe` no longer used by default
+
+Meson used to add the `-pipe` command line argument to all compilers
+that supported it, but no longer does. If you need this, then you can
+add it manually. However note that you should not do this unless you
+have actually measured that it provides performance improvements. In
+our tests we could not find a case where adding `-pipe` made
+compilation faster and using `-pipe` can cause sporadic build
+failures in certain
+cases(https://github.com/mesonbuild/meson/issues/8508).
+
+## `meson.add_dist_script()` allowed in subprojects
+
+`meson.add_dist_script()` can now be invoked from a subproject, it was a hard
+error in earlier versions. Subproject dist scripts will only be executed
+when running `meson dist --include-subprojects`. `MESON_PROJECT_SOURCE_ROOT`,
+`MESON_PROJECT_BUILD_ROOT` and `MESON_PROJECT_DIST_ROOT` environment variables
+are set when dist scripts are run. They are identical to `MESON_SOURCE_ROOT`,
+`MESON_BUILD_ROOT` and `MESON_DIST_ROOT` for main project scripts, but for
+subproject scripts they have the path to the root of the subproject appended,
+usually `subprojects/<subproject-name>`.
+
+Note that existing dist scripts likely need to be modified to use those new
+environment variables instead of `MESON_DIST_ROOT` to work properly when used
+from a subproject.
+
+## Do not add custom target dir to header path if `implicit_include_directories` is `false`
+
+If you do the following:
+
+```meson
+# in some subdirectory
+gen_h = custom_target(...)
+# in some other directory
+executable('foo', 'foo.c', gen_h)
+```
+
+then the output directory of the custom target is automatically added
+to the header search path. This is convenient, but sometimes it can
+lead to problems. Starting with this version, the directory will no
+longer be put in the search path if the target has
+`implicit_include_directories: false`. In these cases you need to set
+up the path manually with `include_directories`.
+
+## Multiple append() and prepend() in `environment()` object
+
+`append()` and `prepend()` methods can now be called multiple times
+on the same `varname`. Earlier Meson versions would warn and only the last
+operation was taking effect.
+
+```meson
+env = environment()
+
+# MY_PATH will be '0:1:2:3'
+env.set('MY_PATH', '1')
+env.append('MY_PATH', '2')
+env.append('MY_PATH', '3')
+env.prepend('MY_PATH', '0')
+```
+
+
+## `dep.get_variable(varname)`
+
+`dep.get_variable()` now has `varname` as first positional argument.
+It is used as default value for `cmake`, `pkgconfig`, `configtool` and `internal`
+keyword arguments. It is useful in the common case where `pkgconfig` and `internal`
+use the same variable name, in which case it's easier to write `dep.get_variable('foo')`
+instead of `dep.get_variable(pkgconfig: 'foo', internal: 'foo')`.
+
+
+## clang-format include and ignore lists
+
+When clang-format is installed and a `.clang-format` file is found at the main
+project's root source directory, Meson automatically adds a `clang-format` target
+that reformat all C and C++ files.
+
+It is now possible to restrict files to be reformatted with optional
+`.clang-format-include` and `.clang-format-ignore` files.
+
+The file `.clang-format-include` contains a list of patterns matching the files
+that will be reformatted. The `**` pattern matches this directory and all
+subdirectories recursively. Empty lines and lines starting with `#` are ignored.
+If `.clang-format-include` is not found, the pattern defaults to `**/*` which
+means all files recursively in the source directory but has the disadvantage to
+walk the whole source tree which could be slow in the case it contains lots of
+files.
+
+Example of `.clang-format-include` file:
+```
+# All files in src/ and its subdirectories
+src/**/*
+
+# All files in include/ but not its subdirectories
+include/*
+```
+
+The file `.clang-format-ignore` contains a list of patterns matching the files
+that will be excluded. Files matching the include list (see above) that match
+one of the ignore pattern will not be reformatted. Unlike include patterns, ignore
+patterns does not support `**` and a single `*` match any characters including
+path separators. Empty lines and lines starting with `#` are ignored.
+
+The build directory and file without a well known C or C++ suffix are always
+ignored.
+
+Example of `.clang-format-ignore` file:
+```
+# Skip C++ files in src/ directory
+src/*.cpp
+```
+
+A new target `clang-format-check` has been added. It returns an error code if
+any file needs to be reformatted. This is intended to be used by CI.
+
+## Introducing format strings to the Meson language
+
+In addition to the conventional `'A string @0@ to be formatted @1@'.format(n, m)`
+method of formatting strings in the Meson language, there's now the additional
+`f'A string @n@ to be formatted @m@'` notation that provides a non-positional
+and clearer alternative. Meson's format strings are currently restricted to
+identity-expressions, meaning `f'format @'m' + 'e'@'` will not parse.
+
+## Skip subprojects installation
+
+It is now possible to skip installation of some or all subprojects. This is
+useful when subprojects are internal dependencies static linked into the main
+project.
+
+By default all subprojects are still installed.
+- `meson install -C builddir --skip-subprojects` installs only the main project.
+- `meson install -C builddir --skip-subprojects foo,bar` installs the main project
+  and all subprojects except for subprojects `foo` and `bar` if they are used.
+
+## String `.replace()`
+
+String objects now have a method called replace for replacing all instances of a
+substring in a string with another.
+
+```meson
+s = 'aaabbb'
+s = s.replace('aaa', 'bbb')
+# 's' is now 'bbbbbb'
+```
+
+## `meson.get_cross_property()` has been deprecated
+
+It's a pure subset of `meson.get_external_property`, and works strangely in
+host == build configurations, since it would be more accurately described as
+`get_host_property`.
+
+## New `range()` function
+
+``` meson
+    rangeobject range(stop)
+    rangeobject range(start, stop, step)
+```
+
+Return an opaque object that can be only be used in `foreach` statements.
+- `start` must be integer greater or equal to 0. Defaults to 0.
+- `stop` must be integer greater or equal to `start`.
+- `step` must be integer greater or equal to 1. Defaults to 1.
+
+It cause the `foreach` loop to be called with the value from `start` included
+to `stop` excluded with an increment of `step` after each loop.
+
+```meson
+# Loop 15 times with i from 0 to 14 included.
+foreach i : range(15)
+   ...
+endforeach
+```
+
+The range object can also be assigned to a variable and indexed.
+```meson
+r = range(5, 10, 2)
+assert(r2 == 9)
+```
+
+
+## Xcode improvements
+
+The Xcode backend has been much improved and should now we usable
+enough for day to day development.
+
+## Use fallback from wrap file when force fallback
+
+Optional dependency like below will now fallback to the subproject
+defined in the wrap file in the case `wrap_mode` is set to `forcefallback`
+or `force_fallback_for` contains the subproject.
+
+```meson
+# required is false because we could fallback to cc.find_library(), but in the
+# forcefallback case this now configure the subproject.
+dep = dependency('foo-1.0', required: false)
+if not dep.found()
+  dep = cc.find_library('foo', has_headers: 'foo.h')
+endif
+```
+
+```ini
+wrap-file
+...
+provide
+dependency_names = foo-1.0
+```
+
+## `error()` with multiple arguments
+
+Just like `warning()` and `message()`, `error()` can now take more than one
+argument that will be separated by space.
+
+## Specify man page locale during installation
+
+Locale directories can now be passed to `install_man`:
+
+```meson
+# instead of
+# install_data('foo.fr.1', install_dir: join_paths(get_option('mandir'), 'fr', 'man1'), rename: 'foo.1')`
+install_man('foo.fr.1', locale: 'fr')
+```
+
+## Passing `custom_target()` output to `pkg.generate()`
+
+It is now allowed to pass libraries generated by a `custom_target()` to
+pkg-config file generator. The output filename must have a known library extension
+such as `.a`, `.so`, etc.
+
+## JNI System Dependency
+
+When building projects such as those interacting with the JNI, you need access
+to a few header files located in a Java installation. This system dependency
+will add the correct include paths to your target. It assumes that either
+`JAVA_HOME` will be set to a valid Java installation, or the default `javac` on
+your system is a located in the `bin` directory of a Java installation. Note:
+symlinks are resolved.
+
+```meson
+jni_dep = dependency('jni', version : '>=1.8')
+```
+
+Currently this system dependency only works on `linux`, `win32`, and `darwin`.
+This can easily be extended given the correct information about your compiler
+and platform in an issue.
+
+## `meson subprojects update --reset` now re-extract tarballs
+
+When using `--reset` option, the source tree of `wrap-file` subprojects is now
+deleted and re-extracted from cached tarballs, or re-downloaded. This is because
+Meson has no way to know if the source tree or the wrap file has been modified,
+and `--reset` should guarantee that latest code is being used on next reconfigure.
+
+Use `--reset` with caution if you do local changes on non-git subprojects.
+
+## Allow using generator with CustomTarget or Index of CustomTarget.
+
+Calling `generator.process()` with either a CustomTarget or Index of CustomTarget
+as files is now permitted.
+
+## Qt Dependency uses a Factory
+
+This separates the Pkg-config and QMake based discovery methods into two
+distinct classes in the backend. This allows using
+`dependency.get_variable()` and `dependency.get_pkg_config_variable()`, as
+well as being a cleaner implementation.
+
+## Purge subprojects folder
+
+It is now possible to purge a subprojects folder of artifacts created
+from wrap-based subprojects including anything in `packagecache`. This is useful
+when you want to return to a completely clean source tree or busting caches with
+stale patch directories or caches. By default the command will only print out
+what it is removing. You need to pass `--confirm` to the command for actual
+artifacts to be purged.
+
+By default all wrap-based subprojects will be purged.
+
+- `meson subprojects purge` prints non-cache wrap artifacts which will be
+purged.
+- `meson subprojects purge --confirm` purges non-cache wrap artifacts.
+- `meson subprojects purge --confirm --include-cache` also removes the cache
+artifacts.
+- `meson subprojects purge --confirm subproj1 subproj2` removes non-cache wrap
+artifacts associated with the listed subprojects.
+
+## Check if native or cross-file properties exist
+
+It is now possible to check whether a native property or a cross-file property
+exists with `meson.has_external_property('foo')`. This is useful if the
+property in question is a boolean and one wants to distinguish between
+"set" and "not provided" which can't be done the usual way by passing a
+fallback parameter to `meson.get_external_property()` in this particular case.
+
+## `summary()` accepts features
+
+Build feature options can be passed to `summary()` as the value to be printed.
+
+## Address sanitizer support for Visual Studio
+
+The `b_sanitize` option for enabling Address sanitizer now works with
+the Visual Studio compilers. This requires a sufficiently new version
+of Visual
+Studio(https://devblogs.microsoft.com/cppblog/address-sanitizer-for-msvc-now-generally-available/).

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/Release-notes-for-0.59.0.md Added

@@ -0,0 +1,234 @@
+---
+title: Release 0.59.0
+short-description: Release notes for 0.59.0
+...
+
+# New features
+
+## Unescaped variables in pkgconfig files
+
+Spaces in variable values are escaped with `\`, this is required in the case the
+value is a path that and is used in `cflags` or `libs` arguments. This was an
+undocumented behaviour that caused issues in the case the variable is a space
+separated list of items.
+
+For backward compatibility reasons this behaviour could not be changed, new
+keyword arguments have thus been added: `unescaped_variables` and
+`unescaped_uninstalled_variables`.
+
+```meson
+pkg = import('pkgconfig')
+...
+pkg.generate(lib,
+  variables: {
+    'mypath': '/path/with spaces/are/escaped',
+  },
+  unescaped_variables: {
+    'mylist': 'Hello World Is Not Escaped',
+  },
+)
+```
+
+## The custom_target() function now accepts a feed argument
+
+It is now possible to provide a `feed: true` argument to `custom_target()` to
+pipe the target's input file to the program's standard input.
+
+## Separate functions for qt preprocess
+
+`qt.preprocess` is a large, complicated function that does a lot of things,
+a new set of `compile_*` functions have been provided as well. These are
+conceptually simpler, as they do a single thing.
+
+## Cython as as first class language
+
+Meson now supports Cython as a first class language. This means you can write:
+
+```meson
+project('my project', 'cython')
+
+py = import('python').find_installation()
+dep_py = py.dependency()
+
+py.extension_module(
+    'foo',
+    'foo.pyx',
+    dependencies : dep_py,
+)
+```
+
+And avoid the step through a generator that was previously required.
+
+## Support for the Wine Resource Compiler
+
+Users can now choose `wrc` as the `windres` binary in their cross files and
+`windows.compile_resources` will handle it correctly. Together with `winegcc`
+patches in Wine 6.12 this enables basic support for compiling projects as a
+winelib by specifying `winegcc`/`wineg++` as the compiler and `wrc` as the
+resource compiler in a cross file.
+
+## New `vs2012` and `vs2013` backend options
+
+Adds the ability to generate Visual Studio 2012 and 2013 projects.  This is an
+extension to the existing Visual Studio 2010 projects so that it is no longer
+required to manually upgrade the generated Visual Studio 2010 projects.
+
+Generating Visual Studio 2010 projects has also been fixed since its developer
+command prompt does not provide a `%VisualStudioVersion%` envvar.
+
+## Developer environment
+
+Expand the support for the `link_whole:` project option for pre-Visual Studio 2015
+Update 2, where previously Visual Studio 2015 Update 2 or later was required for
+this, for the Ninja backend as well as the vs2010 (as well as the newly-added
+vs2012 and vs2013 backends).
+
+## Fs Module now accepts files objects
+
+It is now possible to define a `files()` object and run most Fs module
+functions on the file, rather than passing a string and hoping it is in the
+same directory.
+
+
+## Compiler argument checking for `get_supported_arguments`
+
+The compiler method `get_supported_arguments` now supports
+a new keyword argument named `checked` that can be set to
+one of `warn`, `require` or `off` (defaults to `off`) to
+enforce argument checks.
+
+## New custom dependency for libintl
+
+Meson can now find the library needed for translating messages via gettext.
+This works both on systems where libc provides gettext, such as GNU or musl,
+and on systems where the gettext project's standalone intl support library is
+required, such as macOS.
+
+Rather than doing something such as:
+
+```
+intl_dep = dependency('', required: false)
+
+if cc.has_function('ngettext')
+  intl_found = true
+else
+  intl_dep = cc.find_library('intl', required: false)
+  intl_found = intl_dep.found()
+endif
+
+if intl_found
+  # build options that need gettext
+  conf.set('ENABLE_NLS', 1)
+endif
+```
+
+one may simply use:
+
+```
+intl_dep = dependency('intl', required: false)
+
+if intl_dep.found()
+  # build options that need gettext
+  conf.set('ENABLE_NLS', 1)
+endif
+```
+
+## Parallelized `meson subprojects` commands
+
+All `meson subprojects` commands are now run on each subproject in parallel by
+default. The number of processes can be controlled with `--num-processes`
+argument.
+
+This speeds up considerably IO-bound operations such as downloads and git fetch.
+
+## Using Vala no longer requires C in the project languages
+
+Meson will now add C automatically. Since the use of C is an implementation
+detail of Vala, Meson shouldn't require users to add it.
+
+## The `import()` function gains `required` and `disabler` arguments
+
+In addition, modules now have a `found()` method, like programs and
+dependencies. This allows them to be conditionally required, and used in most
+places that an object with a `found()` method can be.
+
+## Objective C/C++ standard versions
+
+Objective C and C++ compilations will from now on use the language
+versions set in `c_std` and `cpp_std`, respectively. It is not
+possible to set the language version separately for Objective C and
+plain C.
+
+## Qt.preprocess source arguments deprecated
+
+The `qt.preprocess` method currently has this signature:
+`qt.preprocess(name: str | None, *srcs: str)`, this is not a nice signature
+because it's confusing, and there's a `sources` keyword argument as well.
+Both of these pass sources through unmodified, this is a bit of a historical
+accident, and not the way that any other module works. These have been
+deprecated, so instead of:
+```meson
+sources = qt.preprocess(
+    name,
+    list, of, sources,
+    sources : more, sources,
+    ... # things to process,
+)
+
+executable(
+    'foo',
+    sources,
+)
+```
+use
+```meson
+processed = qt.preprocess(
+    name,
+    ... # thins to process
+)
+
+executable(
+    'foo',
+    'list', 'of', 'sources', 'more', 'sources', processed,
+)
+```
+
+## New `build target` methods
+
+The @build_tgt object now supports
+the following two functions, to ensure feature compatebility with
+@external_program objects:
+
+- `found()`: Always returns `true`. This function is meant
+  to make executables objects feature compatible with
+  `external program` objects. This simplifies
+  use-cases where an executable is used instead of an external program.
+
+- `path()`: **(deprecated)** does the exact same as `full_path()`.
+  **NOTE:** This function is solely kept for compatebility
+  with `external program` objects. It will be
+  removed once the, also deprecated, corresponding `path()` function in the
+  `external program` object is removed.
+
+## Automatically set up Visual Studio environment
+
+When Meson is run on Windows it will automatically set up the
+environment to use Visual Studio if no other compiler toolchain
+can be detected. This means that you can run Meson commands from
+any command prompt or directly from any IDE. This sets up the
+64 bit native environment. If you need any other, then you
+need to set it up manually as before.
+
+## `gnome.compile_schemas()` sets `GSETTINGS_SCHEMA_DIR` into devenv
+
+When using `gnome.compile_schemas()` the location of the compiled schema is
+added to `GSETTINGS_SCHEMA_DIR` environment variable when using
+`meson devenv`(Commands.md#devenv) command.
+
+## `update_desktop_database` added to `gnome.post_install()`
+
+Applications that install a `.desktop` file containing a `MimeType` need to update
+the cache upon installation. Most applications do that using a custom script,
+but it can now be done by Meson directly.
+
+See `gnome.post_install()`(Gnome-module.md#gnomepost_install).

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/Release-notes-for-0.60.0.md Added

@@ -0,0 +1,402 @@
+---
+title: Release 0.60.0
+short-description: Release notes for 0.60.0
+...
+
+# New features
+
+## `run_target` can now be used as a dependency
+
+A `run_target()` can now be saved in a variable and reused as a dependency in
+an `alias_target()`. This can be used to create custom alias rules that ensure
+multiple other targets are run, even if those targets don't produce output
+files.
+
+For example:
+
+```
+i18n = import('i18n')
+
+all_pot_targets = 
+
+foo_i18n = i18n.gettext('foo')
+
+all_pot_targets += foo_i18n1
+
+alias_target('all-pot', all_pot_targets)
+```
+
+## The Python Modules dependency method no longer accepts positional arguments
+
+Previously these were ignored with a warning, now they're a hard error.
+
+## `unset_variable()`
+
+`unset_variable()` can be used to unset a variable. Reading a variable after
+calling `unset_variable()` will raise an exception unless the variable is set
+again.
+
+```meson
+# tests/meson.build
+tests = 'test1', 'test2'
+
+# ...
+
+unset_variable('tests')
+
+# tests is no longer usable until it is set again
+```
+
+## Override python installation paths
+
+The `python` module now has options to control where modules are installed:
+- python.platlibdir: Directory for site-specific, platform-specific files.
+- python.purelibdir: Directory for site-specific, non-platform-specific files.
+
+Those options are used by python module methods `python.install_sources()` and
+`python.get_install_dir()`. By default Meson tries to detect the correct installation
+path, but make them relative to the installation `prefix`, which will often result
+in installed python modules to not be found by the interpreter unless `prefix`
+is `/usr` on Linux, or for example `C:\Python39` on Windows. These new options
+can be absolute paths outside of `prefix`.
+
+## New `subprojects packagefiles` subcommand
+
+It is now possible to re-apply `meson.build` overlays (`patch_filename` or
+`patch_directory` in the wrap ini file) after a subproject was downloaded and
+set up, via `meson subprojects packagefiles --apply <wrap-name>`.
+
+It is also possible for `patch_directory` overlays in a `wrap-file`, to copy
+the packagefiles out of the subproject and back into `packagefiles/<patch_directory>/`
+via `meson subprojects packagefiles --save <wrap-name>`. This is useful for
+testing an edit in the subproject and then saving it back to the overlay which
+is checked into git.
+
+## Deprecated project options
+
+Project options declared in `meson_options.txt` can now be marked as deprecated
+and Meson will warn when user sets a value to it. It is also possible to deprecate
+only some of the choices, and map deprecated values to a new value.
+
+```meson
+# Option fully deprecated, it warns when any value is set.
+option('o1', type: 'boolean', deprecated: true)
+
+# One of the choices is deprecated, it warns only when 'a' is in the list of values.
+option('o2', type: 'array', choices: 'a', 'b', deprecated: 'a')
+
+# One of the choices is deprecated, it warns only when 'a' is in the list of values
+# and replace it by 'c'.
+option('o3', type: 'array', choices: 'a', 'b', 'c', deprecated: {'a': 'c'})
+
+# A boolean option has been replaced by a feature, old true/false values are remapped.
+option('o4', type: 'feature', deprecated: {'true': 'enabled', 'false': 'disabled'})
+
+# A feature option has been replaced by a boolean, enabled/disabled/auto values are remapped.
+option('o5', type: 'boolean', deprecated: {'enabled': 'true', 'disabled': 'false', 'auto': 'false'})
+```
+
+## More efficient static linking of uninstalled libraries
+
+**Note**: This change had to be reverted in 0.60.1 because it caused regressions.
+  New API will likely be introduced in 0.61.0 to have better control whether or
+  not to create thin archive.
+
+A somewhat common use case of static_library is to create uninstalled
+internal convenience libraries which are solely meant to be linked to other
+targets. Some build systems call these "object libraries". Meson's
+implementation does always create a static archive.
+
+This will now check to see if the static linker supports "thin archives"
+(archives which do not contain the actual object code, only references to their
+location on disk) and if so, use them to minimize space usage and speed up
+linking.
+
+## gnome.yelp variadic argument deprecation
+
+`gnome.yelp` previously allowed sources to be passed either as variadic
+arguments or as a keyword argument. If the keyword argument was given the
+variadic arguments would be silently ignored. This has changed in 0.60.0, the
+variadic form has been deprecated, and a warning is printed if both are given.
+
+## `static` keyword argument to `meson.override_dependency()`
+
+It is now possible to override shared and/or static dependencies separately.
+When the `static` keyword argument is not specified in `dependency()`, the first
+override will be used (`static_dep` in the example below).
+```meson
+static_lib = static_library()
+static_dep = declare_dependency(link_with: static_lib)
+meson.override_dependency('foo', static_dep, static: true)
+
+shared_lib = shared_library()
+shared_dep = declare_dependency(link_with: shared_lib)
+meson.override_dependency('foo', shared_dep, static: false)
+
+# Returns static_dep
+dependency('foo')
+
+# Returns static_dep
+dependency('foo', static: true)
+
+# Returns shared_dep
+dependency('foo', static: false)
+```
+
+When the `static` keyword argument is not specified in `meson.override_dependency()`,
+the dependency is assumed to follow the value of `default_library` option.
+```meson
+dep = declare_dependency(...)
+meson.override_dependency('foo', dep)
+
+# Always works
+dependency('foo')
+
+# Works only if default_library is 'static' or 'both'
+dependency('foo', static: true)
+
+# Works only if default_library is 'shared' or 'both'
+dependency('foo', static: false)
+```
+
+## `dependency()` sets `default_library` on fallback subproject
+
+When the `static` keyword argument is set but `default_library` is missing in
+`default_options`, `dependency()` will set it when configuring fallback
+subproject. `dependency('foo', static: true)` is now equivalent to
+`dependency('foo', static: true, default_options: 'default_library=static')`.
+
+## install_emptydir function
+
+It is now possible to define a directory which will be created during
+installation, without creating it as a side effect of installing files into it.
+This replaces custom `meson.add_install_script()` routines. For example:
+
+```meson
+meson.add_install_script('sh', '-c', 'mkdir -p "$DESTDIR/@0@"'.format(path))
+```
+
+can be replaced by:
+
+```meson
+install_emptydir(path)
+```
+
+and as a bonus this works reliably on Windows, prints a sensible progress
+message, will be uninstalled by `ninja uninstall`, etc.
+
+## Cython can now transpile to C++ as an intermediate language
+
+Built-in cython support currently only allows C as an intermediate language, now
+C++ is also allowed. This can be set via the `cython_language` option, either on
+the command line, or in the meson.build files.
+
+```meson
+project(
+  'myproject',
+  'cython',
+  default_options : 'cython_language=cpp',
+)
+```
+
+or on a per target basis with:
+```meson
+python.extension_module(
+  'mod',
+  'mod.pyx',
+  override_options : 'cython_language=cpp',
+)
+```
+
+## New custom dependency for iconv
+
+```
+dependency('iconv')
+```
+
+will now check for the functionality of libiconv.so, but first check if it is
+provided in the libc (for example in glibc or musl libc on Linux).
+
+## Unknown options are now always fatal
+
+Passing unknown options to "meson setup" or "meson configure" is now
+always fatal. That is, Meson will exit with an error code if this
+happens. Previous Meson versions only showed a warning message.
+
+## Install DESTDIR relative to build directory
+
+When `DESTDIR` environment or `meson install --destdir` option is a relative path,
+it is now assumed to be relative to the build directory. An absolute path will be
+set into environment when executing scripts. It was undefined behavior in prior
+Meson versions but was working as relative to build directory most of the time.
+
+## Java Module
+
+The Java module has been added to Meson. The Java module allows users to
+generate native header files without needing to use a `custom_target()`.
+
+```meson
+jmod = import('java')
+
+native_header = jmod.generate_native_header('File.java', package: 'com.mesonbuild')
+native_header_includes = include_directories('.')
+
+jdkjava = shared_module(
+  'jdkjava',
+  native_header_includes, other_sources,
+  dependencies : jdk,
+  include_directories : native_header_includes
+)
+```
+
+## Link tests can use sources for a different compiler
+
+Usually, the `links` method of the compiler object uses a single program
+invocation to do both compilation and linking.  Starting with this version,
+whenever the argument to `links` is a file, Meson will check if the file
+suffix matches the compiler object's language.  If they do not match,
+as in the following case:
+
+```
+cxx = meson.get_compiler('cpp')
+cxx.links(files('test.c'))
+```
+
+then Meson will separate compilation and linking.  In the above example
+`test.c` will be compiled with a C compiler and the resulting object file
+will be linked with a C++ compiler.  This makes it possible to detect
+misconfigurations of the compilation environment, for example when the
+C++ runtime is not compatible with the one expected by the C compiler.
+
+For this reason, passing file arguments with an unrecognized suffix to
+`links` will cause a warning.
+
+## Relax restrictions of `str.join()`
+
+Since 0.60.0, the str.join method can take an arbitrary number of arguments
+instead of just one list. Additionally, all lists past to str.join will now
+be flattened.
+
+## Improvements for the Rustc compiler
+
+- Werror now works, this set's `-D warnings`, which will cause rustc to error
+  for every warning not explicitly disabled
+- warning levels have been implemented
+- support for meson's pic has been enabled
+
+## The qt modules now accept generated outputs as inputs for qt.compile_*
+
+This means you can uset `custom_target`, custom_target indices
+(`custom_target0`, for example), or the output of `generator.process` as
+inputs to the various `qt.compile_*` methods.
+
+```meson
+qt = import('qt5')
+
+ct = custom_target(...)
+
+out = qt.compile_ui(sources : ct)
+```
+
+## Waf support in external-project module
+
+If the first argument is `'waf'`, special treatment is done for the
+waf(https://waf.io/) build system. The waf executable must be
+found either in the current directory, or in system `PATH`.
+
+## Comparing two objects with different types is now an error
+
+Using the `==` and `!=` operators to compare objects of different (for instance
+`1 == 1`) types was deprecated and undefined behavior since 0.45.0 and is
+now a hard error.
+
+## Installation tags
+
+It is now possible to install only a subset of the installable files using
+`meson install --tags tag1,tag2` command line.
+
+See documentation(Installing.md#installation-tags) for more details.
+
+## Compiler.unittest_args has been removed
+
+It's never been documented, and it's been marked deprecated for a long time, so
+let's remove it.
+
+## Dependencies with multiple names
+
+More than one name can now be passed to `dependency()`, they will be tried in order
+and the first name to be found will be used. The fallback subproject will be
+used only if none of the names are found on the system. Once one of the name has
+been found, all other names are added into the cache so subsequent calls for any
+of those name will return the same value. This is useful in case a dependency
+could have different names, such as `png` and `libpng`.
+
+## i18n module now returns gettext targets
+
+`r = i18n.gettext('mydomain')` will now provide access to:
+- a list of built .mo files
+- the mydomain-pot maintainer target which updates .pot files
+- the mydomain-update-po maintainer target which updates .po files
+
+## Added support for CLA sources when cross-compiling with the C2000 toolchain
+
+Support for CLA sources has been added for cross-compilation with the C2000 toolchain.
+
+## Support for clippy-driver as a rustc wrapper
+
+Clippy is a popular linting tool for Rust, and is invoked in place of rustc as a
+wrapper. Unfortunately it doesn't proxy rustc's output, so we need to have a
+small wrapper around it so that Meson can correctly detect the underlying rustc,
+but still display clippy
+
+## Force Visual Studio environment activation
+
+Since `0.59.0`, meson automatically activates Visual Studio environment on Windows
+for all its subcommands, but only if no other compilers (e.g. `gcc` or `clang`)
+are found, and silently continue if Visual Studio activation fails.
+
+`meson setup --vsenv` command line argument can now be used to force Visual Studio
+activation even when other compilers are found. It also make Meson abort with an
+error message when activation fails. This is especially useful for Github Action
+because their Windows images have gcc in their PATH by default.
+
+`--vsenv` is set by default when using `vs` backend.
+
+Only `setup`, `compile`, `dist` and `devenv` subcommands now activate Visual Studio.
+
+## MSVC compiler now assumes UTF-8 source code by default
+
+Every project that uses UTF-8 source files had to add manually `/utf-8` C/C++
+compiler argument for MSVC otherwise they wouldn't work on non-English locale.
+Meson now switched the default to UTF-8 to be more consistent with all other
+compilers.
+
+This can be overridden but using `/source-charset`:
+```meson
+if cc.get_id() == 'msvc'
+  add_project_arguments('/source-charset:.XYZ', language: 'c', 'cpp')
+endif
+```
+
+See Microsoft documentation for details:
+https://docs.microsoft.com/en-us/cpp/build/reference/source-charset-set-source-character-set.
+
+## Add support for `find_library` in Emscripten
+
+The `find_library` method can be used to find your own JavaScript
+libraries. The limitation is that they must have the file extension
+`.js`. Other library lookups will look up "native" libraries from the
+system like currently. A typical usage would look like this:
+
+```meson
+glue_lib = cc.find_library('gluefuncs.js',
+                           dirs: meson.current_source_dir())
+executable('prog', 'prog.c',
+           dependencies: glue_lib)
+```
+
+## Optional `custom_target()` name
+
+The name argument is now optional and defaults to the basename of the first
+output.
+

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/Release-notes-for-0.61.0.md Added

@@ -0,0 +1,138 @@
+---
+title: Release 0.61.0
+short-description: Release notes for 0.61.0
+...
+
+# New features
+
+## backend_startup_project
+
+`backend_startup_project` will no longer erase the last project in a VS
+solution if it is not the specified project.
+
+## Windows.compile_resources CustomTarget
+
+Previously the Windows module only accepted CustomTargets with one output, it
+now accepts them with more than one output, and creates a windows resource
+target for each output. Additionally it now accepts indexes of CustomTargets
+
+```meson
+
+ct = custom_target(
+  'multiple',
+  output : 'resource', 'another resource',
+  ...
+)
+
+ct2 = custom_target(
+  'slice',
+  output : 'resource', 'not a resource',
+  ...
+)
+
+resources = windows.compile_resources(ct, ct20)
+```
+
+## Add a man page backend to refman
+
+The refman docs (function and object reference) can now be generated as a man
+page.
+
+## ``extract_objects()`` supports generated sources
+
+Custom targets or generated files (returned by ``generator.process()``)
+can now be passed to ``extract_objects()``.
+
+## Python 3.6 support will be dropped in the next release
+
+The final Python 3.6 release was 3.6.15 in September(https://www.python.org/dev/peps/pep-0494/#lifespan).
+This release series is now End-of-Life (EOL). The only LTS distribution that
+still ships Python 3.5 as the default Python is Ubuntu 18.04, which has Python
+3.8 available as well.
+
+Python 3.7 has various features that we find useful such as future annotations,
+the importlib.resources module, and dataclasses.
+
+As a result, we will begin requiring Python 3.7 or newer in Meson 0.62, which
+is the next release. Starting with Meson 0.61, we now print a `NOTICE:` when
+a `meson` command is run on Python 3.6 to inform users about this.
+
+## Warning if check kwarg of run_command is missing
+
+The `check` kwarg of `run_command` currently defaults to `false`.
+Because we want to change that, running
+```meson
+run_command('cmd')
+```
+now results in:
+```text
+WARNING: You should add the boolean check kwarg to the run_command call.
+         It currently defaults to false,
+         but it will default to true in future releases of meson.
+         See also: https://github.com/mesonbuild/meson/issues/9300
+```
+
+## `meson rewrite` can modify `extra_files`
+
+The build script rewriter can now modify targets' `extra_files` lists,
+or create them if absent. It it used in the same way as with rewriting
+source lists:
+
+```bash
+meson rewrite target <target name/id> {add_extra_files/rm_extra_files} list of extra files
+```
+
+The rewriter's script mode also supports these actions:
+
+```json
+{
+  "type": "target",
+  "target": "<target name>",
+  "operation": "extra_files_add / extra_files_rm",
+  "sources": "list", "of", "extra", "files", "to", "add, remove",
+}
+```
+
+## `meson rewrite target <target> info` outputs *target*'s `extra_files`
+
+Targets' `extra_files` lists are now included in the rewriter's target info dump
+as a list of file paths, in the same way `sources` are. This applies to both
+`meson rewrite` CLI and script mode.
+
+## Visual Studio 2022 backend
+
+As Visual Studio 2022 is released recently, it's time to support the
+new version in Meson. This mainly includes the new "v143" platform tools.
+
+The usage is similar to other backends. For example
+```meson
+meson setup builddir --backend=vs2022
+```
+will configure "builddir" for projects compatible with Visual Studio 2022.
+
+## Support for CMake <3.14 is now deprecated for CMake subprojects
+
+In CMake 3.14, the File API was introduced and the old CMake server API was
+deprecated (and removed in CMake 3.20). Thus support for this API will also
+be removed from Meson in future releases.
+
+This deprecation only affects CMake subprojects.
+
+## Added support for sccache
+
+Meson now supports sccache(https://github.com/mozilla/sccache) just
+like it has supported CCache. If both sccache and CCache are
+available, the autodetection logic prefers sccache.
+
+## install_symlink function
+
+It is now possible to request for symbolic links to be installed during
+installation. The `install_symlink` function takes a positional argument to
+the link name, and installs a symbolic link pointing to `pointing_to` target.
+The link will be created under `install_dir` directory and cannot contain path
+separators.
+
+```meson
+install_symlink('target', pointing_to: '../bin/target', install_dir: '/usr/sbin')
+```
+

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/Release-notes-for-0.62.0.md Added

@@ -0,0 +1,409 @@
+---
+title: Release 0.62.0
+short-description: Release notes for 0.62.0
+...
+
+# New features
+
+## Bash completion scripts sourced in `meson devenv`
+
+If bash-completion scripts are being installed and the shell is bash, they will
+be automatically sourced.
+
+## Setup GDB auto-load for `meson devenv`
+
+When GDB helper scripts (*-gdb.py, *-gdb.gdb, and *-gdb.csm) are installed with
+a library name that matches one being built, Meson adds the needed auto-load
+commands into `<builddir>/.gdbinit` file. When running gdb from top build
+directory, that file is loaded by gdb automatically.
+
+## Print modified environment variables with `meson devenv --dump`
+
+With `--dump` option, all envorinment variables that have been modified are
+printed instead of starting an interactive shell. It can be used by shell
+scripts that wish to setup their environment themself.
+
+## New `method` and `separator` kwargs on `environment()` and `meson.add_devenv()`
+
+It simplifies this common pattern:
+```meson
+env = environment()
+env.prepend('FOO', 'a', 'b', separator: ',')
+meson.add_devenv(env)
+```
+
+becomes one line:
+```meson
+meson.add_devenv({'FOO': 'a', 'b'}, method: 'prepend', separator: ',')
+```
+
+or two lines:
+```meson
+env = environment({'FOO': 'a', 'b'}, method: 'prepend', separator: ',')
+meson.add_devenv(env)
+```
+
+## New custom dependency for libdl
+
+```
+dependency('dl')
+```
+
+will now check for the functionality of libdl.so, but first check if it is
+provided in the libc (for example in libc on OpenBSD or in musl libc on linux).
+
+## pkgconfig.generate will now include variables for builtin directories when referenced
+
+When using the `variables:` family of kwargs to `pkgconfig.generate` to refer
+to installed paths, traditionally only `prefix`, `includedir`, and `libdir`
+were available by default, and generating a correct (relocatable) pkg-config
+file required manually constructing variables for e.g. `datadir`.
+
+Meson now checks each variable to see if it begins with a reference to a
+standard directory, and if so, adds it to the list of directories for which a
+builtin variable is created.
+
+For example, before it was necessary to do this:
+```meson
+pkgconfig.generate(
+    name: 'bash-completion',
+    description: 'programmable completion for the bash shell',
+    dataonly: true,
+    variables: {
+        'prefix': get_option('prefix'),
+        'datadir': join_paths('${prefix}', get_option('datadir')),
+        'sysconfdir': join_paths('${prefix}', get_option('sysconfdir')),
+
+        'compatdir': '${sysconfdir}/bash_completion.d',
+        'completionsdir': '${datadir}/bash-completion/completions',
+        'helpersdir': '${datadir}/bash-completion/helpers',
+    },
+    install_dir: join_paths(get_option('datadir'), 'pkgconfig'),
+)
+```
+
+Now the first three variables are not needed.
+
+## New keyword argument `verbose` for tests and benchmarks
+
+The new keyword argument `verbose` can be used to mark tests and benchmarks
+that must always be logged verbosely on the console.  This is particularly
+useful for long-running tests, or when a single Meson test() is wrapping
+an external test harness.
+
+## CMake support for versions <3.17.0 is deprecated
+
+Support for CMake versions below 3.17.0 is now deprecated for *both* CMake
+dependencies and subprojects.
+
+## Removal of the RPM module
+
+Due to lack of interest, lack of maintainership, and lack of a clear purpose,
+the RPM module has been removed.
+
+Users interested in one-shot tools to generate an RPM spec file template for
+distro packaging, are encouraged develop an external tool that reads the
+introspection data.
+
+For more details, see https://github.com/mesonbuild/meson/issues/9764
+
+## CMake server API support is removed
+
+Support for the
+deprecated (since CMake 3.15)(https://cmake.org/cmake/help/latest/release/3.15.html#deprecated-and-removed-features)
+and now
+removed (since CMake 3.20)(https://cmake.org/cmake/help/latest/release/3.20.html#deprecated-and-removed-features)
+CMake server API is dropped from Meson.
+
+The new CMake minimum version for CMake subprojects is now CMake 3.14.
+
+## Rust proc-macro crates
+
+Rust has these handy things called proc-macro crates, which are a bit like a
+compiler plugin. We can now support them, simply build a shared_library with
+the `rust_crate_type` set to `proc-macro`.
+
+```meson
+proc = shared_library(
+  'proc',
+  'proc.rs',
+  rust_crate_type : 'proc-macro',
+  install : false,
+)
+
+user = executable('user, 'user.rs', link_with : proc)
+```
+
+## found programs now have a version method
+
+The return value of find_program can now check the exact version of the
+found program, independent of the minimum version requirement. This can be used
+e.g. to perform different actions depending on the exact version detected.
+
+## Minimum required Python version updated to 3.7
+
+Meson now requires at least Python version 3.7 to run as Python 3.6 reached EOL
+on December 2021. In practice this should only affect people developing on
+Ubuntu Bionic, who will need to manually install python3.8 from the official
+repositories.
+
+
+## Added support for XML translations using itstool
+
+XML files can now be translated easier by using `itstool` via
+`i18n.itstool_join()`. This ensures the XML is translated correctly
+based on the defined ITS rules for the specific XML layout.
+
+## JNI System Dependency Modules
+
+The JNI system dependency now supports a `modules` keyword argument which is a
+list containing any of the following: `jvm`, `awt`.
+
+```meson
+jni_dep = dependency('jni', version: '>= 1.8.0', modules: 'jvm', 'awt')
+```
+
+This will add appropriate linker arguments to your target.
+
+## New unstable wayland module
+
+This module can search for protocol xml files from the wayland-protocols
+package, and generate .c and .h files using wayland-scanner.
+
+## Experimental command to convert environments to cross files
+
+Meson has a new command `env2mfile` that can be used to convert
+"environment variable based" cross and native compilation environments
+to Meson machine files. This is especially convenient for e.g. distro
+packagers so they can easily generate unambiguous configuration files
+for package building.
+
+As an example here's how you would generate a cross file that takes
+its settings from the `CC`, `CXX`, `CFLAGS` etc environment variables.
+
+    meson env2mfile --cross --system=baremetal --cpu=armv7 --cpu-family=arm -o armcross.txt
+
+The command also has support for generating Debian build files using
+system introspection:
+
+    meson env2mfile --cross --debarch armhf -o debarmhf_cross.txt
+
+Note how you don't need to specify any system details, the command
+gets them transparently via `dpkg-architecture`.
+
+Creating a native file is done in the same way:
+
+    meson env2mfile --native -o current_system.txt
+
+This system will detect if the `_FOR_BUILD` environment variables are
+enabled and then uses them as needed.
+
+With this you should be able to convert any envvar-based cross build
+setup to cross and native files and then use those. This means, among
+other things, that you can then run your compilations from any shell,
+not just the special one that has all the environment variables set.
+
+As this functionality is still a bit in flux, the specific behaviour
+and command line arguments to use are subject to change. Because of
+this the main documentation has not yet been updated.
+
+Please try this for your use cases and report to us if it is working.
+Patches to make the autodetection work on other distros and platforms
+are also welcome.
+
+## Added optional '--allow-dirty' flag for the 'dist' command
+
+An optional `--allow-dirty` flag has been added to the `dist` command.
+
+Previously, if uncommitted changes were present, Meson would warn about
+this but continue with the dist process. It now errors out instead. The
+error can be suppressed by using the `--allow-dirty` option.
+
+## ldconfig is no longer run on install
+
+Due to various issues of fragility and concern that it doesn't predictably do
+the right thing, meson no longer runs ldconfig during `meson install`, and
+users who need it run should run it themselves, instead.
+
+## Added support for Texas Instruments MSP430 and ARM compilers
+
+Meson now supports the TI MSP430(https://www.ti.com/tool/MSP-CGT) and
+ARM(https://www.ti.com/tool/ARM-CGT) toolchains. The compiler and linker are
+identified as `ti` and `ti-ar`, respectively. To maintain backwards
+compatibility with existing build definitions, the C2000
+toolchain(https://www.ti.com/tool/C2000-CGT) is still identified as `c2000` and
+`ar2000`.
+
+## cmake.configure_package_config_file can now take a dict
+
+The `configuration` kwarg of the `configure_package_config_file()` function
+from the `cmake` module can now take a dict object, just like the regular
+`configure_file()` function.
+
+## Deprecated `java.generate_native_header()` in favor of the new `java.generate_native_headers()`
+
+`java.generate_native_header()` was only useful for the most basic of
+situations. It didn't take into account that in order to generate native
+headers, you had to have all the referenced Java files. It also didn't take
+into account inner classes. Do not use this function from `0.62.0` onward.
+
+`java.generate_native_headers()` has been added as a replacement which should account for the previous function's shortcomings.
+
+```java
+// Outer.java
+
+package com.mesonbuild;
+
+public class Outer {
+    private static native void outer();
+
+    public static class Inner {
+        private static native void inner();
+    }
+}
+```
+
+With the above file, an invocation would look like the following:
+
+```meson
+java = import('java')
+
+native_headers = java.generate_native_headers(
+    'Outer.java',
+    package: 'com.mesonbuild',
+    classes: 'Outer', 'Outer.Inner'
+)
+```
+
+## New option to choose python installation environment
+
+It is now possible to specify `-Dpython.install_env` and choose how python modules are installed.
+
+- `venv`: assume that a virtualenv is active and install to that
+- `system`: install to the global site-packages of the selected interpreter
+  (the one that the venv module calls --system-site-packages)
+- `prefix`: preserve existing behavior
+- `auto`: autodetect whether to use venv or system
+
+## JDK System Dependency Renamed from `jdk` to `jni`
+
+The JDK system dependency is useful for creating native Java modules using the
+JNI. Since the purpose is to find the JNI, it has been decided that a better
+name is in fact "jni". Use of `dependency('jdk')` should be replaced with
+`dependency('jni')`.
+
+## i18n.merge_file no longer arbitrarily leaves your project half-built
+
+The i18n module partially accounts for builds with NLS disabled, by disabling
+gettext compiled translation catalogs if it cannot build them. Due to
+implementation details, this also disabled important data files created via
+merge_file, leading to important desktop files etc. not being installed.
+
+This overreaction has been fixed. It is no longer possible to have NLS-disabled
+builds which break the project by not installing important files which have
+nothing to do with NLS (other than including some).
+
+If you were depending on not having the Gettext tools installed and
+successfully mis-building your project, you may need to make your project
+actually work with NLS disabled, for example by providing some version of your
+files which is still installed even when merge_file cannot be run.
+
+## All directory options now support paths outside of prefix
+
+Previously, Meson only allowed most directory options to be relative to prefix.
+This restriction has been now lifted, bringing us in line with Autotools and
+CMake. It is also useful for platforms like Nix, which install projects into
+multiple independent prefixes.
+
+As a consequence, `get_option` might return absolute paths for any
+directory option, if a directory outside of prefix is passed. This
+is technically a backwards incompatible change but its effect
+should be minimal, thanks to widespread use of `join_paths`/
+`/` operator and pkg-config generator module.
+
+## `meson install --strip`
+
+It is now possible to strip targets using `meson install --strip` even if
+`-Dstrip=true` option was not set during configuration. This allows doing
+stripped and not stripped installations without reconfiguring the build.
+
+## Support for ARM Ltd. Clang toolchain
+
+Support for the `armltdclang` compiler has been added. This differs from the
+existing `armclang` toolchain in that it is a fork of Clang by ARM Ltd. and
+supports native compilation. The Keil `armclang` toolchain only supports
+cross-compilation to embedded devices.
+
+## structured_sources()
+
+A new function, `structured_sources()` has been added. This function allows
+languages like Rust which depend on the filesystem layout at compile time to mix
+generated and static sources.
+
+```meson
+executable(
+  'main',
+  structured_sources(
+    'main.rs,
+    {'mod' : generated_mod_rs},
+  )
+)
+```
+
+Meson will then at build time copy the files into the build directory (if
+necessary), so that the desired file structure is laid out, and compile that. In
+this case:
+
+```
+root/
+  main.rs
+  mod/
+    mod.rs
+```
+
+## New custom dependency for OpenSSL
+
+Detecting an OpenSSL installation in a cross-platform manner can be
+complicated. Officially, pkg-config is supported by upstream. Unofficially,
+cmake includes a FindOpenSSL using a different name and which requires
+specifying modules.
+
+Meson will now allow the pkg-config name to work in all cases using the following lookup order:
+- prefer pkg-config if at all possible
+- attempt to probe the system for the standard library naming, and retrieve the version from the headers
+- if all else fails, check if cmake can find it
+
+## D features in `declare_dependency`
+
+`declare_dependency`accepts parameters for D specific features.
+Accepted new parameters are `d_module_versions` and `d_import_dirs`.
+
+This can be useful to propagate conditional compilation versions. E.g.:
+
+```meson
+my_lua_dep = declare_dependency(
+    # ...
+    d_module_versions: 'LUA_53',
+    d_import_dirs: include_directories('my_lua_folder'),
+)
+```
+
+## arch_independent kwarg in cmake.write_basic_package_version_file
+
+The `write_basic_package_version_file()` function from the `cmake` module
+now supports an `arch_independent` kwarg, so that architecture checks in
+the generated Package Version file are skipped, reproducing the behaviour of
+CMake's ARCH_INDEPENDENT(https://cmake.org/cmake/help/latest/module/CMakePackageConfigHelpers.html#command:write_basic_package_version_file)
+option.
+
+## `dataonly` Pkgconfig Default Install Path
+
+The default install path for `dataonly` pkgconfig files has changed from
+`${libdir}/pkgconfig` to `${datadir}/pkgconfig`.
+
+## JAR default install dir
+
+The previous default for `jar()` was `libdir`. With this release, it has been
+changed to `datadir/java`. Please open an issue if this is not a sane default
+for your system.
+

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/Release-notes-for-0.63.0.md Added

@@ -0,0 +1,269 @@
+---
+title: Release 0.63.0
+short-description: Release notes for 0.63.0
+...
+
+# New features
+
+## `add_project_dependencies()` function
+
+Dependencies can now be added to all build products using
+`add_project_dependencies()`.  This can be useful in several
+cases:
+
+* with special dependencies such as `dependency('threads')`
+* with system libraries such as `find_library('m')`
+* with the `include_directories` keyword argument of
+`declare_dependency()`, to add both source and build
+directories to the include search path
+
+## Coverage targets now respect tool config files
+
+gcovr >= 4.2 supports `gcovr.cfg` in the project source root to configure how
+coverage is generated. If Meson detects that gcovr will load this file, it no
+longer excludes the `subprojects/` directory from coverage. It's a good default
+for Meson to guess that projects want to ignore it, but not all projects prefer
+that and it is assumed that if a gcovr.cfg exists then it will manually
+include/exclude desired paths.
+
+lcov supports `.lcovrc`, but only as a systemwide or user setting. This is
+non-ideal for projects, so Meson will now detect one in the project source root
+and, if present, manually tell lcov to use it.
+
+## D compiler checks
+
+Some compiler checks are implemented for D:
+ - `run`
+ - `sizeof`
+ - `has_header` (to check if a module is present)
+ - `alignment`
+
+Example:
+
+```meson
+ptr_size = meson.get_compiler('d').sizeof('void*')
+```
+
+## Deprecate an option and replace it with a new one
+
+The `deprecated` keyword argument can now take the name of a new option
+that replace this option. In that case, setting a value on the deprecated option
+will set the value on both the old and new names, assuming they accept the same
+values.
+
+```meson
+# A boolean option has been replaced by a feature with another name, old true/false values
+# are accepted by the new option for backward compatibility.
+option('o1', type: 'boolean', value: 'true', deprecated: 'o2')
+option('o2', type: 'feature', value: 'enabled', deprecated: {'true': 'enabled', 'false': 'disabled'})
+
+# A project option is replaced by a module option
+option('o3', type: 'string', value: '', deprecated: 'python.platlibdir')
+```
+
+## Running Windows executables with Wine in `meson devenv`
+
+When cross compiling for Windows, `meson devenv` now sets `WINEPATH` pointing to
+all directories containing needed DLLs and executables.
+
+## Diff files for wraps
+
+Wrap files can now define `diff_files`, a list of local patch files in `diff`
+format. Meson will apply the diff files after extracting or cloning the project,
+and after applying the overlay archive (`patch_*`). For this feature, the
+`patch` or `git` command-line tool must be available.
+
+## Added preserve_path arg to install_headers
+
+The install_headers function now has an optional argument `preserve_path`
+that allows installing multi-directory headerfile structures that live
+alongside sourcecode with a single command.
+
+For example, the headerfile structure
+
+```meson
+headers = 
+  'one.h',
+  'two.h',
+  'alpha/one.h',
+  'alpha/two.h',
+  'alpha/three.h'
+  'beta/one.h'
+
+```
+
+can now be passed to `install_headers(headers, subdir: 'mylib', preserve_path: true)`
+and the resulting directory tree will look like
+
+```
+{prefix}
+└── include
+    └── mylib
+        ├── alpha
+        │   ├── one.h
+        │   ├── two.h
+        │   └── three.h
+        ├── beta
+        │   └── one.h
+        ├── one.h
+        └── two.h
+```
+
+## JAR Resources
+
+The ability to add resources to a JAR has been added. Use the `java_resources`
+keyword argument. It takes a `sturctured_src` object.
+
+```meson
+jar(
+  meson.project_name(),
+  sources,
+  main_class: 'com.mesonbuild.Resources',
+  java_resources: structured_sources(
+    files('resources/resource1.txt'),
+    {
+      'subdir': files('resources/subdir/resource2.txt'),
+    }
+  )
+)
+```
+
+To access these resources in your Java application:
+
+```java
+try (InputStreamReader reader = new InputStreamReader(
+        Resources.class.getResourceAsStream("/resource1.txt"),
+        StandardCharsets.UTF_8)) {
+    // ...
+}
+
+try (InputStreamReader reader = new InputStreamReader(
+        Resources.class.getResourceAsStream("/subdir/resource2.txt"),
+        StandardCharsets.UTF_8)) {
+    // ...
+}
+```
+
+## Support for mold linker added
+
+The high performance linker mold can be selected via `CC_LD` or `CXX_LD` for
+Clang and GCC >= 12.0.1.
+
+## MSVC now sets the __cplusplus #define accurately
+
+MSVC will always return `199711L` for `__cplusplus`, even when a newer c++
+standard is explicitly requested, unless you pass a specific option to the
+compiler for MSVC 2017 15.7 and newer. Older versions are unaffected by this.
+
+Microsoft's stated rationale is that "a lot of existing code appears to depend
+on the value of this macro matching 199711L", therefore for compatibility with
+such (MSVC-only) code they will require opting in to the standards-conformant
+value.
+
+Meson now always sets the option if it is available, as it is unlikely that
+users want the default behavior, and *impossible* to use the default behavior
+in cross-platform code (which frequently breaks as soon as the first person
+tries to compile using MSVC).
+
+## Added `debug` function
+
+In addition to the `message()`, `warning()` and `error()` functions there is now the
+`debug()` function to log messages that only end up in the `meson-log.txt` logfile
+and are not printed to stdout at configure time.
+
+## Compiler options can be set per subproject
+
+All compiler options can now be set per subproject. See
+here(Build-options.md#specifying-options-per-subproject) for details on how
+the default value is inherited from main project.
+
+This is useful for example when the main project requires C++11 but a subproject
+requires C++14. The `cpp_std` value from subproject's `default_options` is now
+respected.
+
+## Per-subproject languages
+
+Subprojects does not inherit languages added by main project or other subprojects
+any more. This could break subprojects that wants to compile e.g. `.c` files but
+did not add `c` language, either in `project()` or `add_languages()`, and were
+relying on the main project to do it for them.
+
+## Installed pkgconfig files can now be relocatable
+
+The pkgconfig module now has a module option `pkgconfig.relocatable`.
+When set to `true`, the pkgconfig files generated will have their
+`prefix` variable set to be relative to their `install_dir`.
+
+For example to enable it from the command line run:
+
+```sh
+meson setup builddir -Dpkgconfig.relocatable=true …
+```
+
+It will only work if the `install_dir` for the generated pkgconfig
+files are located inside the install prefix of the package. Not doing
+so will cause an error.
+
+This should be useful on Windows or any other platform where
+relocatable packages are desired.
+
+## New prefer_static built-in option
+
+Users can now set a boolean, `prefer_static`, that controls whether or not
+static linking should be tried before shared linking. This option acts as
+strictly a preference. If the preferred linking method is not successful,
+then Meson will fallback and try the other linking method. Specifically
+setting the `static` kwarg in the meson.build will take precedence over
+the value of `prefer_static` for that specific `dependency` or
+`find_library` call.
+
+## Python extension modules now depend on the python library by default
+
+Python extension modules are usually expected to link to the python library
+and/or its headers in order to build correctly (via the default `embed: false`,
+which may not actually link to the library itself). This means that every
+single use of `.extension_module()` needed to include the `dependencies:
+py_installation.dependency()` kwarg explicitly.
+
+In the interest of doing the right thing out of the box, this is now the
+default for extension modules that don't already include a dependency on
+python. This is not expected to break anything, because it should always be
+needed. Nevertheless, `py_installation.dependency().partial_dependency()` will
+be detected as already included while providing no compile/link args.
+
+## Python extension modules now build with hidden visibility
+
+Python extension modules are usually expected to only export a single symbol,
+decorated with the `PyMODINIT_FUNC` macro and providing the module entry point.
+On versions of python >= 3.9, the python headers contain GNU symbol visibility
+attributes to mark the init function with default visibility; it is then safe
+to set the shared_module inherited kwarg `gnu_symbol_visibility: 'hidden'`.
+
+In the interest of doing the right thing out of the box, this is now the
+default for extension modules for found installations that are new enough to
+have this set, which is not expected to break anything, but remains possible to
+set explicitly (in which case that will take precedence).
+
+## Added support for multiline fstrings
+
+Added support for multiline f-strings which use the same syntax as f-strings
+for string substitution.
+
+```meson
+x = 'hello'
+y = 'world'
+
+msg = f'''Sending a message...
+"@x@ @y@"
+'''
+```
+
+which produces:
+
+```
+Sending a message....
+
+"hello world"
+
+```
+

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/Release-notes-for-0.64.0.md Added

@@ -0,0 +1,185 @@
+---
+title: Release 0.64.0
+short-description: Release notes for 0.64.0
+...
+
+# New features
+
+## Add `optimization` `plain` option
+
+The `optimization` built-in option now accepts `plain` value,
+which will not set any optimization flags. This is now the default
+value of the flag for `buildtype=plain`, which is useful for distros,
+that set the optimization and hardening flags by other means.
+
+If you are using the value of `get_option('optimization')` in your
+Meson scripts, make sure you are not making assumptions about it,
+such as that the value can be passed to a compiler in `-O` flag.
+
+## New languages: `nasm` and `masm`
+
+When the `nasm` language is added to the project, `.asm` files are
+automatically compiled with NASM. This is only supported for x86 and x86_64 CPU
+family. `yasm` is used as fallback if `nasm` command is not found.
+
+When the `masm` language is added to the project, `.masm` files are
+automatically compiled with Microsoft's Macro Assembler. This is only supported
+for x86, x86_64, ARM and AARCH64 CPU families.
+
+Note that GNU Assembly files usually have `.s` or `.S` extension and were already
+built using C compiler such as GCC or CLANG.
+
+```meson
+project('test', 'nasm')
+
+exe = executable('hello', 'hello.asm')
+test('hello', exe)
+```
+
+## Pager and colors for `meson configure` output
+
+The output of `meson configure`, printing all options, is now more readable by
+automatically using a pager (`less` by default) and colors. The pager used can
+be controlled by setting `PAGER` environment variable, or `--no-pager` command
+line option.
+
+## various `install_*` functions no longer handle the sticky bit
+
+It is not possible to portably grant the sticky bit to a file, and where
+possible, it doesn't do anything. It is not expected that any users are using
+this functionality.
+
+Variously:
+- on Linux, it has no meaningful effect
+- on Solaris, attempting to set the permission bit is silently ignored by the OS
+- on FreeBSD, attempting to set the permission bit is an error
+
+Attempting to set this permission bit in the `install_mode:` kwarg to any
+function other than install_emptydir will now result in a warning, and the
+permission bit being ignored.
+
+## `fs.copyfile` to replace `configure_file(copy : true)`
+
+A new method has been added to the `fs` module, `copyfile`. This method replaces
+`configure_file(copy : true)`, but only copies files. Unlike `configure_file()`
+it runs at build time, and the output name is optional defaulting to the
+filename without paths of the input if unset:
+
+```meson
+fs.copyfile('src/file.txt')
+```
+Will create a file in the current build directory called `file.txt`
+
+
+```meson
+fs.copyfile('file.txt', 'outfile.txt')
+```
+Will create a copy renamed to `outfile.txt`
+
+## Added `update_mime_database` to `gnome.post_install()`
+
+Applications that install a `.xml` file containing a `mime-type` need to update
+the cache upon installation. Most applications do that using a custom script,
+but it can now be done by Meson directly.
+
+## Added preserve_path arg to install_data
+
+The install_data function now has an optional argument `preserve_path`
+that allows installing multi-directory data file structures that live
+alongside source code with a single command.
+
+This is also available in the specialized `py_installation.install_sources`
+method.
+
+## BSD support for the `jni` dependency
+
+This system dependency now supports all BSD systems that Meson currently
+supports, including FreeBSD, NetBSD, OpenBSD, and DragonflyBSD.
+
+## Credentials from `~/.netrc` for `https` URLs
+
+When a subproject is downloaded using an `https://` URL, credentials from
+`~/.netrc` are now used. This avoids hardcoding login and password in plain
+text in the URL itself.
+
+## Basic support for oneAPI compilers on Linux and Windows
+
+To use on Linux:
+
+```
+source /opt/intel/oneapi/setvars.sh
+CC=icx CXX=icpx FC=ifx meson setup builddir
+```
+
+## New method to preprocess source files
+
+Compiler object has a new `preprocess()` method. It is supported by all C/C++
+compilers. It preprocess sources without compiling them.
+
+The preprocessor will receive the same arguments (include directories, defines,
+etc) as with normal compilation. That includes for example args added with
+`add_project_arguments()`, or on the command line with `-Dc_args=-DFOO`.
+
+```meson
+cc = meson.get_compiler('c')
+pp_files = cc.preprocess('foo.c', 'bar.c', output: '@PLAINNAME@')
+exe = executable('app', pp_files)
+```
+
+## python.find_installation() now accepts pure argument
+
+The default value of `pure:` for `py.install_sources()` and
+`py.get_install_dir()` can now be changed by explicitly passing a `pure:` kwarg
+to `find_installation()`.
+
+This can be used to ensure that multiple `install_sources()` invocations do not
+forget to specify the kwarg each time.
+
+## Generates rust-project.json when there are Rust targets
+
+This is a format similar to compile_commands.json, but specifically used by the
+official rust LSP, rust-analyzer. It is generated automatically if there are
+Rust targets, and is placed in the build directory.
+
+## `summary()` accepts disablers
+
+Disabler options can be passed to `summary()` as the value to be printed.
+
+## Option to allow meson test to fail fast after the first failing testcase
+
+`meson test --maxfail=1` will now cause all pending or in-progress tests to be
+canceled or interrupted after 1 test is marked as failing. This can be used for
+example to quit a CI run and avoid burning additional time as soon as it is
+known that the overall return status will be failing.
+
+## Incremental ThinLTO with `b_thinlto_cache`
+
+Incremental ThinLTO(https://clang.llvm.org/docs/ThinLTO.html#incremental) can now be enabled by passing
+`-Db_thinlto_cache=true` during setup. The use of caching speeds up incremental builds significantly while retaining all
+the runtime performance benefits of ThinLTO.
+
+The cache location defaults to a Meson-managed directory inside the build folder, but can be customized with
+`b_thinlto_cache_dir`.
+
+## Update all wraps from WrapDB with `meson wrap update` command
+
+The command `meson wrap update`, with no extra argument, will now update all wraps
+that comes from WrapDB to the latest version. The extra `--force` argument will
+also replace wraps that do not come from WrapDB if one is available.
+
+The command `meson subprojects update` will not download new wrap files from
+WrapDB any more.
+
+## Added `include_core_only` arg to wayland.scan_xml.
+
+The `scan_xml` function from the wayland module now has an optional bool
+argument `include_core_only`, so that headers generated by wayland-scanner now
+only include `wayland-client-core.h` instead of `wayland-client.h`.
+
+## Automatic fallback using WrapDB
+
+A new command has been added: `meson wrap update-db`. It downloads the list of
+wraps available in WrapDB(https://wrapdb.mesonbuild.com) and stores it locally in
+`subprojects/wrapdb.json`. When that file exists and a dependency is not found
+on the system but is available in WrapDB, Meson will automatically download it.
+

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/Release-notes-for-1.0.0.md Added

@@ -0,0 +1,85 @@
+---
+title: Release 1.0.0
+short-description: Release notes for 1.0.0
+...
+
+# New features
+
+Meson 1.0.0 was released on 23 December 2022
+## Compiler check functions `prefix` kwargs accepts arrays
+
+The `prefix` kwarg that most compiler check functions support
+now accepts an array in addition to a string. The elements of the
+array will be concatenated separated by a newline.
+
+This makes it more readable to write checks that need multiple headers
+to be included:
+
+```meson
+cc.check_header('GL/wglew.h', prefix : '#include <windows.h>', '#include <GL/glew.h>')
+```
+
+instead of
+
+```meson
+cc.check_header('GL/wglew.h', prefix : '#include <windows.h>\n#include <GL/glew.h>')
+```
+
+## Flags removed from cpp/objcpp warning level 1
+
+`-Wnon-virtual-dtor` is no longer implied by `meson setup -Dwarning_level=1`.
+
+## Developer environment improvements
+
+When cross compiling, the developer environment now sets all environment
+variables for the HOST machine. It now also sets `QEMU_LD_PREFIX` to the
+`sys_root` value from cross file if property is defined. That means that cross
+compiled executables can often be run transparently on the build machine, for
+example when cross compiling for aarch64 linux from x86_64 linux.
+
+A new argument `--workdir` has been added, by default it is set to build
+directory. For example, `meson devenv -C builddir --workdir .` can be used to
+remain in the current dir (often source dir) instead.
+
+`--dump` now prints shell commands like `FOO="/prepend/path:$FOO:/append/path"`,
+using the literal `$FOO` instead of current value of `FOO` from environment.
+This makes easier to evaluate those expressions in a different environment.
+
+## Deprecate `java.generate_native_headers`, rename to `java.native_headers`
+
+The functions operate in the exact same way. The new name matches more with
+Meson function name styling.
+
+## rust.bindgen accepts a dependency argument
+
+The `bindgen` method of the `rust` module now accepts a dependencies argument.
+Any include paths in these dependencies will be passed to the underlying call to
+`clang`, and the call to `bindgen` will correctly depend on any generatd sources.
+
+## String arguments to the rust.bindgen include_directories argument
+
+Most other cases of include_directories accept strings as well as
+`IncludeDirectory` objects, so lets do that here too for consistency.
+
+## The Rust module is stable
+
+Mesa is using the rust module in production, so it's time to mark it as stable.
+
+## `in` operator for strings
+
+`in` and `not in` operators now works on strings, in addition to arrays and
+dictionaries.
+
+```
+fs = import('fs')
+if 'something' in fs.read('somefile')
+  # True
+endif
+```
+
+## `warning-level=everything` option
+
+The new `everything` value for the built-in `warning_level` enables roughly all applicable compiler warnings.
+For clang and MSVC, this simply enables `-Weverything` or `/Wall`, respectively.
+For GCC, meson enables warnings approximately equivalent to `-Weverything` from clang.
+

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/Release-notes.md Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/Release-procedure.md Added

@@ -0,0 +1,69 @@
+# Release procedure
+
+**This page is WIP. The following procedure is not yet approved for use**
+
+# Trunk
+
+Meson operates under the principle that trunk should (in theory) be
+always good enough for release. That is, all code merged in trunk must
+pass all unit tests. Any broken code should either be fixed or
+reverted immediately.
+
+People who are willing to tolerate the occasional glitch should be
+able to use Meson trunk for their day to day development if they so
+choose.
+
+# Major releases
+
+Major releases are currently in the form 0.X.0, where X is an
+increasing number. We aim to do a major release roughly once a month,
+though the schedule is not set in stone.
+
+Before a major release is made a stable branch will be made, and
+0.X.0-rc1 release candidate will be made. A new milestone for 0.X.0
+will be made, and all bugs effecting the RC will be assigned to this
+milestone. Patches fixing bugs in the milestone will be picked to the
+stable branch, and normal development will continue on the master
+branch. Every week after after this a new release candidate will be
+made until all bugs are resolved in that milestone. When all of the
+bugs are fixed the 0.X.0 release will be made.
+
+# Bugfix releases
+
+Bugfix releases contain only minor fixes to major releases and are
+designated by incrementing the last digit of the version number. The
+criteria for a bug fix release is one of the following:
+
+ - release has a major regression compared to the previous release (making
+   existing projects unbuildable)
+ - the release has a serious bug causing data loss or equivalent
+ - other unforeseen major issue
+
+In these cases a bug fix release can be made. It shall contain _only_
+the fix for the issue (or issues) in question and other minor bug
+fixes. Only changes that have already landed in trunk will be
+considered for inclusion. No new functionality shall be added.
+
+# Requesting a bug fix release
+
+The process for requesting that a bug fix release be made goes roughly
+as follows:
+
+ - file a bug about the core issue
+ - file a patch fixing it if possible
+ - contact the development team and request a bug fix release (IRC is the
+   preferred contact medium)
+
+The request should contain the following information:
+
+ - the issue in question
+ - whether it has already caused problems for real projects
+ - an estimate of how many people and projects will be affected
+
+There is no need to write a long and complicated request report.
+Something like the following is sufficient:
+
+> The latest release has a regression where trying to do Foo using Bar
+breaks. This breaks all projects that use both, which includes at
+least list of affected projects. This causes problems for X amount
+of people and because of this we should do a bugfix release.

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/Reproducible-builds.md Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/Rewriter.md Added

@@ -0,0 +1,258 @@
+---
+short-description: Automatic modification of the build system files
+...
+
+# Meson file rewriter
+
+Since version 0.50.0, Meson has the functionality to perform some
+basic modification on the `meson.build` files from the command line.
+The currently supported operations are:
+
+- For build targets:
+  - Add/Remove source files
+  - Add/Remove targets
+  - Modify a select set of kwargs
+  - Print some JSON information
+- For dependencies:
+  - Modify a select set of kwargs
+- For the project function:
+  - Modify a select set of kwargs
+  - Modify the default options list
+
+The rewriter has both, a normal command line interface and a "script
+mode". The normal CLI is mostly designed for everyday use. The "script
+mode", on the other hand, is meant to be used by external programs
+(IDEs, graphical frontends, etc.)
+
+The rewriter itself is considered stable, however the user interface
+and the "script mode" API might change in the future. These changes
+may also break backwards comaptibility to older releases.
+
+We are also open to suggestions for API improvements.
+
+## Using the rewriter
+
+All rewriter functions are accessed via `meson rewrite`. The Meson
+rewriter assumes that it is run inside the project root directory. If
+this isn't the case, use `--sourcedir` to specify the actual project
+source directory.
+
+### Adding and removing sources
+
+The most common operations will probably be the adding and removing of source
+files to a build target. This can be easily done with:
+
+```bash
+meson rewrite target <target name/id> {add/rm} list of sources
+```
+
+For instance, given the following example
+
+```meson
+src = 'main.cpp', 'fileA.cpp'
+
+exe1 = executable('testExe', src)
+```
+
+the source `fileB.cpp` can be added with:
+
+```bash
+meson rewrite target testExe add fileB.cpp
+```
+
+After executing this command, the new `meson.build` will look like this:
+
+```meson
+src = 'main.cpp', 'fileA.cpp', 'fileB.cpp'
+
+exe1 = executable('testExe', src)
+```
+
+In this case, `exe1` could also have been used for the target name.
+This is possible because the rewriter also searches for assignments
+and unique Meson IDs, which can be acquired with introspection. If
+there are multiple targets with the same name, Meson will do nothing
+and print an error message.
+
+For more information see the help output of the rewriter target
+command.
+
+### Adding and removing `extra_files`
+
+*Since 0.61.0*
+
+In the same way you can add and remove source files from a target, you can modify a target's
+`extra_files` list:
+
+```bash
+meson rewrite target <target name/id> {add_extra_files/rm_extra_files} list of extra files
+```
+
+### Setting the project version
+
+It is also possible to set kwargs of specific functions with the
+rewriter. The general command for setting or removing kwargs is:
+
+```bash
+meson rewrite kwargs {set/delete} <function type> <function ID> <key1> <value1> <key2> <value2> ...
+```
+
+For instance, setting the project version can be achieved with this command:
+
+```bash
+meson rewrite kwargs set project / version 1.0.0
+```
+
+Currently, only the following function types are supported:
+
+- dependency
+- target (any build target, the function ID is the target name/ID)
+- project (the function ID must be `/` since project() can only be called once)
+
+For more information see the help output of the rewrite kwargs command.
+
+Note msys bash may expand `/` to a path. Passing `//` will be
+converted to `/` by msys bash but in order to keep usage
+shell-agnostic, the rewrite command also allows `//` as the function
+ID such that it will work in both msys bash and other shells.
+
+### Setting the project default options
+
+For setting and deleting default options, use the following command:
+
+```bash
+meson rewrite default-options {set/delete} <opt1> <value1> <opt2> <value2> ...
+```
+
+## Limitations
+
+Rewriting a Meson file is not guaranteed to keep the indentation of
+the modified functions. Additionally, comments inside a modified
+statement will be removed. Furthermore, all source files will be
+sorted alphabetically.
+
+For instance adding `e.c` to srcs in the following code
+
+```meson
+# Important comment
+
+srcs = 
+'a.c', 'c.c', 'f.c',
+# something important about b
+       'b.c', 'd.c', 'g.c'
+
+
+# COMMENT
+```
+
+would result in the following code:
+
+```meson
+# Important comment
+
+srcs = 
+  'a.c',
+  'b.c',
+  'c.c',
+  'd.c',
+  'e.c',
+  'f.c',
+  'g.c'
+
+
+# COMMENT
+```
+
+## Using the "script mode"
+
+The "script mode" should be the preferred API for third party
+programs, since it offers more flexibility and higher API stability.
+The "scripts" are stored in JSON format and executed with `meson
+rewrite command <JSON file or string>`.
+
+The JSON format is defined as follows:
+
+```json
+
+  {
+    "type": "function to execute",
+    ...
+  }, {
+    "type": "other function",
+    ...
+  },
+  ...
+
+```
+
+Each object in the main array must have a `type` entry which specifies which
+function should be executed.
+
+Currently, the following functions are supported:
+
+- target
+- kwargs
+- default_options
+
+### Target modification format
+
+The format for the type `target` is defined as follows:
+
+```json
+{
+  "type": "target",
+  "target": "target ID/name/assignment variable",
+  "operation": "one of 'src_add', 'src_rm', 'target_rm', 'target_add', 'extra_files_add', 'extra_files_rm', 'info'",
+  "sources": "list", "of", "source", "files", "to", "add, remove",
+  "subdir": "subdir where the new target should be added (only has an effect for operation 'tgt_add')",
+  "target_type": "function name of the new target -- same as in the CLI (only has an effect for operation 'tgt_add')"
+}
+```
+
+The keys `sources`, `subdir` and `target_type` are optional.
+
+### kwargs modification format
+
+The format for the type `target` is defined as follows:
+
+```json
+{
+  "type": "kwargs",
+  "function": "one of 'dependency', 'target', 'project'",
+  "id": "function ID",
+  "operation": "one of 'set', 'delete', 'add', 'remove', 'remove_regex', 'info'",
+  "kwargs": {
+    "key1": "value1",
+    "key2": "value2",
+    ...
+  }
+}
+```
+
+### Default options modification format
+
+The format for the type `default_options` is defined as follows:
+
+```json
+{
+  "type": "default_options",
+  "operation": "one of 'set', 'delete'",
+  "options": {
+    "opt1": "value1",
+    "opt2": "value2",
+    ...
+  }
+}
+```
+
+For operation `delete`, the values of the `options` can be anything
+(including `null`)
+
+## Extracting information
+
+The rewriter also offers operation `info` for the types `target` and
+`kwargs`. When this operation is used, Meson will print a JSON dump to
+stderr, containing all available information to the rewriter about the
+build target / function kwargs in question.
+
+The output format is currently experimental and may change in the future.

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/Run-targets.md Added

@@ -0,0 +1,55 @@
+---
+short-description: Targets to run external commands
+...
+
+# Run targets
+
+Sometimes you need to have a target that just runs an external
+command. As an example you might have a build target that reformats
+your source code, runs `cppcheck` or something similar. In Meson this
+is accomplished with a so called *run target*.
+
+The recommended way of doing this is writing the command(s) you want
+to run to a script file. Here's an example script.
+
+```bash
+#!/bin/sh
+
+cd "${MESON_SOURCE_ROOT}"
+inspector_command -o "${MESON_BUILD_ROOT}/inspection_result.txt"
+```
+
+Note the two environment variables `MESON_SOURCE_ROOT` and
+`MESON_BUILD_ROOT`. These are absolute paths to your project's source
+and build directories and they are automatically set up by Meson. In
+addition to these Meson also sets up the variable `MESON_SUBDIR`,
+which points to the subdirectory where the run command was specified.
+Most commands don't need to set up this.
+
+Note how the script starts by cd'ing into the source dir. Meson does
+not guarantee that the script is run in any specific directory.
+Whether you need to do the same depends on what your custom target
+wants to do.
+
+To make this a run target we write it to a script file called
+`scripts/inspect.sh` and specify it in the top level Meson file like
+this.
+
+```meson
+run_target('inspector',
+  command : 'scripts/inspect.sh')
+```
+
+Run targets are not run by default. To run it run the following command.
+
+```console
+$ meson compile inspector
+```
+
+All additional entries in `run_target`'s `command` array are passed
+unchanged to the inspector script, so you can do things like this:
+
+```meson
+run_target('inspector',
+  command : 'scripts/inspect.sh', '--exclude', 'tests')
+```

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/Running-Meson.md Added

@@ -0,0 +1,210 @@
+---
+short-description: Building a project with Meson
+...
+
+# Running Meson
+
+There are two different ways of invoking Meson. First, you can run it
+directly from the source tree with the command
+`/path/to/source/meson.py`. Second, Meson may also be installed in which case
+the command is simply `meson`. In this manual we only use the latter
+format for simplicity.
+
+At the time of writing only a command line version of Meson is
+available. This means that Meson must be invoked using the terminal.
+If you wish to use the MSVC compiler, you need to run Meson under
+"Visual Studio command prompt".
+
+All available Meson commands are listed on the commands reference
+page(Commands.md).
+
+## Configuring the build directory
+
+Let us assume that we have a source tree that has a Meson build
+system. This means that at the topmost directory has a file called
+`meson.build`. We run the following commands to get the build started.
+
+```sh
+cd /path/to/source/root
+meson setup builddir
+```
+
+We invoke Meson with the `setup` command, giving it the location of the build
+directory. Meson uses out of source
+builds(http://web.archive.org/web/20190715081007/http://voices.canonical.com/jussi.pakkanen/2013/04/16/why-you-should-consider-using-separate-build-directories/).
+
+Hint: The syntax of Meson is `meson command arguments options`.
+The `setup` command takes a `builddir` and a `srcdir` argument. If no
+`srcdir` is given Meson will deduce the `srcdir` based on `pwd` and
+the location of `meson.build`.
+
+Meson then loads the build configuration file and writes the
+corresponding build backend in the build directory. By default Meson
+generates a *debug build*, which turns on basic warnings and debug
+information and disables compiler optimizations.
+
+Additionally, the invocation can pass options to Meson. The list of
+options is documented here(Builtin-options.md).
+
+You can specify a different type of build with the `--buildtype` command line
+argument. It can have one of the following values.
+
+| value            | meaning                                                                                                                                                    |
+| ------           | --------                                                                                                                                                   |
+| `plain`          | no extra build flags are used, even for compiler warnings, useful for distro packagers and other cases where you need to specify all arguments by yourself |
+| `debug`          | debug info is generated but the result is not optimized, this is the default                                                                               |
+| `debugoptimized` | debug info is generated and the code is optimized (on most compilers this means `-g -O2`)                                                                  |
+| `release`        | full optimization, no debug info                                                                                                                           |
+
+The build directory is mandatory. The reason for this is that it
+simplifies the build process immensely. Meson will not, under any
+circumstances, write files inside the source directory (if it does, it
+is a bug and should be fixed). This means that the user does not need
+to add a bunch of files to their revision control's ignore list. It
+also means that you can create arbitrarily many build directories for
+any given source tree.
+
+For example, if we wanted to test building the source code with the
+Clang compiler instead of the system default, we could just type the
+following commands:
+
+```sh
+cd /path/to/source/root
+CC=clang CXX=clang++ meson setup buildclang
+```
+
+This separation is even more powerful if your code has multiple
+configuration options (such as multiple data backends). You can create
+a separate subdirectory for each of them. You can also have build
+directories for optimized builds, code coverage, static analysis and
+so on. They are all neatly separated and use the same source tree.
+Changing between different configurations is just a question of
+changing to the corresponding directory.
+
+Unless otherwise mentioned, all following command line invocations are
+meant to be run in the source directory.
+
+By default, Meson will use the Ninja backend to build your project. If
+you wish to use any of the other backends, you need to pass the
+corresponding argument during configuration time. As an example, here
+is how you would use Meson to generate a Visual Studio solution.
+
+```sh
+meson setup <build dir> --backend=vs
+```
+
+You can then open the generated solution with Visual Studio and
+compile it in the usual way. A list of backends can be obtained with
+`meson setup --help`.
+
+## Environment variables
+
+Sometimes you want to add extra compiler flags, this can be done by
+passing them in environment variables when calling Meson. See the
+reference
+tables(Reference-tables.md#compiler-and-linker-flag-environment-variables)
+for a list of all the environment variables. Be aware however these
+environment variables are only used for the native compiler and will
+not affect the compiler used for cross-compiling, where the flags
+specified in the cross file will be used.
+
+Furthermore it is possible to stop Meson from adding flags itself by
+using the `--buildtype=plain` option, in this case you must provide
+the full compiler and linker arguments needed.
+
+## Building from the source
+
+To start the build, simply type the following command.
+
+```sh
+meson compile -C builddir
+```
+
+See `meson compile` description(Commands.md#compile) for more info.
+
+### Building directly with ninja
+
+By default Meson uses the Ninja build
+system(https://ninja-build.org/) to actually build the code. To start
+the build, simply type the following command.
+
+```sh
+ninja -C builddir
+```
+
+The main usability difference between Ninja and Make is that Ninja
+will automatically detect the number of CPUs in your computer and
+parallelize itself accordingly. You can override the amount of
+parallel processes used with the command line argument `-j <num
+processes>`.
+
+It should be noted that after the initial configure step `ninja` is
+the only command you ever need to type to compile. No matter how you
+alter your source tree (short of moving it to a completely new
+location), Meson will detect the changes and regenerate itself
+accordingly. This is especially handy if you have multiple build
+directories. Often one of them is used for development (the "debug"
+build) and others only every now and then (such as a "static analysis"
+build). Any configuration can be built just by `cd`'ing to the
+corresponding directory and running Ninja.
+
+## Running tests
+
+Meson provides native support for running tests. The command to do
+that is simple.
+
+```sh
+meson test -C builddir
+```
+
+See `meson test` description(Commands.md#test) for more info.
+
+Meson does not force the use of any particular testing framework. You
+are free to use GTest, Boost Test, Check or even custom executables.
+
+Note: it can be also invoked directly with ninja with the following command:
+```sh
+ninja -C builddir test
+```
+
+## Installing
+
+Installing the built software is just as simple.
+
+```sh
+meson install -C builddir
+```
+
+See `meson install` description(Commands.md#install) for more info.
+
+Note that Meson will only install build targets explicitly tagged as
+installable, as detailed in the installing targets
+documentation(Installing.md).
+
+By default Meson installs to `/usr/local`. This can be changed by
+passing the command line argument `--prefix /your/prefix` to Meson
+during configure time. Meson also supports the `DESTDIR` variable used
+in e.g. building packages. It is used like this:
+
+```sh
+DESTDIR=/path/to/staging meson install -C builddir
+```
+
+Note: it can be also invoked directly with ninja with the following
+command:
+
+```sh
+ninja -C builddir install
+```
+
+## Command line help
+
+Meson has a standard command line help feature. It can be accessed
+with the following command.
+
+    meson --help
+
+## Exit status
+
+Meson exits with status 0 if successful, 1 for problems with the
+command line or meson.build file, and 2 for internal errors.

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/Rust-module.md Added

@@ -0,0 +1,83 @@
+---
+short-description: Rust language integration module
+authors:
+    - name: Dylan Baker
+      email: dylan@pnwbakers.com
+      years: 2020, 2021, 2022
+...
+
+# Rust module
+
+*(new in 0.57.0)*
+*(Stable since 1.0.0)*
+
+The rust module provides helper to integrate rust code into Meson. The
+goal is to make using rust in Meson more pleasant, while still
+remaining mesonic, this means that it attempts to make Rust work more
+like Meson, rather than Meson work more like rust.
+
+## Functions
+
+### test(name: string, target: library | executable, dependencies: Dependency)
+
+This function creates a new rust unittest target from an existing rust
+based target, which may be a library or executable. It does this by
+copying the sources and arguments passed to the original target and
+adding the `--test` argument to the compilation, then creates a new
+test target which calls that executable, using the rust test protocol.
+
+This accepts all of the keyword arguments as the
+test function except `protocol`, it will set
+that automatically.
+
+Additional, test only dependencies may be passed via the dependencies
+argument.
+
+### bindgen(*, input: string | BuildTarget | (string | BuildTarget), output: string, include_directories: (include_directories | string), c_args: string, args: string, dependencies: Dependency)
+
+This function wraps bindgen to simplify creating rust bindings around C
+libraries. This has two advantages over hand-rolling ones own with a
+`generator` or `custom_target`:
+
+- It handles `include_directories`, so one doesn't have to manually convert them to `-I...`
+- It automatically sets up a depfile, making the results more reliable
+
+
+It takes the following keyword arguments
+
+- input — A list of Files, Strings, or CustomTargets. The first element is
+  the header bindgen will parse, additional elements are dependencies.
+- output — the name of the output rust file
+- include_directories — A list of `include_directories` or `string` objects,
+  these are passed to clang as `-I` arguments *(string since 1.0.0)*
+- c_args — A list of string arguments to pass to clang untouched
+- args — A list of string arguments to pass to `bindgen` untouched.
+- dependencies — A list of `Dependency` objects to pass to the underlying clang call (*since 1.0.0*)
+
+```meson
+rust = import('unstable-rust')
+
+inc = include_directories('..'¸ '../../foo')
+
+generated = rust.bindgen(
+    input : 'myheader.h',
+    output : 'generated.rs',
+    include_directories : inc, include_directories('foo'),
+    args : '--no-rustfmt-bindings',
+    c_args : '-DFOO=1',
+)
+```
+
+If the header depeneds on generated headers, those headers must be passed to
+`bindgen` as well to ensure proper dependency ordering, static headers do not
+need to be passed, as a proper depfile is generated:
+
+```meson
+h1 = custom_target(...)
+h2 = custom_target(...)
+
+r1 = rust.bindgen(
+  input : h1, h2,  # h1 includes h2,
+  output : 'out.rs',
+)
+```

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/Rust.md Added

@@ -0,0 +1,67 @@
+---
+title: Rust
+short-description: Working with Rust in Meson
+...
+
+# Using Rust with Meson
+
+## Mixing Rust and non-Rust sources
+
+Meson currently does not support creating a single target with Rust and non Rust
+sources mixed together, therefore one must compile multiple libraries and link
+them.
+
+```meson
+rust_lib = static_library(
+    'rust_lib',
+    sources : 'lib.rs',
+    ...
+)
+
+c_lib = static_library(
+    'c_lib',
+    sources : 'lib.c',
+    link_with : rust_lib,
+)
+```
+This is an implementation detail of Meson, and is subject to change in the future.
+
+## Mixing Generated and Static sources
+
+*Note* This feature was added in 0.62
+
+You can use a @structured_src for this. Structured sources are a dictionary
+mapping a string of the directory, to a source or list of sources.
+When using a structured source all inputs *must* be listed, as Meson may copy
+the sources from the source tree to the build tree.
+
+Structured inputs are generally not needed when not using generated sources.
+
+As an implementation detail, Meson will attempt to determine if it needs to copy
+files at configure time and will skip copying if it can. Copying is done at
+build time (when necessary), to avoid reconfiguring when sources change.
+
+```meson
+executable(
+    'rust_exe',
+    #structured_sources(
+        'main.rs',
+        {
+            'foo' : 'bar.rs', 'foo/lib.rs', generated_rs,
+            'foo/bar' : ...,
+            'other' : ...,
+        }
+    )
+)
+```
+
+## Use with rust-analyzer
+
+*Since 0.64.0.*
+
+Meson will generate a `rust-project.json` file in the root of the build
+directory if there are any rust targets in the project. Most IDEs will need to
+be configured to use the file as it's not in the source root (Meson does not
+write files into the source directory). See the upstream
+docs(https://rust-analyzer.github.io/manual.html#non-cargo-based-projects) for
+more information on how to configure that.

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/Shipping-prebuilt-binaries-as-wraps.md Added

@@ -0,0 +1,44 @@
+# Shipping prebuilt binaries as wraps
+
+A common dependency case, especially on Windows, is the need to
+provide dependencies as prebuilt binaries rather than Meson projects
+that you build from scratch. Common reasons include not having access
+to source code, not having the time and effort to rewrite a legacy
+system's build definitions to Meson or just the fact that compiling
+the dependency projects takes too long.
+
+Packaging a project is straightforward. As an example let's look at a
+case where the project consists of one static library called `bob` and
+some headers. To create a binary dependency project we put the static
+library at the top level and headers in a subdirectory called
+`include`. The Meson build definition would look like the following.
+
+```meson
+project('binary dep', 'c')
+
+cc = meson.get_compiler('c')
+bin_dep = declare_dependency(
+  dependencies : cc.find_library('bob', dirs : meson.current_source_dir()),
+  include_directories : include_directories('include'))
+```
+
+Now you can use this subproject as if it was a Meson project:
+
+```meson
+project('using dep', 'c')
+bob_dep = subproject('bob').get_variable('bin_dep')
+executable('prog', 'prog.c', dependencies : bob_dep)
+```
+
+Note that often libraries compiled with different compilers (or even
+compiler flags) might not be compatible. If you do this, then you are
+responsible for verifying that your libraries are compatible, Meson
+will not check things for you.
+
+## Note for Linux libraries
+
+A precompiled linux shared library (.so) requires a soname field to be properly installed. If the soname field is missing, binaries referencing the library will require a hard link to the location of the library at install time (`/path/to/your/project/subprojects/precompiledlibrary/lib.so` instead of `$INSTALL_PREFIX/lib/lib.so`) after installation.
+
+You should change the compilation options for the precompiled library to avoid this issue. If recompiling is not an option, you can use the patchelf(https://github.com/NixOS/patchelf) tool with the command `patchelf --set-soname libfoo.so libfoo.so` to edit the precompiled library after the fact.
+
+Meson generally guarantees any library it compiles has a soname. One notable exception is libraries built with the shared_module function.

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/Simd-module.md Added

@@ -0,0 +1,72 @@
+# Unstable SIMD module
+
+This module provides helper functionality to build code with SIMD instructions.
+Available since 0.42.0.
+
+**Note**: this module is unstable. It is only provided as a technology
+preview. Its API may change in arbitrary ways between releases or it
+might be removed from Meson altogether.
+
+## Usage
+
+This module is designed for the use case where you have an algorithm
+with one or more SIMD implementation and you choose which one to use
+at runtime.
+
+The module provides one method, `check`, which is used like this:
+
+    rval = simd.check('mysimds',
+      mmx : 'simd_mmx.c',
+      sse : 'simd_sse.c',
+      sse2 : 'simd_sse2.c',
+      sse3 : 'simd_sse3.c',
+      ssse3 : 'simd_ssse3.c',
+      sse41 : 'simd_sse41.c',
+      sse42 : 'simd_sse42.c',
+      avx : 'simd_avx.c',
+      avx2 : 'simd_avx2.c',
+      neon : 'simd_neon.c',
+      compiler : cc)
+
+Here the individual files contain the accelerated versions of the
+functions in question. The `compiler` keyword argument takes the
+compiler you are going to use to compile them. The function returns an
+array with two values. The first value is a bunch of libraries that
+contain the compiled code. Any SIMD code that the compiler can't
+compile (for example, Neon instructions on an x86 machine) are
+ignored. You should pass this value to the desired target using
+`link_with`. The second value is a `configuration_data` object that
+contains true for all the values that were supported. For example if
+the compiler did support sse2 instructions, then the object would have
+`HAVE_SSE2` set to 1.
+
+Generating code to detect the proper instruction set at runtime is
+straightforward. First you create a header with the configuration
+object and then a chooser function that looks like this:
+
+    void (*fptr)(type_of_function_here)  = NULL;
+
+    #if HAVE_NEON
+    if(fptr == NULL && neon_available()) {
+        fptr = neon_accelerated_function;
+    }
+    #endif
+    #if HAVE_AVX2
+    if(fptr == NULL && avx2_available()) {
+        fptr = avx_accelerated_function;
+    }
+    #endif
+
+    ...
+
+    if(fptr == NULL) {
+        fptr = default_function;
+    }
+
+Each source file provides two functions, the `xxx_available` function
+to query whether the CPU currently in use supports the instruction set
+and `xxx_accelerated_function` that is the corresponding accelerated
+implementation.
+
+At the end of this function the function pointer points to the fastest
+available implementation and can be invoked to do the computation.

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/Simple-comparison.md Added

@@ -0,0 +1,88 @@
+# A simple comparison
+
+In this experiment we generated one thousand C files with contents
+that looked like this.
+
+```c
+#include<stdio.h>
+#include"header.h"
+
+int func23() { return 0; }
+```
+
+The function number was different in each file. In addition there was
+a main C file that just called each function in turn. We then
+generated build system files for *Meson*, *CMake*, *SCons*, *Premake*
+and *Autotools* that compiled these files into a single executable.
+
+With this we measured three different things. The first is
+configuration time, that is, the time the build system takes to
+generate necessary build files. This is usually called the *configure
+step*. The time was measured in seconds.
+
+The second thing to measure was the build time. This should be limited
+by the compiler and in the optimal case should be the same for every
+build system. Four parallel processes were used in this test.
+
+The third thing we measured was the empty build time. This measures
+how much time the build system takes to check the states of all source
+files because if any of them could potentially cause a rebuild.
+
+Since CMake has two different backends, Make and Ninja, we ran the
+tests on both of them. All tests were run on a 2011 era Macbook Pro
+running Ubuntu 13/04. The tests were run multiple times and we always
+took the fastest time.
+
+Here are the results for configuration time.
+
+!Configuration times(images/conftime.png)
+
+The reason SCons got zero seconds on this test is because you cannot
+separate configure and build steps. They run as one unit. Autotools is
+the clear loser of this test as it is over an order of magnitude
+slower than the second slowest one. This configuration time includes
+both autogen and configure. All other systems take less than one
+second to do this setup, which is fast enough for a human being to
+interpret as instantaneous.
+
+!Build times(https://raw.githubusercontent.com/wiki/jpakkane/meson/buildtime.png)
+
+Build times are a bit more even. SCons is the slowest, being almost
+ten seconds slower than the second slowest. Some of it is work from
+the configure step but it still has the worst performance. Premake is
+the fastest Make-based build system narrowly beating out Autotools.
+Both Ninja-based build systems are faster than all non-Ninja ones with
+Meson being slightly faster. In practice the difference is minimal.
+The advantages of Ninja can be seen by comparing CMake's times when
+using Make or Ninja. It is possible to shave off 3.5 seconds (over
+20%) of the total build time just by changing the backend. The
+project's CMake configuration files don't need any changes.
+
+!No-op time(https://raw.githubusercontent.com/wiki/jpakkane/meson/emptytime.png)
+
+Empty build times reflect the performance of regular build times.
+SCons is again the slowest taking over three seconds compared to
+Meson, which takes only 0.03 seconds, a difference of two orders of
+magnitude. Even Autotools, the fastest Make-based system, is almost
+one order of magnitude slower. Ninja holds the top spots just like in
+the previous test.
+
+Conclusions
+-----
+
+Build system performance matters. Even with this extremely simple
+example we can find differences between various popular build systems.
+As the project size increases, these differences grow even larger.
+(The author has witnessed no-op build times of 30 seconds for Make
+versus less than one second for Ninja when compiling the Clang
+compiler.) Keeping incremental build times low is one of the major
+keys of programmer productivity as it allows developers to iterate
+faster and stay in the creative zone.
+
+Original scripts
+-----
+
+Those who want to run these experiments themselves can download the scripts here:
+
+* Generator script(https://raw.githubusercontent.com/wiki/jpakkane/meson/gen_src.py)
+* Measurement script(https://raw.githubusercontent.com/wiki/jpakkane/meson/measure.py)

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/SimpleStart.md Added

@@ -0,0 +1,154 @@
+---
+short-description: Simple getting started guide
+...
+
+# The Absolute Beginner's Guide to Installing and Using Meson
+
+This page is meant for people who are new to using Meson and possibly
+even to compiling C and/or C++ code in general. It is meant to contain
+one simple way of getting your build environment up and running. If
+you are more experienced and have your own preferred way of installing
+and using development software, feel free to use that instead. This
+guide only deals with Linux, Windows and macOS platforms. If you use
+some other platform, such as one of the BSDs, you probably already
+know how to install development tools on it (probably better than we
+do, even).
+
+There are three phases to getting a development environment running.
+
+1. Installing a compiler toolchain
+2. Installing Meson
+3. Creating a project and building it
+
+## Installing a compiler toolchain
+
+### Linux
+
+All Linux distributions provide easy access to development tools.
+Typically you need to open a terminal and execute one command, which
+depends on your distro.
+
+ - Debian, Ubuntu and derivatives: `sudo apt install build-essential`
+ - Fedora, Centos, RHEL and derivatives: `sudo dnf install gcc-c++`
+ - Arch: `sudo pacman -S gcc`
+
+### Windows
+
+The most common development toolchain on Windows is Visual Studio,
+which can be downloaded from the Visual Studio web
+site(https://visualstudio.microsoft.com/). Select the Community
+version unless you have bought a license.
+
+!Download page of Visual Studio(images/win_dlvs.png)
+
+Download the installer and run it. When you are given a list of things
+to install, select *Desktop development with C++*. This installs both
+a C and a C++ compiler.
+
+!Installing the Visual Studio compilers(images/win_installvs.png)
+
+Once the installer finishes the compiler toolchain is ready to use.
+
+### macOS
+
+On macOS the development toolchain must be installed via the Mac app
+store. Search for an app called XCode and install it.
+
+!App store page for XCode(images/osx_xcode.png)
+
+*Note:* Installing XCode is not sufficient by itself. You also need to
+start XCode' GUI application once. This will make XCode download and
+install more files that are needed for compilation.
+
+## Installing Meson
+
+### Linux
+
+Installing Meson is just as simple as installing the compiler toolchain.
+
+ - Debian, Ubuntu and derivatives: `sudo apt install meson ninja-build`
+ - Fedora, Centos, RHEL and derivatives: `sudo dnf install meson ninja-build`
+ - Arch: `sudo pacman -S meson`
+
+### Windows
+
+Meson provides a standard Windows `.msi` installer that can be
+downloaded from the Releases
+page(https://github.com/mesonbuild/meson/releases).
+
+!Meson installed download(images/win_downloadmeson.png)
+
+Download and run it to install all the necessary bits. You can verify
+that your installation is working by running the Visual Studio
+developer tools command prompt that can be found in the start menu.
+
+!Devtool prompt(images/win_vstoolsprompt.png)
+
+You should be able to run both `meson` and `ninja` and query their
+versions.
+
+!A working Windows install(images/win_working.png)
+
+### macOS
+
+#### With Homebrew
+`brew install meson ninja`
+
+#### Without Homebrew
+Start by downloading the installation package from the Releases
+page(https://github.com/mesonbuild/meson/releases).
+
+!Downloading the macOS installer(images/meson_mac1.png)
+
+Double click the downloaded installer to start. If you are running a
+new macOS version, it might refuse to run the application with the
+following error message:
+
+!A macOS signing warning(images/meson_mac2.png)
+
+This can be fixed by starting System Preferences, selecting the
+Security and Privacy entry. At the bottom it shows the blocked app and
+you can enable it by clicking on the "Open anyway" button.
+
+!Security settings(images/meson_mac3.png)
+
+Now the installer should start. If not, double click on the downloaded
+installer file again.
+
+!Installer running(images/meson_mac4.png)
+
+Once the installation is finished you can verify that the system is working via the terminal app.
+
+!A successful install(images/meson_mac5.png)
+
+## Running Meson
+
+Start a terminal application. On Windows you have to use the Visual
+Studio Developer Tools Command Prompt as discussed above, because the
+compilers are only available in that terminal. You also need to change
+into your home directory (Linux and macOS terminals start in the home
+directory by default).
+
+    cd \users\username
+
+Create a new directory to hold your project.
+
+    mkdir testproject
+    cd testproject
+
+Use Meson to create and build a new sample project.
+
+    meson init --name testproject --build
+
+This will create a project skeleton for you and compile it. The result
+is put in the `build` subdirectory and can be run directly from there.
+
+    build/testproject
+
+!All finished and ready to go(images/linux_alldone.png)
+
+The project is now ready for development. You can edit the code with
+any editor and it is rebuilt by going in the `build` subdirectory and
+executing the `meson compile` command. If your version of Meson is too
+old, you can compile the project by running the command `ninja`
+instead.

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/SourceSet-module.md Added

@@ -0,0 +1,212 @@
+---
+short-description: Source set module
+authors:
+    - name: Paolo Bonzini
+      email: pbonzini@redhat.com
+      years: 2019
+...
+
+# Source set module
+
+This module provides support for building many targets against a
+single set of files; the choice of which files to include in each
+target depends on the contents of a dictionary or a
+`configuration_data` object. The module can be loaded with:
+
+```meson
+ssmod = import('sourceset')
+```
+
+A simple example of using the module looks like this:
+
+```meson
+ss = ssmod.source_set()
+# Include main.c unconditionally
+ss.add(files('main.c'))
+# Include a.c if configuration key FEATURE1 is true
+ss.add(when: 'FEATURE1', if_true: files('a.c'))
+# Include zlib.c if the zlib dependency was found, and link zlib
+# in the executable
+ss.add(when: zlib, if_true: files('zlib.c'))
+# many more rules here...
+ssconfig = ss.apply(config)
+executable('exe', sources: ssconfig.sources(),
+           dependencies: ssconfig.dependencies())
+```
+
+and it would be equivalent to
+
+```meson
+sources = files('main.c')
+dependencies = 
+if config'FEATURE1' then
+    sources += files('a.c')
+endif
+if zlib.found() then
+    sources += files('zlib.c')
+    dependencies += zlib
+endif
+# many more "if"s here...
+executable('exe', sources: sources, dependencies: dependencies())
+```
+
+Sourcesets can be used with a single invocation of the `apply` method,
+similar to the example above, but the module is especially useful when
+multiple executables are generated by applying the same rules to many
+different configurations.
+
+*Added 0.51.0*
+
+## Functions
+
+### `source_set()`
+
+```meson
+ssmod.source_set()
+```
+
+Create and return a new source set object.
+
+**Returns**: a source set`source_set` object
+
+## `source_set` object
+
+The `source_set` object provides methods to add files to a source set
+and to query it. The source set becomes immutable after any method but
+`add` is called.
+
+### Methods
+
+#### `add()`
+
+```meson
+source_set.add(when: varnames_and_deps,
+               if_true: sources_and_deps,
+               if_false: list_of_alt_sources)
+source_set.add(sources_and_deps)
+```
+
+Add a *rule* to a source set. A rule determines the conditions under
+which some source files or dependency objects are included in a build
+configuration. All source files must be present in the source tree or
+they can be created in the build tree via `configure_file`,
+`custom_target` or `generator`.
+
+`varnames_and_deps` is a list of conditions for the rule, which can be
+either strings or dependency objects (a dependency object is anything
+that has a `found()` method). If *all* the strings evaluate to true
+and all dependencies are found, the rule will evaluate to true;
+`apply()` will then include the contents of the `if_true` keyword
+argument in its result. Otherwise, that is if any of the strings in
+the positional arguments evaluate to false or any dependency is not
+found, `apply()` will instead use the contents of the `if_false`
+keyword argument.
+
+Dependencies can also appear in `sources_and_deps`. In this case, a
+missing dependency will simply be ignored and will *not* disable the
+rule, similar to how the `dependencies` keyword argument works in
+build targets.
+
+**Note**: It is generally better to avoid mixing source sets and
+disablers. This is because disablers will cause the rule to be dropped
+altogether, and the `list_of_alt_sources` would not be taken into
+account anymore.
+
+#### `add_all()`
+
+```meson
+source_set.add_all(when: varnames_and_deps,
+                   if_true: source_set1, source_set2, ...)
+source_set.add_all(source_set1, source_set2, ...)
+```
+
+Add one or more source sets to another.
+
+For each source set listed in the arguments, `apply()` will consider
+their rules only if the conditions in `varnames_and_deps` are
+evaluated positively. For example, the following:
+
+```meson
+sources_b = ssmod.source_set()
+sources_b.add(when: 'HAVE_A', if_true: 'file.c')
+sources = ssmod.source_set()
+sources.add_all(when: 'HAVE_B', if_true: sources_b)
+```
+
+is equivalent to:
+
+```meson
+sources = ssmod.source_set()
+sources.add(when: 'HAVE_A', 'HAVE_B', if_true: 'file.c')
+```
+
+#### `all_sources()`
+
+```meson
+list source_set.all_sources(...)
+```
+
+Returns a list of all sources that were placed in the source set using
+`add` (including nested source sets) and that do not have a not-found
+dependency. If a rule has a not-found dependency, only the `if_false`
+sources are included (if any).
+
+**Returns**: a list of file objects
+
+#### `all_dependencies()` *(since 0.52.0)*
+
+```meson
+list source_set.all_dependencies(...)
+```
+
+Returns a list of all dependencies that were placed in the source set
+using `add` (including nested source sets) and that were found.
+
+**Returns**: a list of dependencies
+
+#### `apply()`
+
+```meson
+source_files source_set.apply(conf_data, strict: false)
+```
+
+Match the source set against a dictionary or a `configuration_data`
+object and return a *source configuration* object. A source
+configuration object allows you to retrieve the sources and
+dependencies for a specific configuration.
+
+By default, all the variables that were specified in the rules have to
+be present in `conf_data`. However, in some cases the convention is
+that `false` configuration symbols are absent in `conf_data`; this is
+the case for example when the configuration was loaded from a Kconfig
+file. In that case you can specify the `strict: false` keyword
+argument, which will treat absent variables as false.
+
+**Returns**: a source configuration`source_configuration` object
+
+## `source_configuration` object
+
+The `source_configuration` object provides methods to query the result of an
+`apply` operation on a source set.
+
+### Methods
+
+#### `sources()`
+
+```meson
+source_config.sources()
+```
+
+Return the source files corresponding to the applied configuration.
+
+**Returns**: a list of file objects
+
+#### `dependencies()`
+
+```meson
+source_config.dependencies()
+```
+
+Return the dependencies corresponding to the applied configuration.
+
+**Returns**: a list of dependency objects

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/Style-guide.md Added

@@ -0,0 +1,87 @@
+---
+short-description: Style recommendations for Meson files
+...
+
+# Style recommendations
+
+This page lists some recommendations on organizing and formatting your
+Meson build files.
+
+## Tabs or spaces?
+
+Always spaces.
+
+## Naming Variable
+
+Snake case (stylized as `snake_case`) refers to the style of writing in which
+each space is replaced by an underscore (`_`) character, and the first letter of
+each word written in lowercase. It is the most common naming convention used
+in Meson build scripts as identifiers for variable.
+
+Let say you would like to refer to your executable so something like `my_exe`.
+
+## Dependency usage
+
+The `dependency` function is the recommended way to handle
+dependencies. If your wrap files have the necessary `provide`
+entries, everything will work automatically both when compiling your
+own and when using system dependencies.
+
+You should only need `subproject` when you need to extract non dependencies/programs.
+
+## Naming options
+
+There are two ways of naming project options. As an example for
+booleans the first one is `foo` and the second one is `enable-foo`.
+The former style is recommended, because in Meson options have strong
+type, rather than being just strings.
+
+You should try to name options the same as is common in other
+projects. This is especially important for yielding options, because
+they require that both the parent and subproject options have the same
+name.
+
+# Global arguments
+
+Prefer `add_project_arguments` to `add_global_arguments` because using
+the latter prevents using the project as a subproject.
+
+# Cross compilation arguments
+
+Try to keep cross compilation arguments away from your build files as
+much as possible. Keep them in the cross file instead. This adds
+portability, since all changes needed to compile to a different
+platform are isolated in one place.
+
+# Sorting source paths
+
+The source file arrays should all be sorted. This makes it easier to
+spot errors and often reduces merge conflicts. Furthermore, the paths
+should be sorted with a natural sorting algorithm, so that numbers are
+sorted in an intuitive way (`1, 2, 3, 10, 20` instead of `1, 10, 2,
+20, 3`).
+
+Numbers should also be sorted before characters (`a111` before `ab0`).
+Furthermore, strings should be sorted case insensitive.
+
+Additionally, if a path contains a directory it should be sorted before
+normal files. This rule also applies recursively for subdirectories.
+
+The following example shows correct source list definition:
+
+```meson
+sources = files(
+  'aaa/a1.c',
+  'aaa/a2.c',
+  'bbb/subdir1/b1.c',
+  'bbb/subdir2/b2.c',
+  'bbb/subdir10/b3.c',
+  'bbb/subdir20/b4.c',
+  'bbb/b5.c',
+  'bbb/b6.c',
+  'f1.c',
+  'f2.c',
+  'f10.c',
+  'f20.c'
+)
+```

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/Subprojects.md Added

@@ -0,0 +1,397 @@
+---
+short-description: Using Meson projects as subprojects within other Meson projects
+...
+
+# Subprojects
+
+Some platforms do not provide a native packaging system. In these
+cases it is common to bundle all third party libraries in your source
+tree. This is usually frowned upon because it makes it hard to add
+these kinds of projects into e.g. those Linux distributions that
+forbid bundled libraries.
+
+Meson tries to solve this problem by making it extremely easy to
+provide both at the same time. The way this is done is that Meson
+allows you to take any other Meson project and make it a part of your
+build without (in the best case) any changes to its Meson setup. It
+becomes a transparent part of the project.
+
+It should be noted that this is only guaranteed to work for subprojects
+that are built with Meson. The reason is the simple fact that there is
+no possible way to do this reliably with mixed build systems. Because of
+this, only Meson subprojects are described here.
+CMake based subprojects(CMake-module.md#cmake-subprojects) are also
+supported but not guaranteed to work.
+
+## A subproject example
+
+Usually dependencies consist of some header files plus a library to
+link against. To declare this internal dependency use
+`declare_dependency` function.
+
+As an example, suppose we have a simple project that provides a shared
+library. Its `meson.build` would look like this.
+
+```meson
+project('libsimple', 'c')
+
+inc = include_directories('include')
+libsimple = shared_library('simple',
+  'simple.c',
+  include_directories : inc,
+  install : true)
+
+libsimple_dep = declare_dependency(include_directories : inc,
+  link_with : libsimple)
+```
+
+### Naming convention for dependency variables
+
+Ideally the dependency variable name should be of `<project_name>_dep`
+form. This way one can just use it without even looking inside build
+definitions of that subproject.
+
+In cases where there are multiple dependencies need to be declared,
+the default one should be named as `<project_name>_dep` (e.g.
+`gtest_dep`), and others can have `<project_name>_<other>_<name>_dep`
+form (e.g. `gtest_main_dep` - gtest with main function).
+
+There may be exceptions to these rules where common sense should be applied.
+
+### Adding variables to the dependency
+
+*New in 0.54.0*
+
+In some cases a project may define special variables via pkg-config or
+cmake that a caller needs to know about. Meson provides a
+`dependency.get_variable` method to hide what kind of dependency is
+provided, and this is available to subprojects as well. Use the
+`variables` keyword to add a dict of strings:
+
+```meson
+my_dep = declare_dependency(..., variables : {'var': 'value', 'number': '3'})
+```
+
+Which another project can access via:
+
+```meson
+var = my_dep.get_variable(internal : 'var', cmake : 'CMAKE_VAR')
+```
+
+The values of the dict must be strings, as pkg-config and cmake will
+return variables as strings.
+
+### Build options in subproject
+
+All Meson features of the subproject, such as project options keep
+working and can be set in the master
+project(Builtin-options.md#specifying-options-per-subproject). There
+are a few limitations, the most important being that global compiler
+arguments must be set in the main project before calling subproject.
+Subprojects must not set global arguments because there is no way to
+do that reliably over multiple subprojects. To check whether you are
+running as a subproject, use meson.is_subproject.
+
+## Using a subproject
+
+All subprojects must be inside `subprojects` directory. The
+`subprojects` directory must be at the top level of your project.
+Subproject declaration must be in your top level `meson.build`.
+
+### A simple example
+
+Let's use `libsimple` as a subproject.
+
+At the top level of your project create `subprojects` directory.
+Then copy `libsimple` into `subprojects` directory.
+
+Your project's `meson.build` should look like this.
+
+```meson
+project('my_project', 'cpp')
+
+libsimple_proj = subproject('libsimple')
+libsimple_dep = libsimple_proj.get_variable('libsimple_dep')
+
+executable('my_project',
+  'my_project.cpp',
+  dependencies : libsimple_dep,
+  install : true)
+```
+
+Note that the subproject object is *not* used as the dependency, but
+rather you need to get the declared dependency from it with
+`get_variable` because a subproject may have multiple declared
+dependencies.
+
+### Toggling between system libraries and embedded sources
+
+When building distro packages it is very important that you do not
+embed any sources. Some distros have a rule forbidding embedded
+dependencies so your project must be buildable without them or
+otherwise the packager will hate you.
+
+Here's how you would use system libraries and fall back to embedding sources
+if the dependency is not available.
+
+```meson
+project('my_project', 'cpp')
+
+libsimple_dep = dependency('libsimple', required : false)
+
+if not libsimple_dep.found()
+  libsimple_proj = subproject('libsimple')
+  libsimple_dep = libsimple_proj.get_variable('libsimple_dep')
+endif
+
+executable('my_project',
+  'my_project.cpp',
+  dependencies : libsimple_dep,
+  install : true)
+```
+
+Because this is such a common operation, Meson provides a shortcut for
+this use case.
+
+```meson
+dep = dependency('foo', fallback : 'subproject_name', 'variable_name')
+```
+
+The `fallback` keyword argument takes two items, the name of the
+subproject and the name of the variable that holds the dependency. If
+you need to do something more complicated, such as extract several
+different variables, then you need to do it yourself with the manual
+method described above.
+
+Using this shortcut the build definition would look like this.
+
+```meson
+project('my_project', 'cpp')
+
+libsimple_dep = dependency('libsimple', fallback : 'libsimple', 'libsimple_dep')
+
+executable('my_project',
+  'my_project.cpp',
+  dependencies : libsimple_dep,
+  install : true)
+```
+
+You may change default options of the
+subproject(Builtin-options.md#specifying-options-per-subproject) by
+adding a keyword argument to the invocation. For example, to change the
+default library type:
+
+```
+libsimple_dep = dependency(
+  'libsimple',
+  fallback : 'libsimple', 'libsimple_dep',
+  default_options: 'default_library=static'
+)
+```
+
+With this setup, when libsimple is provided by the system we use it and
+completely ignore subproject options (i.e. we link to a shared system
+library). When that is not the case, we use the embedded version (the
+one from subprojects).
+
+Note that `libsimple_dep` can point to an external or an internal
+dependency but you don't have to worry about their differences. Meson
+will take care of the details for you.
+
+### Subprojects depending on other subprojects
+
+Subprojects can use other subprojects, but all subprojects must reside
+in the top level `subprojects` directory. Recursive use of subprojects
+is not allowed, though, so you can't have subproject `a` that uses
+subproject `b` and have `b` also use `a`.
+
+## Obtaining subprojects
+
+Meson ships with a dependency system to automatically obtain
+dependency subprojects. It is documented in the Wrap dependency
+system manual(Wrap-dependency-system-manual.md).
+
+## Command-line options
+
+The usage of subprojects can be controlled by users and distros with
+the following command-line options:
+
+* **--wrap-mode=nodownload**
+
+    Meson will not use the network to download any subprojects or
+    fetch any wrap information. Only pre-existing sources will be used.
+    This is useful (mostly for distros) when you want to only use the
+    sources provided by a software release, and want to manually handle
+    or provide missing dependencies.
+
+* **--wrap-mode=nofallback**
+
+    Meson will not use subproject fallbacks for any dependency
+    declarations in the build files, and will only look for them in the
+    system. Note that this does not apply to unconditional subproject()
+    calls, and those are meant to be used for sources that cannot be
+    provided by the system, such as copylibs.
+
+    This option may be overridden by `--force-fallback-for` for specific
+    dependencies.
+
+* **--wrap-mode=forcefallback**
+
+    Meson will not look at the system for any dependencies which have
+    subproject fallbacks available, and will *only* use subprojects for
+    them. This is useful when you want to test your fallback setup, or
+    want to specifically build against the library sources provided by
+    your subprojects.
+
+* **--force-fallback-for=list,of,dependencies**
+
+    Meson will not look at the system for any dependencies listed there,
+    provided a fallback was supplied when the dependency was declared.
+
+    This option takes precedence over `--wrap-mode=nofallback`, and when
+    used in combination with `--wrap-mode=nodownload` will only work
+    if the dependency has already been downloaded.
+
+    This is useful when your project has many fallback dependencies,
+    but you only want to build against the library sources for a few
+    of them.
+
+    **Warning**: This could lead to mixing system and subproject version of the
+    same library in the same process. Take this case as example:
+    - Libraries `glib-2.0` and `gstreamer-1.0` are installed on your system.
+    - `gstreamer-1.0` depends on `glib-2.0`, pkg-config file `gstreamer-1.0.pc`
+      has `Requires: glib-2.0`.
+    - In your application build definition you do:
+      ```meson
+      executable('app', ...,
+        dependencies: 
+          dependency('glib-2.0', fallback: 'glib'),
+          dependency('gstreamer-1.0', fallback: 'gstreamer'),
+      )
+      ```
+    - You configure with `--force-fallback-for=glib`.
+    This result in linking to two different versions of library `glib-2.0`
+    because `dependency('glib-2.0', fallback: 'glib')` will return the
+    subproject dependency, but `dependency('gstreamer-1.0', fallback: 'gstreamer')`
+    will not fallback and return the system dependency, including `glib-2.0`
+    library. To avoid that situation, every dependency that itself depend on
+    `glib-2.0` must also be forced to fallback, in this case with
+    `--force-fallback-for=glib,gsteamer`.
+
+* **--wrap-mode=nopromote**
+
+    *Since 0.56.0* Meson will automatically use wrap files found in subprojects
+    and copy them into the main project. That new behavior can be disabled by
+    passing `--wrap-mode=nopromote`. In that case only wraps found in the main
+    project will be used.
+
+## `meson subprojects` command
+
+*Since 0.49.0*
+
+`meson subprojects` has various subcommands to manage all subprojects.
+If the subcommand fails on any subproject the execution continues with
+other subprojects. All subcommands accept `--sourcedir` argument
+pointing to the root source dir of the main project.
+
+*Since 0.56.0* all subcommands accept `--types <file|git|hg|svn>`
+argument to run the subcommands only on subprojects of the given
+types. Multiple types can be set as comma separated list e.g. `--types
+git,file`.
+
+*Since 0.56.0* If the subcommand fails on any subproject an error code
+is returned at the end instead of retuning success.
+
+### Download subprojects
+
+*Since 0.49.0*
+
+Meson will automatically download needed subprojects during configure,
+unless **--wrap-mode=nodownload** option is passed. It is sometimes
+preferable to download all subprojects in advance, so the Meson
+configure can be performed offline. The command-line `meson
+subprojects download` can be used for that, it will download all
+missing subprojects, but will not update already fetched subprojects.
+
+### Update subprojects
+
+*Since 0.49.0*
+
+Once a subproject has been fetched, Meson will not update it automatically.
+For example if the wrap file tracks a git branch, it won't pull latest commits.
+
+To pull latest version of all your subprojects at once, just run the command:
+`meson subprojects update`.
+- If the wrap file comes from wrapdb, the latest version of the wrap file will
+  be pulled and used next time meson reconfigure the project. This can be
+  triggered using `meson --reconfigure`. Previous source tree is not deleted, to
+  prevent from any loss of local changes. *Since 0.58.0* If `--reset` is
+  specified, the source tree is deleted and new source is extracted.
+- If subproject is currently in detached mode, a checkout of the revision from
+  wrap file is performed. *Since 0.56.0* a rebase is also performed in case the
+  revision already existed locally but was outdated. If `--reset` is specified,
+  a hard reset is performed instead of rebase.
+- If subproject is currently at the same branch as specified by the wrap file,
+  a rebase on `origin` commit is performed. *Since 0.56.0* If `--reset` is
+  specified, a hard reset is performed instead of rebase.
+- If subproject is currently in a different branch as specified by the wrap file,
+  it is skipped unless `--rebase` option is passed in which case a rebase on
+  `origin` commit is performed. *Since 0.56.0* the `--rebase` argument is
+  deprecated and has no effect. Instead, a checkout of the revision from wrap file
+  file is performed and a rebase is also performed in case the revision already
+  existed locally by was outdated. If `--reset` is specified, a hard reset is
+  performed instead of rebase.
+- *Since 0.56.0* if the `url` specified in wrap file is different to the URL set
+  on `origin` for a git repository it will not be updated, unless `--reset` is
+  specified in which case the URL of `origin` will be reset first.
+- *Since 0.56.0* If the subproject directory is not a git repository but has a
+  `wrap-git` the subproject is ignored, unless `--reset` is specified in which
+  case the directory is deleted and the new repository is cloned.
+
+### Start a topic branch across all git subprojects
+
+*Since 0.49.0*
+
+The command-line `meson subprojects checkout <branch_name>` will
+checkout a branch, or create one with `-b` argument, in every git
+subprojects. This is useful when starting local changes across
+multiple subprojects. It is still your responsibility to commit and
+push in each repository where you made local changes.
+
+To come back to the revision set in wrap file (i.e. master), just run
+`meson subprojects checkout` with no branch name.
+
+*Since 0.56.0* any pending changes are now stashed before checkout a new branch.
+
+### Execute a command on all subprojects
+
+*Since 0.51.0*
+
+The command-line `meson subprojects foreach <command> ...` will
+execute a command in each subproject directory. For example this can
+be useful to check the status of subprojects (e.g. with `git status`
+or `git diff`) before performing other actions on them.
+
+## Why must all subprojects be inside a single directory?
+
+There are several reasons.
+
+First of all, to maintain any sort of sanity, the system must prevent going
+inside other subprojects with `subdir()` or variations thereof. Having the
+subprojects in well defined places makes this easy. If subprojects could be
+anywhere at all, it would be a lot harder.
+
+Second of all it is extremely important that end users can easily see what
+subprojects any project has. Because they are in one, and only one, place,
+reviewing them becomes easy.
+
+This is also a question of convention. Since all Meson projects have the same
+layout w.r.t subprojects, switching between projects becomes easier. You don't
+have to spend time on a new project traipsing through the source tree looking
+for subprojects. They are always in the same place.
+
+Finally if you can have subprojects anywhere, this increases the possibility of
+having many different (possibly incompatible) versions of a dependency in your
+source tree. Then changing some code (such as changing the order you traverse
+directories) may cause a completely different version of the subproject to be
+used by accident.

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/Syntax.md Added

@@ -0,0 +1,819 @@
+---
+short-description: Syntax and structure of Meson files
+...
+
+# Syntax
+
+The syntax of Meson's specification language has been kept as simple
+as possible. It is *strongly typed* so no object is ever converted to
+another under the covers. Variables have no visible type which makes
+Meson *dynamically typed* (also known as *duck typed*).
+
+The main building blocks of the language are *variables*, *numbers*,
+*booleans*, *strings*, *arrays*, *function calls*, *method calls*, *if
+statements* and *includes*.
+
+Usually one Meson statement takes just one line. There is no way to
+have multiple statements on one line as in e.g. *C*. Function and
+method calls' argument lists can be split over multiple lines. Meson
+will autodetect this case and do the right thing.
+
+In other cases, *(added 0.50)* you can get multi-line statements by
+ending the line with a `\`. Apart from line ending whitespace has no
+syntactic meaning.
+
+## Variables
+
+Variables in Meson work just like in other high level programming
+languages. A variable can contain a value of any type, such as an
+integer or a string. Variables don't need to be predeclared, you can
+just assign to them and they appear. Here's how you would assign
+values to two different variables.
+
+```meson
+var1 = 'hello'
+var2 = 102
+```
+
+One important difference in how variables work in Meson is that all
+objects are immutable. When you see an operation which appears like
+a mutation, actually a new object is created and assigned to the
+name. This is different from, for example, how Python works for
+objects, but similar to e.g. Python strings.
+
+```meson
+var1 = 1, 2, 3
+var2 = var1
+var2 += 4
+# var2 is now 1, 2, 3, 4
+# var1 is still 1, 2, 3
+```
+
+## Numbers
+
+Meson supports only integer numbers. They are declared simply by
+writing them out. Basic arithmetic operations are supported.
+
+```meson
+x = 1 + 2
+y = 3 * 4
+d = 5 % 3 # Yields 2.
+```
+
+Hexadecimal literals are supported since version 0.45.0:
+
+```meson
+int_255 = 0xFF
+```
+
+Octal and binary literals are supported since version 0.47.0:
+
+```meson
+int_493 = 0o755
+int_1365 = 0b10101010101
+```
+
+Strings can be converted to a number like this:
+
+```meson
+string_var = '42'
+num = string_var.to_int()
+```
+
+Numbers can be converted to a string:
+
+```meson
+int_var = 42
+string_var = int_var.to_string()
+```
+
+## Booleans
+
+A boolean is either `true` or `false`.
+
+```meson
+truth = true
+```
+
+Booleans can be converted to a string or to a number:
+
+```meson
+bool_var = true
+string_var = bool_var.to_string()
+int_var = bool_var.to_int()
+```
+
+## Strings
+
+Strings in Meson are declared with single quotes. To enter a literal
+single quote do it like this:
+
+```meson
+single quote = 'contains a \' character'
+```
+
+The full list of escape sequences is:
+
+* `\\` Backslash
+* `\'` Single quote
+* `\a` Bell
+* `\b` Backspace
+* `\f` Formfeed
+* `\n` Newline
+* `\r` Carriage Return
+* `\t` Horizontal Tab
+* `\v` Vertical Tab
+* `\ooo` Character with octal value ooo
+* `\xhh` Character with hex value hh
+* `\uxxxx` Character with 16-bit hex value xxxx
+* `\Uxxxxxxxx` Character with 32-bit hex value xxxxxxxx
+* `\N{name}` Character named name in Unicode database
+
+As in python and C, up to three octal digits are accepted in `\ooo`.
+
+Unrecognized escape sequences are left in the string unchanged, i.e., the
+backslash is left in the string.
+
+### String concatenation
+
+Strings can be concatenated to form a new string using the `+` symbol.
+
+```meson
+str1 = 'abc'
+str2 = 'xyz'
+combined = str1 + '_' + str2 # combined is now abc_xyz
+```
+
+### String path building
+
+*(Added 0.49)*
+
+You can concatenate any two strings using `/` as an operator to build paths.
+This will always use `/` as the path separator on all platforms.
+
+```meson
+joined = '/usr/share' / 'projectname'    # => /usr/share/projectname
+joined = '/usr/local' / '/etc/name'      # => /etc/name
+
+joined = 'C:\\foo\\bar' / 'builddir'     # => C:/foo/bar/builddir
+joined = 'C:\\foo\\bar' / 'D:\\builddir' # => D:/builddir
+```
+
+Note that this is equivalent to using join_paths,
+which was obsoleted by this operator.
+
+### Strings running over multiple lines
+
+Strings running over multiple lines can be declared with three single
+quotes, like this:
+
+```meson
+multiline_string = '''#include <foo.h>
+int main (int argc, char ** argv) {
+  return FOO_SUCCESS;
+}'''
+```
+
+These are raw strings that do not support the escape sequences listed
+above.  These strings can also be combined with the string formatting
+functionality via `.format()` described below.
+
+Note that multiline f-string support was added in version 0.63.
+
+### String index
+
+Strings support the indexing (`<num>`) operator. This operator allows (read
+only) accessing a specific character. The returned value is guaranteed to be
+a string of length 1.
+
+```meson
+foo = 'abcd'
+message(foo1)  # Will print 'b'
+foo2 = 'C'     # ERROR: Meson objects are immutable!
+```
+
+### String formatting
+
+#### .format()
+
+Strings can be built using the string formatting functionality.
+
+```meson
+template = 'string: @0@, number: @1@, bool: @2@'
+res = template.format('text', 1, true)
+# res now has value 'string: text, number: 1, bool: true'
+```
+
+As can be seen, the formatting works by replacing placeholders of type
+`@number@` with the corresponding argument.
+
+#### Format strings
+*(Added 0.58)*
+
+Format strings can be used as a non-positional alternative to the
+string formatting functionality described above. Note that multiline f-string
+support was added in version 0.63.
+
+```meson
+n = 10
+m = 'hi'
+
+s = f'int: @n@, string: @m@'
+# s now has the value 'int: 10, string: hi'
+```
+
+Currently only identity-expressions are supported inside of format
+strings, meaning you cannot use arbitrary Meson expressions inside of them.
+
+```meson
+n = 10
+m = 5
+
+# The following is not a valid format string
+s = f'result: @n + m@'
+```
+
+### String methods
+
+Strings also support a number of other methods that return transformed
+copies.
+
+#### .replace()
+
+Since 0.58.0, you can replace a substring from a string.
+
+```meson
+# Replaces all instances of one substring with another
+s = 'semicolons;as;separators'
+s = s.replace('as', 'are')
+# 's' now has the value of 'semicolons;are;separators'
+```
+
+#### .strip()
+
+```meson
+# Similar to the Python str.strip(). Removes leading/ending spaces and newlines
+define = ' -Dsomedefine '
+stripped_define = define.strip()
+# 'stripped_define' now has the value '-Dsomedefine'
+
+# You may also pass a string to strip, which specifies the set of characters to
+# be removed.
+string = 'xyxHelloxyx'.strip('xy')
+# 'string' now has the value 'Hello'
+```
+
+Since 0.43.0, you can specify one positional string argument,
+and all characters in that string will be stripped.
+
+#### .to_upper(), .to_lower()
+
+```meson
+target = 'x86_FreeBSD'
+upper = target.to_upper() # t now has the value 'X86_FREEBSD'
+lower = target.to_lower() # t now has the value 'x86_freebsd'
+```
+
+#### .to_int()
+
+```meson
+version = '1'
+# Converts the string to an int and throws an error if it can't be
+ver_int = version.to_int()
+```
+
+#### .contains(), .startswith(), .endswith()
+
+```meson
+target = 'x86_FreeBSD'
+is_fbsd = target.to_lower().contains('freebsd')
+# is_fbsd now has the boolean value 'true'
+is_x86 = target.startswith('x86') # boolean value 'true'
+is_bsd = target.to_lower().endswith('bsd') # boolean value 'true'
+```
+
+#### .substring()
+
+Since 0.56.0, you can extract a substring from a string.
+
+```meson
+# Similar to the Python strstart:end syntax
+target = 'x86_FreeBSD'
+platform = target.substring(0, 3) # prefix string value 'x86'
+system = target.substring(4) # suffix string value 'FreeBSD'
+```
+
+The method accepts negative values where negative `start` is relative to the end of
+string `len(string) - start` as well as negative `end`.
+
+```meson
+string = 'foobar'
+string.substring(-5, -3) # => 'oo'
+string.substring(1, -1) # => 'ooba'
+```
+
+#### .split(), .join()
+
+```meson
+# Similar to the Python str.split()
+components = 'a b   c d '.split()
+# components now has the value 'a', 'b', 'c', 'd'
+components = 'a b   c d '.split(' ')
+# components now has the value 'a', 'b', '', '', 'c', 'd', ''
+
+# Similar to the Python str.join()
+output = ' '.join('foo', 'bar')
+# Output value is 'foo bar'
+pathsep = ':'
+path = pathsep.join('/usr/bin', '/bin', '/usr/local/bin')
+# path now has the value '/usr/bin:/bin:/usr/local/bin'
+
+# For joining path elements, you should use path1 / path2
+# This has the advantage of being cross-platform
+path = '/usr' / 'local' / 'bin'
+# path now has the value '/usr/local/bin'
+
+# For sources files, use files():
+my_sources = files('foo.c')
+...
+my_sources += files('bar.c')
+# This has the advantage of always calculating the correct relative path, even
+# if you add files in another directory or use them in a different directory
+# than they're defined in
+
+# Example to set an API version for use in library(), install_header(), etc
+project('project', 'c', version: '0.2.3')
+version_array = meson.project_version().split('.')
+# version_array now has the value '0', '2', '3'
+api_version = '.'.join(version_array0, version_array1)
+# api_version now has the value '0.2'
+
+# We can do the same with .format() too:
+api_version = '@0@.@1@'.format(version_array0, version_array1)
+# api_version now (again) has the value '0.2'
+```
+
+#### .underscorify()
+
+```meson
+name = 'Meson Docs.txt#Reference-manual'
+# Replaces all characters other than `a-zA-Z0-9` with `_` (underscore)
+# Useful for substituting into #defines, filenames, etc.
+underscored = name.underscorify()
+# underscored now has the value 'Meson_Docs_txt_Reference_manual'
+```
+
+#### .version_compare()
+
+```meson
+version = '1.2.3'
+# Compare version numbers semantically
+is_new = version.version_compare('>=2.0')
+# is_new now has the boolean value false
+# Supports the following operators: '>', '<', '>=', '<=', '!=', '==', '='
+```
+
+Meson version comparison conventions include:
+
+```meson
+'3.6'.version_compare('>=3.6.0') == false
+```
+
+It is best to be unambiguous and specify the full revision level to compare.
+
+## Arrays
+
+Arrays are delimited by brackets. An array can contain an arbitrary number of objects of any type.
+
+```meson
+my_array = 1, 2, 'string', some_obj
+```
+
+Accessing elements of an array can be done via array indexing:
+
+```meson
+my_array = 1, 2, 'string', some_obj
+second_element = my_array1
+last_element = my_array-1
+```
+
+You can add more items to an array like this:
+
+```meson
+my_array += 'foo', 3, 4, another_obj
+```
+
+When adding a single item, you do not need to enclose it in an array:
+
+```meson
+my_array += 'something'
+# This also works
+my_array += 'else'
+```
+
+Note appending to an array will always create a new array object and
+assign it to `my_array` instead of modifying the original since all
+objects in Meson are immutable.
+
+Since 0.49.0, you can check if an array contains an element like this:
+
+```meson
+my_array = 1, 2
+if 1 in my_array
+# This condition is true
+endif
+if 1 not in my_array
+# This condition is false
+endif
+```
+
+### Array methods
+
+The following methods are defined for all arrays:
+
+ - `length`, the size of the array
+ - `contains`, returns `true` if the array contains the object given as argument, `false` otherwise
+ - `get`, returns the object at the given index, negative indices count from the back of the array, indexing out of bounds is a fatal error. Provided for backwards-compatibility, it is identical to array indexing.
+
+## Dictionaries
+
+Dictionaries are delimited by curly braces. A dictionary can contain
+an arbitrary number of key: value pairs. Keys are required to be
+strings, but values can be objects of any type. Prior to *0.53.0* keys
+were required to be literal strings, i.e., you could not use a
+variable containing a string value as a key.
+
+```meson
+my_dict = {'foo': 42, 'bar': 'baz'}
+```
+
+Keys must be unique:
+
+```meson
+# This will fail
+my_dict = {'foo': 42, 'foo': 43}
+```
+
+Dictionaries are immutable and do not have a guaranteed order.
+
+Dictionaries are available since 0.47.0.
+
+Visit the @dict objects page in the Reference Manual to read
+about the methods exposed by dictionaries.
+
+Since 0.49.0, you can check if a dictionary contains a key like this:
+
+```meson
+my_dict = {'foo': 42, 'bar': 43}
+if 'foo' in my_dict
+# This condition is true
+endif
+if 42 in my_dict
+# This condition is false
+endif
+if 'foo' not in my_dict
+# This condition is false
+endif
+```
+
+*Since 0.53.0* Keys can be any expression evaluating to a string
+value, not limited to string literals any more.
+
+```meson
+d = {'a' + 'b' : 42}
+k = 'cd'
+d += {k : 43}
+```
+
+## Function calls
+
+Meson provides a set of usable functions. The most common use case is
+creating build objects.
+
+```meson
+executable('progname', 'prog.c')
+```
+
+Most functions take only few positional arguments but several keyword
+arguments, which are specified like this:
+
+```meson
+executable('progname',
+  sources: 'prog.c',
+  c_args: '-DFOO=1')
+```
+
+Starting with version 0.49.0 keyword arguments can be specified
+dynamically. This is done by passing dictionary representing the
+keywords to set in the `kwargs` keyword. The previous example would be
+specified like this:
+
+```meson
+d = {'sources': 'prog.c',
+  'c_args': '-DFOO=1'}
+
+executable('progname',
+  kwargs: d)
+```
+
+A single function can take keyword arguments both directly in the
+function call and indirectly via the `kwargs` keyword argument. The
+only limitation is that it is a hard error to pass any particular key
+both as a direct and indirect argument.
+
+```meson
+d = {'c_args': '-DFOO'}
+executable('progname', 'prog.c',
+  c_args: '-DBAZ=1',
+  kwargs: d) # This is an error!
+```
+
+Attempting to do this causes Meson to immediately exit with an error.
+
+### Argument flattening
+
+Argument flattening is a Meson feature that aims to simplify using
+methods and functions. For functions where this feature is active,
+Meson takes the list of arguments and flattens all nested lists into
+one big list.
+
+For instance the following function calls to executable are
+identical in Meson:
+
+```meson
+# A normal example:
+executable('exe1', 'foo.c', 'bar.c', 'foobar.c')
+
+# A more contrived example that also works but certainly
+# isn't good Meson code:
+l1 = 'bar.c'
+executable('exe1', 'foo.c', l1, 'foobar.c')
+
+# How meson will treat all the previous calls internally:
+executable('exe1', 'foo.c', 'bar.c', 'foobar.c')
+```
+
+Because of an internal implementation detail, the following syntax
+is currently also supported, even though the first argument of
+executable is a single @str and not a @list:
+
+```meson
+# WARNING: This example is only valid because of an internal
+#          implementation detail and not because it is intended
+#
+#          PLEASE DO NOT DO SOMETHING LIKE THIS!
+#
+executable('exe1', 'foo.c', 'bar.c', 'foobar.c')
+```
+
+This code is currently accepted because argument flattening *currently*
+happens before the parameters are evaluated. "Support" for
+such constructs will likely be removed in future Meson releases!
+
+Argument flattening is supported by *most* but not *all* Meson
+functions and methods. As a general rule, it can be assumed that a
+function or method supports argument flattening if the exact list
+structure is irrelevant to a function.
+
+Whether a function supports argument flattening is documented in the
+Reference Manual(Reference-manual.md).
+
+## Method calls
+
+Objects can have methods, which are called with the dot operator. The
+exact methods it provides depends on the object.
+
+```meson
+myobj = some_function()
+myobj.do_something('now')
+```
+
+## If statements
+
+If statements work just like in other languages.
+
+```meson
+var1 = 1
+var2 = 2
+if var1 == var2 # Evaluates to false
+  something_broke()
+elif var3 == var2
+  something_else_broke()
+else
+  everything_ok()
+endif
+
+opt = get_option('someoption')
+if opt != 'foo'
+  do_something()
+endif
+```
+
+## Logical operations
+
+Meson has the standard range of logical operations which can be used in
+`if` statements.
+
+```meson
+if a and b
+  # do something
+endif
+if c or d
+  # do something
+endif
+if not e
+  # do something
+endif
+if not (f or g)
+  # do something
+endif
+```
+
+Logical operations work only on boolean values.
+
+## Foreach statements
+
+To do an operation on all elements of an iterable, use the `foreach`
+command.
+
+> Note that Meson variables are immutable. Trying to assign a new value
+> to the iterated object inside a foreach loop will not affect foreach's
+> control flow.
+
+### Foreach with an array
+
+Here's an example of how you could define two executables
+with corresponding tests using arrays and foreach.
+
+```meson
+progs = 'prog1', 'prog1.c', 'foo.c',
+         'prog2', 'prog2.c', 'bar.c'
+
+foreach p : progs
+  exe = executable(p0, p1)
+  test(p0, exe)
+endforeach
+```
+
+### Foreach with a dictionary
+
+Here's an example of you could iterate a set of components that
+should be compiled in according to some configuration. This uses
+a dictionarydictionaries, which is available since 0.47.0.
+
+```meson
+components = {
+  'foo': 'foo.c',
+  'bar': 'bar.c',
+  'baz': 'baz.c',
+}
+
+# compute a configuration based on system dependencies, custom logic
+conf = configuration_data()
+conf.set('USE_FOO', 1)
+
+# Determine the sources to compile
+sources_to_compile = 
+foreach name, sources : components
+  if conf.get('USE_@0@'.format(name.to_upper()), 0) == 1
+    sources_to_compile += sources
+  endif
+endforeach
+```
+
+### Foreach `break` and `continue`
+
+Since 0.49.0 `break` and `continue` keywords can be used inside foreach loops.
+
+```meson
+items = 'a', 'continue', 'b', 'break', 'c'
+result = 
+foreach i : items
+  if i == 'continue'
+    continue
+  elif i == 'break'
+    break
+  endif
+  result += i
+endforeach
+# result is 'a', 'b'
+```
+
+## Comments
+
+A comment starts with the `#` character and extends until the end of the line.
+
+```meson
+some_function() # This is a comment
+some_other_function()
+```
+
+## Ternary operator
+
+The ternary operator works just like in other languages.
+
+```meson
+x = condition ? true_value : false_value
+```
+
+The only exception is that nested ternary operators are forbidden to
+improve legibility. If your branching needs are more complex than this
+you need to write an `if/else` construct.
+
+## Includes
+
+Most source trees have multiple subdirectories to process. These can
+be handled by Meson's `subdir` command. It changes to the given
+subdirectory and executes the contents of `meson.build` in that
+subdirectory. All state (variables etc) are passed to and from the
+subdirectory. The effect is roughly the same as if the contents of the
+subdirectory's Meson file would have been written where the include
+command is.
+
+```meson
+test_data_dir = 'data'
+subdir('tests')
+```
+
+## User-defined functions and methods
+
+Meson does not currently support user-defined functions or methods.
+The addition of user-defined functions would make Meson
+Turing-complete which would make it harder to reason about and more
+difficult to integrate with tools like IDEs. More details about this
+are in the
+FAQ(FAQ.md#why-is-meson-not-just-a-python-module-so-i-could-code-my-build-setup-in-python).
+If because of this limitation you find yourself copying and pasting
+code a lot you may be able to use a `foreach` loop
+instead(#foreach-statements).
+
+## Stability Promises
+
+Meson is very actively developed and continuously improved. There is a
+possibility that future enhancements to the Meson build system will
+require changes to the syntax. Such changes might be the addition of
+new reserved keywords, changing the meaning of existing keywords or
+additions around the basic building blocks like statements and
+fundamental types. It is planned to stabilize the syntax with the 1.0
+release.
+
+## Grammar
+
+This is the full Meson grammar, as it is used to parse Meson build definition files:
+
+```
+additive_expression: multiplicative_expression | (additive_expression additive_operator multiplicative_expression)
+additive_operator: "+" | "-"
+argument_list: positional_arguments "," keyword_arguments | keyword_arguments
+array_literal: "" expression_list ""
+assignment_statement: expression asssignment_operator expression
+assignment_operator: "=" | "*=" | "/=" | "%=" | "+=" | "-="
+binary_literal: "0b" BINARY_NUMBER
+BINARY_NUMBER: /01+/
+boolean_literal: "true" | "false"
+build_definition: (NEWLINE | statement)*
+condition: expression
+conditional_expression: logical_or_expression | (logical_or_expression "?" expression ":" assignment_expression
+decimal_literal: DECIMAL_NUMBER
+DECIMAL_NUMBER: /1-90-9*/
+dictionary_literal: "{" key_value_list "}"
+equality_expression: relational_expression | (equality_expression equality_operator relational_expression)
+equality_operator: "==" | "!="
+expression: conditional_expression | logical_or_expression
+expression_list: expression ("," expression)*
+expression_statement: expression
+function_expression: id_expression "(" argument_list ")"
+hex_literal: "0x" HEX_NUMBER
+HEX_NUMBER: /a-fA-F0-9+/
+id_expression: IDENTIFIER
+IDENTIFIER: /a-zA-Z_a-zA-Z_0-9*/
+identifier_list: id_expression ("," id_expression)*
+integer_literal: decimal_literal | octal_literal | hex_literal
+iteration_statement: "foreach" identifier_list ":" id_expression NEWLINE (statement | jump_statement)* "endforeach"
+jump_statement: ("break" | "continue") NEWLINE
+key_value_item: expression ":" expression
+key_value_list: key_value_item ("," key_value_item)*
+keyword_item: id_expression ":" expression
+keyword_arguments: keyword_item ("," keyword_item)*
+literal: integer_literal | string_literal | boolean_literal | array_literal | dictionary_literal
+logical_and_expression: equality_expression | (logical_and_expression "and" equality_expression)
+logical_or_expression: logical_and_expression | (logical_or_expression "or" logical_and_expression)
+method_expression: postfix_expression "." function_expression
+multiplicative_expression: unary_expression | (multiplicative_expression multiplicative_operator unary_expression)
+multiplicative_operator: "*" | "/" | "%"
+octal_literal: "0o" OCTAL_NUMBER
+OCTAL_NUMBER: /0-7+/
+positional_arguments: expression ("," expression)*
+postfix_expression: primary_expression | subscript_expression | function_expression | method_expression
+primary_expression: literal | ("(" expression ")") | id_expression
+relational_expression: additive_expression | (relational_expression relational_operator additive_expression)
+relational_operator: ">" | "<" | ">=" | "<=" | "in" | ("not" "in")
+selection_statement: "if" condition NEWLINE (statement)* ("elif" condition NEWLINE (statement)*)* "else" (statement)* "endif"
+statement: (expression_statement | selection_statement | iteration_statement | assignment_statement) NEWLINE
+string_literal: ("'" STRING_SIMPLE_VALUE "'") | ("'''" STRING_MULTILINE_VALUE "'''")
+STRING_MULTILINE_VALUE: \.*?(''')\
+STRING_SIMPLE_VALUE: \.*?(?<!\\)(\\\\)*?'\
+subscript_expression: postfix_expression "" expression ""
+unary_expression: postfix_expression | (unary_operator unary_expression)
+unary_operator: "not" | "+" | "-"
+```

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/Threads.md Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/Tutorial.md Added

@@ -0,0 +1,209 @@
+---
+short-description: Simplest tutorial
+...
+
+# Tutorial
+
+This page shows from the ground up how to create a Meson build
+definition for a simple project. Then we expand it to use external
+dependencies to show how easily they can be integrated into your
+project.
+
+This tutorial has been written mostly for Linux usage. It assumes that
+you have GTK development libraries available on the system. On
+Debian-derived systems such as Ubuntu they can be installed with the
+following command:
+
+```
+sudo apt install libgtk-3-dev
+```
+
+It is possible to build the GUI application on other platforms, such
+as Windows and macOS, but you need to install the needed dependencies.
+
+The humble beginning
+-----
+
+Let's start with the most basic of programs, the classic hello
+example. First we create a file `main.c` which holds the source. It
+looks like this.
+
+```c
+#include <stdio.h>
+
+//
+// main is where all program execution starts
+//
+int main(int argc, char **argv) {
+  printf("Hello there.\n");
+  return 0;
+}
+```
+
+Then we create a Meson build description and put it in a file called
+`meson.build` in the same directory. Its contents are the following.
+
+```meson
+project('tutorial', 'c')
+executable('demo', 'main.c')
+```
+
+That is all. Note that unlike Autotools you do not need to add any
+source headers to the list of
+sources(FAQ.md#do-i-need-to-add-my-headers-to-the-sources-list-like-in-autotools).
+
+We are now ready to build our application. First we need
+to initialize the build by going into the source directory and issuing
+the following commands.
+
+```console
+$ meson setup builddir
+```
+
+We create a separate build directory to hold all of the compiler
+output. Meson is different from some other build systems in that it
+does not permit in-source builds. You must always create a separate
+build directory. Common convention is to put the default build
+directory in a subdirectory of your top level source directory.
+
+When Meson is run it prints the following output.
+
+    The Meson build system
+     version: 0.13.0-research
+    Source dir: /home/jpakkane/mesontutorial
+    Build dir: /home/jpakkane/mesontutorial/builddir
+    Build type: native build
+    Project name is "tutorial".
+    Using native c compiler "ccache cc". (gcc 4.8.2)
+    Creating build target "demo" with 1 files.
+
+Now we are ready to build our code.
+
+
+```console
+$ cd builddir
+$ ninja
+```
+
+If your Meson version is newer than 0.55.0, you can use the new
+backend-agnostic build command:
+
+```console
+$ cd builddir
+$ meson compile
+```
+
+For the rest of this document we are going to use the latter form.
+
+Once the executable is built we can run it.
+
+```console
+$ ./demo
+```
+
+This produces the expected output.
+
+    Hello there.
+
+Adding dependencies
+-----
+
+Just printing text is a bit old fashioned. Let's update our program to
+create a graphical window instead. We'll use the
+GTK+(https://gtk.org) widget toolkit. First we edit the main file to
+use GTK+. The new version looks like this.
+
+```c
+
+#include <gtk/gtk.h>
+
+//
+// Should provided the active view for a GTK application
+//
+static void activate(GtkApplication* app, gpointer user_data)
+{
+  GtkWidget *window;
+  GtkWidget *label;
+
+  window = gtk_application_window_new (app);
+  label = gtk_label_new("Hello GNOME!");
+  gtk_container_add (GTK_CONTAINER (window), label);
+  gtk_window_set_title(GTK_WINDOW (window), "Welcome to GNOME");
+  gtk_window_set_default_size(GTK_WINDOW (window), 400, 200);
+  gtk_widget_show_all(window);
+} // end of function activate
+
+//
+// main is where all program execution starts
+//
+int main(int argc, char **argv)
+{
+  GtkApplication *app;
+  int status;
+
+  app = gtk_application_new(NULL, G_APPLICATION_FLAGS_NONE);
+  g_signal_connect(app, "activate", G_CALLBACK(activate), NULL);
+  status = g_application_run(G_APPLICATION(app), argc, argv);
+  g_object_unref(app);
+
+  return status;
+} // end of function main
+```
+
+Then we edit the Meson file, instructing it to find and use the GTK+
+libraries.
+
+```meson
+project('tutorial', 'c')
+gtkdep = dependency('gtk+-3.0')
+executable('demo', 'main.c', dependencies : gtkdep)
+```
+
+If your app needs to use multiple libraries, you need to use separate
+dependency calls for each, like so:
+
+```meson
+gtkdeps = dependency('gtk+-3.0'), dependency('gtksourceview-3.0')
+```
+
+We don't need it for the current example.
+
+Now we are ready to build. The thing to notice is that we do *not*
+need to recreate our build directory, run any sort of magical commands
+or the like. Instead we just type the exact same command as if we were
+rebuilding our code without any build system changes.
+
+```console
+$ meson compile
+```
+
+Once you have set up your build directory the first time, you don't
+ever need to run the `meson` command again. You always just run `meson
+compile`. Meson will automatically detect when you have done changes
+to build definitions and will take care of everything so users don't
+have to care. In this case the following output is produced.
+
+    1/1 Regenerating build files
+    The Meson build system
+     version: 0.13.0-research
+    Source dir: /home/jpakkane/mesontutorial
+    Build dir: /home/jpakkane/mesontutorial/builddir
+    Build type: native build
+    Project name is "tutorial".
+    Using native c compiler "ccache cc". (gcc 4.8.2)
+    Found pkg-config version 0.26.
+    Dependency gtk+-3.0 found: YES
+    Creating build target "demo" with 1 files.
+    1/2 Compiling c object demo.dir/main.c.o
+    2/2 Linking target demo
+
+Note how Meson noticed that the build definition has changed and reran
+itself automatically. The program is now ready to be run:
+
+```
+$ ./demo
+```
+
+This creates the following GUI application.
+
+!GTK+ sample application screenshot(images/gtksample.png)

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/Unit-tests.md Added

@@ -0,0 +1,285 @@
+---
+short-description: Meson's own unit-test system
+...
+
+# Unit tests
+
+Meson comes with a fully functional unit test system. To use it simply
+build an executable and then use it in a test.
+
+```meson
+e = executable('prog', 'testprog.c')
+test('name of test', e)
+```
+
+You can add as many tests as you want. They are run with the command `meson
+test`.
+
+Meson captures the output of all tests and writes it in the log file
+`meson-logs/testlog.txt`.
+
+## Test parameters
+
+Some tests require the use of command line arguments or environment
+variables. These are simple to define.
+
+```meson
+test('command line test', exe, args : 'first', 'second')
+test('envvar test', exe2, env : 'key1=value1', 'key2=value2')
+```
+
+Note how you need to specify multiple values as an array.
+
+### MALLOC_PERTURB_
+
+By default, environment variable
+`MALLOC_PERTURB_`(http://man7.org/linux/man-pages/man3/mallopt.3.html) is
+set to a random value between 1..255. This can help find memory leaks on
+configurations using glibc, including with non-GCC compilers. This feature
+can be disabled as discussed in test.
+
+## Coverage
+
+If you enable coverage measurements by giving Meson the command line
+flag `-Db_coverage=true`, you can generate coverage reports after
+running the tests (running the tests is required to gather the list of
+functions that get called). Meson will autodetect what coverage
+generator tools you have installed and will generate the corresponding
+targets. These targets are `coverage-xml` and `coverage-text` which
+are both provided by Gcovr(http://gcovr.com) (version 3.3 or higher)
+`coverage-sonarqube` which is provided by Gcovr(http://gcovr.com) (version 4.2 or higher)
+and `coverage-html`, which requires
+Lcov(https://ltp.sourceforge.io/coverage/lcov.php) and
+GenHTML(https://linux.die.net/man/1/genhtml) or
+Gcovr(http://gcovr.com). As a convenience, a high-level `coverage`
+target is also generated which will produce all 3 coverage report
+types, if possible.
+
+The output of these commands is written to the log directory `meson-logs` in
+your build directory.
+
+## Parallelism
+
+To reduce test times, Meson will by default run multiple unit tests in
+parallel. It is common to have some tests which can not be run in
+parallel because they require unique hold on some resource such as a
+file or a D-Bus name. You have to specify these tests with a keyword
+argument.
+
+```meson
+test('unique test', t, is_parallel : false)
+```
+
+Meson will then make sure that no other unit test is running at the
+same time. Non-parallel tests take longer to run so it is recommended
+that you write your unit tests to be parallel executable whenever
+possible.
+
+By default Meson uses as many concurrent processes as there are cores
+on the test machine. You can override this with the environment
+variable `MESON_TESTTHREADS` like this.
+
+```console
+$ MESON_TESTTHREADS=5 meson test
+```
+
+## Priorities
+
+*(added in version 0.52.0)*
+
+Tests can be assigned a priority that determines when a test is
+*started*. Tests with higher priority are started first, tests with
+lower priority started later. The default priority is 0, Meson makes
+no guarantee on the ordering of tests with identical priority.
+
+```meson
+test('started second', t, priority : 0)
+test('started third', t, priority : -50)
+test('started first', t, priority : 1000)
+```
+
+Note that the test priority only affects the starting order of tests
+and subsequent tests are affected by how long it takes previous tests
+to complete. It is thus possible that a higher-priority test is still
+running when lower-priority tests with a shorter runtime have
+completed.
+
+## Skipped tests and hard errors
+
+Sometimes a test can only determine at runtime that it can not be run.
+
+For the default `exitcode` testing protocol, the GNU standard approach
+in this case is to exit the program with error code 77. Meson will
+detect this and report these tests as skipped rather than failed. This
+behavior was added in version 0.37.0.
+
+For TAP-based tests, skipped tests should print a single line starting
+with `1..0 # SKIP`.
+
+In addition, sometimes a test fails set up so that it should fail even
+if it is marked as an expected failure. The GNU standard approach in
+this case is to exit the program with error code 99. Again, Meson will
+detect this and report these tests as `ERROR`, ignoring the setting of
+`should_fail`. This behavior was added in version 0.50.0.
+
+## Testing tool
+
+The goal of the Meson test tool is to provide a simple way to run
+tests in a variety of different ways. The tool is designed to be run
+in the build directory.
+
+The simplest thing to do is just to run all tests.
+
+```console
+$ meson test
+```
+
+### Run subsets of tests
+
+For clarity, consider the meson.build containing:
+
+```meson
+
+test('A', ..., suite: 'foo')
+test('B', ..., suite: 'foo', 'bar')
+test('C', ..., suite: 'bar')
+test('D', ..., suite: 'baz')
+
+```
+
+Specify test(s) by name like:
+
+```console
+$ meson test A D
+```
+
+Tests belonging to a suite `suite` can be run as follows
+
+```console
+$ meson test --suite (sub)project_name:suite
+```
+
+Since version *0.46*, `(sub)project_name` can be omitted if it is the
+top-level project.
+
+Multiple suites are specified like:
+
+```console
+$ meson test --suite foo --suite bar
+```
+
+NOTE: If you choose to specify both suite(s) and specific test
+name(s), the test name(s) must be contained in the suite(s). This
+however is redundant-- it would be more useful to specify either
+specific test names or suite(s).
+
+### Other test options
+
+Sometimes you need to run the tests multiple times, which is done like this:
+
+```console
+$ meson test --repeat=10
+```
+
+Invoking tests via a helper executable such as Valgrind can be done with the
+`--wrap` argument
+
+```console
+$ meson test --wrap=valgrind testname
+```
+
+Arguments to the wrapper binary can be given like this:
+
+```console
+$ meson test --wrap='valgrind --tool=helgrind' testname
+```
+
+Meson also supports running the tests under GDB. Just doing this:
+
+```console
+$ meson test --gdb testname
+```
+
+Meson will launch `gdb` all set up to run the test. Just type `run` in
+the GDB command prompt to start the program.
+
+The second use case is a test that segfaults only rarely. In this case
+you can invoke the following command:
+
+```console
+$ meson test --gdb --repeat=10000 testname
+```
+
+This runs the test up to 10 000 times under GDB automatically. If the
+program crashes, GDB will halt and the user can debug the application.
+Note that testing timeouts are disabled in this case so `meson test`
+will not kill `gdb` while the developer is still debugging it. The
+downside is that if the test binary freezes, the test runner will wait
+forever.
+
+Sometimes, the GDB binary is not in the PATH variable or the user
+wants to use a GDB replacement. Therefore, the invoked GDB program can
+be specified *(added 0.52.0)*:
+
+```console
+$ meson test --gdb --gdb-path /path/to/gdb testname
+```
+
+```console
+$ meson test --print-errorlogs
+```
+
+Meson will report the output produced by the failing tests along with
+other useful information as the environmental variables. This is
+useful, for example, when you run the tests on Travis-CI, Jenkins and
+the like.
+
+**Timeout**
+
+In the test case options, the `timeout` option is specified in a number of seconds.
+
+To disable timeout in test cases, add `timeout: 0` or a negative value to allow
+infinite duration for the test case to complete.
+
+For running tests, you can specify a command line argument for overriding the
+timeout as well:
+
+```console
+$ meson test --timeout-multiplier 0
+```
+
+For further information see the command line help of Meson by running
+`meson test -h`.
+
+## Legacy notes
+
+If `meson test` does not work for you, you likely have a old version
+of Meson. In that case you should call `mesontest` instead. If
+`mesontest` doesn't work either you have a very old version prior to
+0.37.0 and should upgrade.
+
+## Test outputs
+
+Meson will write several different files with detailed results of
+running tests. These will be written into $builddir/meson-logs/
+
+### testlog.json
+
+This is not a proper json file, but a file containing one valid json
+object per line. This is file is designed so each line is streamed out
+as each test is run, so it can be read as a stream while the test
+harness is running
+
+### testlog.junit.xml
+
+This is a valid JUnit XML description of all tests run. It is not
+streamed out, and is written only once all tests complete running.
+
+When tests use the `tap` protocol each test will be recorded as a
+testsuite container, with each case named by the number of the result.
+
+When tests use the `gtest` protocol Meson will inject arguments to the
+test to generate its own JUnit XML, which Meson will include as part
+of this XML file.
+
+*New in 0.55.0*

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/Unity-builds.md Added

@@ -0,0 +1,39 @@
+---
+short-description: Unity builds are a technique for reducing build times
+...
+
+# Unity builds
+
+Unity builds are a technique for cutting down build times. The way it
+works is relatively straightforward. Suppose we have source files
+`src1.c`, `src2.c` and `src3.c`. Normally we would run the compiler
+three times, once for each file. In a unity build we instead compile
+all these sources in a single unit. The simplest approach is to create
+a new source file that looks like this.
+
+```c
+#include<src1.c>
+#include<src2.c>
+#include<src3.c>
+```
+
+This is then compiled rather than the individual files. The exact
+speedup depends on the code base, of course, but it is not uncommon to
+obtain more than 50% speedup in compile times. This happens even
+though the Unity build uses only one CPU whereas individual compiles
+can be run in parallel. Unity builds can also lead to faster code,
+because the compiler can do more aggressive optimizations (e.g.
+inlining).
+
+The downside is that incremental builds are as slow as full rebuilds
+(because that is what they are). Unity compiles also use more memory,
+which may become an issue in certain scenarios. There may also be some
+bugs in the source that need to be fixed before Unity compiles work.
+As an example, if both `src1.c` and `src2.c` contain a static function
+or variable of the same name, there will be a clash.
+
+Meson has built-in support for unity builds. To enable them, just pass
+`--unity on` on the command line or enable unity builds with the GUI.
+No code changes are necessary apart from the potential clash issue
+discussed above. Meson will automatically generate all the necessary
+inclusion files for you.

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/Use-of-Python.md Added

@@ -0,0 +1,48 @@
+# Use of Python
+
+Meson is implemented in Python. This has both positive and negative
+sides. The main thing people seem to be mindful about is the
+dependency on Python to build source code. This page discusses various
+aspects of this problem.
+
+# Dependency hell
+
+There have been many Python programs that are difficult to maintain on
+multiple platforms. The reasons come mostly from dependencies. The
+program may use dependencies that are hard to compile on certain
+platforms, are outdated, conflict with other dependencies, not
+available on a given Python version and so on.
+
+Meson avoids dependency problems with one simple rule: Meson is not
+allowed to have any dependencies outside the Python basic library. The
+only thing you need is Python 3 (and possibly Ninja).
+
+## Reimplementability
+
+Meson has been designed in such a way that the implementation language
+is never exposed in the build definitions. This makes it possible (and
+maybe even easy) to reimplement Meson in any other programming
+language. There are currently no plans to reimplement Meson, but we
+will make sure that Python is not exposed inside the build
+definitions.
+
+## Cross platform tooling
+
+There is no one technical solution or programming language that works
+natively on all operating systems currently in use. When Autotools was
+designed in the late 80s, Unix shell was available pretty much
+anywhere. This is no longer the case.
+
+It is also the case that as any project gets larger, sooner or later
+it requires code generation, scripting or other tooling. This seems to
+be inevitable. Because there is no scripting language that would be
+available everywhere, these tools either need to be rewritten for each
+platform (which is a lot of work and is prone to errors) or the
+project needs to take a dependency on _something_.
+
+Any project that uses Meson (at least the current version) can rely on
+the fact that Python 3 will always be available, because you can't
+compile the project without it. All tooling can then be done in Python
+3 with the knowledge that it will run on any platform without any
+extra dependencies (modulo the usual porting work). This reduces
+maintenance effort on multiplatform projects by a fair margin.

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/Users.md Added

@@ -0,0 +1,176 @@
+---
+title: Users
+...
+
+# List of projects using Meson
+
+If you have a project that uses Meson that you want to add to this
+list, please file a
+pull-request(https://github.com/mesonbuild/meson/edit/master/docs/markdown/Users.md)
+for it. All the software on this list is tested for regressions before
+release, so it's highly recommended that projects add themselves
+here. Some additional projects are listed in the `meson` GitHub
+topic(https://github.com/topics/meson).
+
+ - 2048.cpp(https://github.com/plibither8/2048.cpp), a fully featured terminal version of the game "2048" written in C++
+ - aawordsearch(https://github.com/theimpossibleastronaut/aawordsearch), generate wordsearch puzzles using random words in different languages
+ - Adwaita Manager(https://github.com/AdwCustomizerTeam/AdwCustomizer), change the look of Adwaita, with ease
+ - Aravis(https://github.com/AravisProject/aravis), a glib/gobject based library for video acquisition using Genicam cameras
+ - Akira(https://github.com/akiraux/Akira), a native Linux app for UI and UX design built in Vala and Gtk
+ - AQEMU(https://github.com/tobimensch/aqemu), a Qt GUI for QEMU virtual machines, since version 0.9.3
+ - Arduino sample project(https://github.com/jpakkane/mesonarduino)
+ - Audacious(https://github.com/audacious-media-player), a lightweight and versatile audio player
+ - bolt(https://gitlab.freedesktop.org/bolt/bolt), userspace daemon to enable security levels for Thunderbolt™ 3 on Linux
+ - Bubblewrap(https://github.com/containers/bubblewrap), unprivileged sandboxing tool
+ - Budgie Desktop(https://github.com/budgie-desktop/budgie-desktop), a desktop environment built on GNOME technologies
+ - Bzip2(https://gitlab.com/federicomenaquintero/bzip2), the bzip2 compressor/decompressor
+ - Cage(https://github.com/Hjdskes/cage), a Wayland kiosk
+ - canfigger(https://github.com/andy5995/canfigger), simple configuration file parser library
+ - casync(https://github.com/systemd/casync), Content-Addressable Data Synchronization Tool
+ - cglm(https://github.com/recp/cglm), a highly optimized graphics math library for C
+ - cinnamon-desktop(https://github.com/linuxmint/cinnamon-desktop), the cinnamon desktop library
+ - Cozy(https://github.com/geigi/cozy), a modern audio book player for Linux and macOS using GTK+ 3
+ - dav1d(https://code.videolan.org/videolan/dav1d), an AV1 decoder
+ - dbus-broker(https://github.com/bus1/dbus-broker), Linux D-Bus Message Broker
+ - DOSBox Staging(https://github.com/dosbox-staging/dosbox-staging), DOS/x86 emulator
+ - DPDK(http://dpdk.org/browse/dpdk), Data Plane Development Kit, a set of libraries and drivers for fast packet processing
+ - DXVK(https://github.com/doitsujin/dxvk), a Vulkan-based Direct3D 11 implementation for Linux using Wine
+ - elementary OS(https://github.com/elementary/), Linux desktop oriented distribution
+ - Emeus(https://github.com/ebassi/emeus), constraint based layout manager for GTK+
+ - Entangle(https://entangle-photo.org/), tethered camera control and capture desktop application
+ - ESP8266 Arduino sample project(https://github.com/trilader/arduino-esp8266-meson), sample project for using the ESP8266 Arduino port with Meson
+ - FeedReader(https://github.com/jangernert/FeedReader), a modern desktop application designed to complement existing web-based RSS accounts
+ - Flecs(https://github.com/SanderMertens/flecs), a Fast and Lightweight ECS (Entity Component System) C library
+ - Foliate(https://github.com/johnfactotum/foliate), a simple and modern GTK eBook reader, built with GJS and Epub.js
+ - Fractal(https://wiki.gnome.org/Apps/Fractal/), a Matrix messaging client for GNOME
+ - Frida(https://github.com/frida/frida-core), a dynamic binary instrumentation toolkit
+ - fwupd(https://github.com/hughsie/fwupd), a simple daemon to allow session software to update firmware
+ - GameMode(https://github.com/FeralInteractive/gamemode), a daemon/lib combo for Linux that allows games to request a set of optimisations be temporarily applied to the host OS
+ - Geary(https://wiki.gnome.org/Apps/Geary), an email application built around conversations, for the GNOME 3 desktop.
+ - GLib(https://gitlab.gnome.org/GNOME/glib), cross-platform C library used by GTK+ and GStreamer
+ - Glorytun(https://github.com/angt/glorytun), a multipath UDP tunnel
+ - GNOME Boxes(https://gitlab.gnome.org/GNOME/gnome-boxes), a GNOME hypervisor
+ - GNOME Builder(https://gitlab.gnome.org/GNOME/gnome-builder), an IDE for the GNOME platform
+ - GNOME MPV(https://github.com/gnome-mpv/gnome-mpv), GNOME frontend to the mpv video player
+ - GNOME Recipes(https://gitlab.gnome.org/GNOME/recipes), application for cooking recipes
+ - GNOME Software(https://gitlab.gnome.org/GNOME/gnome-software), an app store for GNOME
+ - GNOME Twitch(https://github.com/vinszent/gnome-twitch), an app for viewing Twitch streams on GNOME desktop
+ - GNOME Usage(https://gitlab.gnome.org/GNOME/gnome-usage), a GNOME application for visualizing system resources
+ - GNU FriBidi(https://github.com/fribidi/fribidi), the open source implementation of the Unicode Bidirectional Algorithm
+ - Graphene(https://ebassi.github.io/graphene/), a thin type library for graphics
+ - Grilo(https://git.gnome.org/browse/grilo) and Grilo plugins(https://git.gnome.org/browse/grilo-plugins), the Grilo multimedia framework
+ - GStreamer(https://gitlab.freedesktop.org/gstreamer/gstreamer), multimedia framework
+ - GTK+(https://gitlab.gnome.org/GNOME/gtk), the multi-platform toolkit used by GNOME
+ - GtkDApp(https://gitlab.com/csoriano/GtkDApp), an application template for developing Flatpak apps with Gtk+ and D
+ - GVfs(https://git.gnome.org/browse/gvfs/), a userspace virtual filesystem designed to work with the I/O abstraction of GIO
+ - Hardcode-Tray(https://github.com/bil-elmoussaoui/Hardcode-Tray), fixes hardcoded tray icons in Linux
+ - HarfBuzz(https://github.com/harfbuzz/harfbuzz), a text shaping engine
+ - HelenOS(http://helenos.org), a portable microkernel-based multiserver operating system
+ - HexChat(https://github.com/hexchat/hexchat), a cross-platform IRC client in C
+ - IGT(https://gitlab.freedesktop.org/drm/igt-gpu-tools), Linux kernel graphics driver test suite
+ - i3(https://i3wm.org), improved tiling window manager
+ - inih(https://github.com/benhoyt/inih) (INI Not Invented Here), a small and simple .INI file parser written in C
+ - Irssi(https://github.com/irssi/irssi), a terminal chat client in C
+ - iSH(https://github.com/tbodt/ish), Linux shell for iOS
+ - Janet(https://github.com/janet-lang/janet), a functional and imperative programming language and bytecode interpreter
+ - json(https://github.com/nlohmann/json), JSON for Modern C++
+ - JsonCpp(https://github.com/open-source-parsers/jsoncpp), a C++ library for interacting with JSON
+ - Json-glib(https://gitlab.gnome.org/GNOME/json-glib), GLib-based JSON manipulation library
+ - Kiwix libraries(https://github.com/kiwix/kiwix-lib)
+ - Knot Resolver(https://gitlab.labs.nic.cz/knot/knot-resolver), Full caching DNS resolver implementation
+ - Ksh(https://github.com/att/ast), a Korn Shell
+ - Lc0(https://github.com/LeelaChessZero/lc0), LeelaChessZero is a UCI-compliant chess engine designed to play chess via neural network
+ - Le(https://github.com/kirushyk/le), machine learning framework
+ - libcamera(https://git.linuxtv.org/libcamera.git/), a library to handle complex cameras on Linux, ChromeOS and Android
+ - Libdrm(https://gitlab.freedesktop.org/mesa/drm), a library for abstracting DRM kernel interfaces
+ - libeconf(https://github.com/openSUSE/libeconf), Enhanced config file parsing library, which merges config files placed in several locations into one
+ - Libepoxy(https://github.com/anholt/libepoxy/), a library for handling OpenGL function pointer management
+ - libfuse(https://github.com/libfuse/libfuse), the reference implementation of the Linux FUSE (Filesystem in Userspace) interface
+ - Libgit2-glib(https://git.gnome.org/browse/libgit2-glib), a GLib wrapper for libgit2
+ - libglvnd(https://gitlab.freedesktop.org/glvnd/libglvnd), Vendor neutral OpenGL dispatch library for Unix-like OSes
+ - Libhttpseverywhere(https://git.gnome.org/browse/libhttpseverywhere), a library to enable httpseverywhere on any desktop app
+ - libmodulemd(https://github.com/fedora-modularity/libmodulemd), a GObject Introspected library for managing Fedora Project(https://getfedora.org/) module metadata.
+ - Libosmscout(https://github.com/Framstag/libosmscout), a C++ library for offline map rendering, routing and location
+lookup based on OpenStreetMap data
+ - libratbag(https://github.com/libratbag/libratbag), provides a DBus daemon to configure input devices, mainly gaming mice.
+ - libspng(https://github.com/randy408/libspng), a C library for reading and writing Portable Network Graphics (PNG)
+format files
+ - libSRTP(https://github.com/cisco/libsrtp) (from Cisco Systems), a library for SRTP (Secure Realtime Transport Protocol)
+ - libui(https://github.com/andlabs/libui), a simple and portable (but not inflexible) GUI library in C that uses the native GUI technologies of each platform it supports
+ - Libva(https://github.com/intel/libva), an implementation for the VA (VIdeo Acceleration) API
+ - libvips(https://github.com/libvips/libvips), a fast image processing library with low memory needs
+ - Libvirt(https://libvirt.org), a toolkit to manage virtualization platforms
+ - Libzim(https://github.com/openzim/libzim), the reference implementation for the ZIM file format
+ - LXC(https://github.com/lxc/lxc), Linux container runtime
+ - Marker(https://github.com/fabiocolacio/Marker), a GTK-3 markdown editor
+ - Mesa(https://mesa3d.org/), an open source graphics driver project
+ - Miniz(https://github.com/richgel999/miniz), a zlib replacement library
+ - MiracleCast(https://github.com/albfan/miraclecast), connect external monitors to your system via Wifi-Display specification aka Miracast
+ - mpv(https://github.com/mpv-player/mpv), a free, open source, and cross-platform media player
+ - mrsh(https://github.com/emersion/mrsh), a minimal POSIX shell
+ - Nautilus(https://gitlab.gnome.org/GNOME/nautilus), the GNOME file manager
+ - Nemo(https://github.com/linuxmint/nemo), the file manager for the Cinnamon desktop environment
+ - nvme-cli(https://github.com/linux-nvme/nvme-cli), NVMe management command line interface
+ - OcherBook(https://github.com/ccoffing/OcherBook), an open source book reader for Kobo devices
+ - oomd(https://github.com/facebookincubator/oomd), a userspace Out-Of-Memory (OOM) killer for Linux systems
+ - OpenH264(https://github.com/cisco/openh264), open source H.264 codec
+ - OpenHMD(https://github.com/OpenHMD/OpenHMD), a free and open source API and drivers for immersive technology, such as head mounted displays with built in head tracking
+ - OpenRC(https://github.com/OpenRC/openrc), an init system for Unix-like operating systems
+ - OpenTitan(https://github.com/lowRISC/opentitan), an open source silicon Root of Trust (RoT) project.
+ - Orc(https://gitlab.freedesktop.org/gstreamer/orc), the Optimized Inner Loop Runtime Compiler
+ - OTS(https://github.com/khaledhosny/ots), the OpenType Sanitizer, parses and serializes OpenType files (OTF, TTF) and WOFF and WOFF2 font files, validating and sanitizing them as it goes. Used by Chromium and Firefox
+ - Outlier(https://github.com/kerolasa/outlier), a small Hello World style Meson example project
+ - p11-kit(https://github.com/p11-glue/p11-kit), PKCS#11 module aggregator
+ - Pacman(https://gitlab.archlinux.org/pacman/pacman.git), a package manager for Arch Linux
+ - Pango(https://git.gnome.org/browse/pango/), an Internationalized text layout and rendering library
+ - Parzip(https://github.com/jpakkane/parzip), a multithreaded reimplementation of Zip
+ - Peek(https://github.com/phw/peek), simple animated GIF screen recorder with an easy to use interface
+ - PicoLibc(https://github.com/keith-packard/picolibc), a standard C library for small embedded systems with limited RAM
+ - PipeWire(https://github.com/PipeWire/pipewire), a framework for video and audio for containerized applications
+ - Paper Rock Scissors(https://github.com/michaelbrockus/paper_rock_scissors), a game with weapons themed at home paper rock scissors style.
+ - Pistache(https://github.com/pistacheio/pistache), a high performance REST toolkit written in C++
+ - Pithos(https://github.com/pithos/pithos), a Pandora Radio client
+ - Pitivi(https://github.com/pitivi/pitivi/), a nonlinear video editor
+ - Planner(https://github.com/alainm23/planner), task manager with Todoist support designed for GNU/Linux
+ - Playerctl(https://github.com/acrisci/playerctl), mpris command-line controller and library for spotify, vlc, audacious, bmp, cmus, and others
+ - Polari(https://gitlab.gnome.org/GNOME/polari), an IRC client
+ - PostgreSQL(https://www.postgresql.org/), an advanced open source relational database
+ - qboot(https://github.com/bonzini/qboot), a minimal x86 firmware for booting Linux kernels
+ - radare2(https://github.com/radare/radare2), unix-like reverse engineering framework and commandline tools (not the default)
+ - rmw(https://remove-to-waste.info), safe-remove utility for the command line
+ - Rizin(https://rizin.re), Free and Open Source Reverse Engineering Framework
+ - QEMU(https://qemu.org), a processor emulator and virtualizer
+ - RxDock(https://gitlab.com/rxdock/rxdock), a protein-ligand docking software designed for high throughput virtual screening (fork of rDock)
+ - SciPy(https://scipy.org/), an open-source software for mathematics, science, and engineering
+ - scrcpy(https://github.com/Genymobile/scrcpy), a cross platform application that provides display and control of Android devices connected on USB or over TCP/IP
+ - Sequeler(https://github.com/Alecaddd/sequeler), a friendly SQL client for Linux, built with Vala and Gtk
+ - Siril(https://gitlab.com/free-astro/siril), an image processing software for amateur astronomy
+ - Spot(https://github.com/xou816/spot), Rust based Spotify client for the GNOME desktop
+ - SSHFS(https://github.com/libfuse/sshfs), allows you to mount a remote filesystem using SFTP
+ - sway(https://github.com/swaywm/sway), i3-compatible Wayland compositor
+ - Sysprof(https://git.gnome.org/browse/sysprof), a profiling tool
+ - systemd(https://github.com/systemd/systemd), the init system
+ - szl(https://github.com/dimkr/szl), a lightweight, embeddable scripting language
+ - Taisei Project(https://taisei-project.org/), an open-source Touhou Project clone and fangame
+ - Terminology(https://github.com/billiob/terminology), a terminal emulator based on the Enlightenment Foundation Libraries
+ - Tilix(https://github.com/gnunn1/tilix), a tiling terminal emulator for Linux using GTK+ 3
+ - Tizonia(https://github.com/tizonia/tizonia-openmax-il), a command-line cloud music player for Linux with support for Spotify, Google Play Music, YouTube, SoundCloud, TuneIn, Plex servers and Chromecast devices
+ - UFJF-MLTK(https://github.com/mateus558/UFJF-Machine-Learning-Toolkit), A C++ cross-platform framework for machine learning algorithms development and testing
+ - Vala Language Server(https://github.com/benwaffle/vala-language-server), code intelligence engine for the Vala and Genie programming languages
+ - Valum(https://github.com/valum-framework/valum), a micro web framework written in Vala
+ - Venom(https://github.com/naxuroqa/Venom), a modern Tox client for the GNU/Linux desktop
+ - vkQuake(https://github.com/Novum/vkQuake), a port of id Software's Quake using Vulkan instead of OpenGL for rendering
+ - VMAF(https://github.com/Netflix/vmaf) (by Netflix), a perceptual video quality assessment based on multi-method fusion
+ - Wayland(https://github.com/wayland-project/wayland) and Weston(https://github.com/wayland-project/weston), a next generation display server
+ - wlroots(https://github.com/swaywm/wlroots), a modular Wayland compositor library
+ - xi-gtk(https://github.com/eyelash/xi-gtk), a GTK+ front-end for the Xi editor
+ - Xorg(https://gitlab.freedesktop.org/xorg/xserver), the X.org display server (not the default yet)
+ - X Test Suite(https://gitlab.freedesktop.org/xorg/test/xts), The X.org test suite
+ - zathura(https://github.com/pwmt/zathura), a highly customizable and functional document viewer based on the
+girara user interface library and several document libraries
+ - Zrythm(https://git.sr.ht/~alextee/zrythm), a cross-platform digital audio workstation written in C using GTK4
+ - ZStandard(https://github.com/facebook/zstd/commit/4dca56ed832c6a88108a2484a8f8ff63d8d76d91), a compression algorithm developed at Facebook (not used by default)
+
+Note that a more up-to-date list of GNOME projects that use Meson can
+be found
+here(https://wiki.gnome.org/Initiatives/GnomeGoals/MesonPorting).

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/Using-multiple-build-directories.md Added

@@ -0,0 +1,95 @@
+# Using multiple build directories
+
+One of the main design goals of Meson has been to build all projects
+out-of-source. This means that *all* files generated during the build
+are placed in a separate subdirectory. This goes against common Unix
+tradition where you build your projects in-source. Building out of
+source gives two major advantages.
+
+First of all this makes for very simple VCS "ignore" files. In
+classical build systems you may need to have tens of lines of
+definitions, most of which contain wildcards. When doing out of source
+builds all of this busywork goes away. A common ignore file for a
+Meson project only contains a few lines that are the build directory
+and IDE project files. (Note that since Meson 0.57.0, build directories
+are automatically ignored for git and mercurial by generating an ignore
+file inside the build directory.)
+
+Secondly this makes it very easy to clean your projects: just delete
+the build subdirectory and you are done. There is no need to guess
+whether you need to run `make clean`, `make distclean`, `make
+mrproper` or something else. When you delete a build subdirectory
+there is no possible way to have any lingering state from your old
+builds.
+
+The true benefit comes from somewhere else, though.
+
+## Multiple build directories for the same source tree
+
+Since a build directory is fully self contained and treats the source
+tree as a read-only piece of data, it follows that you can have
+arbitrarily many build trees for any source tree at the same time.
+Since all build trees can have different configuration, this is
+extremely powerful. Now you might be wondering why one would want to
+have multiple build setups at the same time. Let's examine this by
+setting up a hypothetical project.
+
+The first thing to do is to set up the default build, that is, the one
+we are going to use over 90% of the time. In this we use the system
+compiler and build with debug enabled and no optimizations so it
+builds as fast as possible. This is the default project type for
+Meson, so setting it up is simple.
+
+    mkdir builddir
+    meson setup builddir
+
+Another common setup is to build with debug and optimizations to, for
+example, run performance tests. Setting this up is just as simple.
+
+    mkdir buildopt
+    meson --buildtype=debugoptimized buildopt
+
+For systems where the default compiler is GCC, we would like to
+compile with Clang, too. So let's do that.
+
+    mkdir buildclang
+    CC=clang CXX=clang++ meson setup buildclang
+
+You can add cross builds, too. As an example, let's set up a Linux ->
+Windows cross compilation build using MinGW.
+
+    mkdir buildwine
+    meson --cross-file=mingw-cross.txt buildwine
+
+The cross compilation file sets up Wine so that not only can you
+compile your application, you can also run the unit test suite just by
+issuing the command `meson test`.
+
+To compile any of these build types, just cd into the corresponding
+build directory and run `meson compile` or instruct your IDE to do the
+same. Note that once you have set up your build directory once, you
+can just run Ninja and Meson will ensure that the resulting build is
+fully up to date according to the source. Even if you have not touched
+one of the directories in weeks and have done major changes to your
+build configuration, Meson will detect this and bring the build
+directory up to date (or print an error if it can't do that). This
+allows you to do most of your work in the default directory and use
+the others every now and then without having to babysit your build
+directories.
+
+## Specialized uses
+
+Separate build directories allows easy integration for various
+different kinds of tools. As an example, Clang comes with a static
+analyzer. It is meant to be run from scratch on a given source tree.
+The steps to run it with Meson are very simple.
+
+    rm -rf buildscan
+    mkdir buildscan
+    scan-build meson setup buildscan
+    cd buildscan
+    scan-build ninja
+
+These commands are the same for every single Meson project, so they
+could even be put in a script turning static analysis into a single
+command.

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/Using-the-WrapDB.md Added

@@ -0,0 +1,47 @@
+# Using the WrapDB
+
+The Wrap database is a web service that provides Meson build
+definitions to projects that do not have it natively. Using it is
+simple. The service can be found
+here(https://wrapdb.mesonbuild.com).
+
+The front page lists all projects that are on the service. Select the
+one you want and click it. The detail page lists available versions by
+branch and revision id. The branch names come from upstream releases
+and revision ids are version numbers internal to the database.
+Whenever the packaging is updated a new revision is released to the
+service a new revision with a bigger revision id is added. Usually you
+want to select the newest branch with the highest revision id.
+
+You can get the actual wrap file which tells Meson how to fetch the
+project by clicking on the download link on the page. As an example,
+the wrap file for zlib-1.2.8, revision
+4(https://wrapdb.mesonbuild.com/v1/projects/zlib/1.2.8/4/get_wrap)
+looks like this. You can find detailed documentation about it in the
+Wrap manual(Wrap-dependency-system-manual.md).
+
+    wrap-file
+    directory = zlib-1.2.8
+
+    source_url = http://zlib.net/zlib-1.2.8.tar.gz
+    source_filename = zlib-1.2.8.tar.gz
+    source_hash = 36658cb768a54c1d4dec43c3116c27ed893e88b02ecfcb44f2166f9c0b7f2a0d
+
+    patch_url = https://wrapdb.mesonbuild.com/v1/projects/zlib/1.2.8/4/get_zip
+    patch_filename = zlib-1.2.8-4-wrap.zip
+    patch_hash = 2327a42c8f73a4289ee8c9cd4abc43b324d0decc28d6e609e927f0a50321af4a
+
+Add this file to your project with the name `subprojects/zlib.wrap`.
+Then you can use it in your `meson.build` file with this directive:
+
+    zproj = subproject('zlib')
+
+When Meson encounters this it will automatically download, unpack and
+patch the source files.
+
+## Contributing build definitions
+
+The contents of the Wrap database are tracked in git repos of the
+Mesonbuild project(https://github.com/mesonbuild). The actual
+process is simple and described in submission
+documentation(Adding-new-projects-to-wrapdb.md).

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/Using-with-Visual-Studio.md Added

@@ -0,0 +1,47 @@
+---
+short-description: How to use Meson in Visual Studio
+...
+
+# Using with Visual Studio
+
+In order to generate Visual Studio projects, Meson needs to know the
+settings of your installed version of Visual Studio. The only way to
+get this information is to run Meson under the Visual Studio Command
+Prompt.
+
+You can always find the Visual Studio Command Prompt by searching from
+the Start Menu. However, the name is different for each Visual Studio
+version. With Visual Studio 2019, look for "x64 Native Tools Command
+Prompt for VS 2019". The next steps are the same as
+always(https://mesonbuild.com/Running-Meson.html#configuring-the-build-directory):
+
+1. `cd` into your source directory
+1. `meson setup builddir`, which will create and setup the build directory
+1. `meson compile -C builddir`, to compile your code. You can also use `ninja -C builddir` here if you are using the default Ninja backend.
+
+If you wish to generate Visual Studio project files, pass `--backend
+vs`. At the time of writing the Ninja backend is more mature than the
+VS backend so you might want to use it for serious work.
+
+# Using Clang-CL with Visual Studio
+
+*(new in 0.52.0)*
+
+You will first need to get a copy of llvm+clang for Windows, such versions
+are available from a number of sources, including the llvm website. Then you
+will need the llvm toolset extension for visual
+studio(https://marketplace.visualstudio.com/items?itemName=LLVMExtensions.llvm-toolchain).
+You then need to either use a native file(Native-environments.md#binaries)
+or `set CC=clang-cl`, and `set CXX=clang-cl` to use those compilers, Meson
+will do the rest.
+
+This only works with visual studio 2017 and 2019.
+
+There is currently no support in Meson for clang/c2.
+
+# Using Intel-CL (ICL) with Visual Studio
+
+*(new in 0.52.0)*
+
+To use ICL you need only have ICL installed and launch an ICL development
+shell like you would for the ninja backend and Meson will take care of it.

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/Using-wraptool.md Added

@@ -0,0 +1,98 @@
+# Using wraptool
+
+Wraptool is a subcommand of Meson that allows you to manage your
+source dependencies using the WrapDB database. It gives you all things
+you would expect, such as installing and updating dependencies. The
+wrap tool works on all platforms, the only limitation is that the wrap
+definition works on your target platform. If you find some Wraps that
+don't work, please file bugs or, even better, patches.
+
+All code examples here assume that you are running the commands in
+your top level source directory. Lines that start with the `$` mark
+are commands to type.
+
+## Simple querying
+
+The simplest operation to do is to query the list of packages
+available. To list them all issue the following command:
+
+    $ meson wrap list
+    box2d
+    enet
+    gtest
+    libjpeg
+    liblzma
+    libpng
+    libxml2
+    lua
+    ogg
+    sqlite
+    vorbis
+    zlib
+
+Usually you want to search for a specific package. This can be done
+with the `search` command:
+
+    $ meson wrap search jpeg
+    libjpeg
+
+If a package is not found in the list of wraps, the `search` command
+will look in all the wrap dependencies:
+
+    $ meson wrap search glib-2.0
+    Dependency glib-2.0 found in wrap glib
+
+To determine which versions of libjpeg are available to install, issue
+the `info` command:
+
+    $ meson wrap info libjpeg
+    Available versions of libjpeg:
+      9a 2
+
+The first number is the upstream release version, in this case
+`9a`. The second number is the Wrap revision number. They don't relate
+to anything in particular, but larger numbers imply newer
+releases. You should always use the newest available release.
+
+## Installing dependencies
+
+Installing dependencies is just as straightforward. First just create
+the `subprojects` directory at the top of your source tree and issue
+the install command.
+
+    $ meson wrap install libjpeg
+    Installed libjpeg branch 9a revision 2
+
+Now you can issue a `subproject('libjpeg')` in your `meson.build` file
+to use it.
+
+To check if your projects are up to date you can issue the `status` command.
+
+    $ meson wrap status
+    Subproject status
+     libjpeg up to date. Branch 9a, revision 2.
+     zlib not up to date. Have 1.2.8 2, but 1.2.8 4 is available.
+
+In this case `zlib` has a newer release available. Updating it is
+straightforward:
+
+    $ meson wrap update zlib
+    Updated zlib to branch 1.2.8 revision 4
+
+Wraptool can do other things besides these. Documentation for these
+can be found in the command line help, which can be accessed by
+`meson wrap --help`.
+
+## Automatic dependency fallback
+
+Since *0.64.0* Meson can use WrapDB to automatically find missing dependencies.
+
+The user simply needs to download latest database, the following command stores
+it in `subprojects/wrapdb.json`:
+    $ meson wrap update-db
+
+Once the database is available locally, any dependency not found on the system
+but available in WrapDB will automatically be downloaded.
+
+Automatic fetch of WrapDB subprojects can be disabled by removing the file
+`subprojects/wrapdb.json`, or by using `--wrap-mode=nodownload`.

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/Vala.md Added

@@ -0,0 +1,350 @@
+---
+title: Vala
+short-description: Compiling Vala and Genie programs
+...
+
+# Compiling Vala applications and libraries
+Meson supports compiling applications and libraries written in
+Vala(https://vala-project.org/) and
+Genie(https://wiki.gnome.org/Projects/Genie) . A skeleton `meson.build` file:
+
+```meson
+project('vala app', 'vala', 'c')
+
+dependencies = 
+    dependency('glib-2.0'),
+    dependency('gobject-2.0'),
+
+
+sources = files('app.vala')
+
+executable('app_name', sources, dependencies: dependencies)
+```
+
+You must always specify the `glib-2.0` and `gobject-2.0` libraries as
+dependencies, because all current Vala applications use them.
+GLib(https://developer.gnome.org/glib/stable/) is used for basic data types
+and GObject(https://developer.gnome.org/gobject/stable/) is used for the
+runtime type system.
+
+
+## Using libraries
+
+Meson uses the dependency
+function to find the relevant VAPI, C headers and linker flags when it
+encounters a Vala source file in a build target. Vala needs a VAPI
+file and a C header or headers to use a library. The VAPI file helps
+map Vala code to the library's C programming interface. It is the
+`pkg-config`(https://www.freedesktop.org/wiki/Software/pkg-config/)
+tool that makes finding these installed files all work seamlessly
+behind the scenes. When a `pkg-config` file doesn't exist for the
+library then the `find_library()`
+method of the @compiler object
+needs to be used. Examples are given later.
+
+Note Vala uses libraries that follow the C Application Binary Interface (C ABI).
+The library, however, could be written in C, Vala, Rust, Go, C++ or any other
+language that can generate a binary compatible with the C ABI and so provides C
+headers.
+
+
+### The simplest case
+This first example is a simple addition to the `meson.build` file because:
+
+ * the library has a `pkg-config` file, `gtk+-3.0.pc`
+ * the VAPI is distributed with Vala and so installed with the Vala compiler
+ * the VAPI is installed in Vala's standard search path
+ * the VAPI, `gtk+-3.0.vapi`, has the same name as the `pkg-config` file
+
+Everything works seamlessly in the background and only a single extra line is
+needed:
+
+```meson
+project('vala app', 'vala', 'c')
+
+dependencies = 
+    dependency('glib-2.0'),
+    dependency('gobject-2.0'),
+    dependency('gtk+-3.0'),
+
+
+sources = files('app.vala')
+
+executable('app_name', sources, dependencies: dependencies)
+```
+
+GTK+ is the graphical toolkit used by GNOME, elementary OS and other
+desktop environments. The binding to the library, the VAPI file, is
+distributed with Vala.
+
+Other libraries may have a VAPI that is distributed with the library
+itself. Such libraries will have their VAPI file installed along with
+their other development files. The VAPI is installed in Vala's
+standard search path and so works just as seamlessly using the
+`dependency()` function.
+
+
+### Targeting a version of GLib
+
+Meson's dependency function
+allows a version check of a library. This is often used to check a
+minimum version is installed. When setting a minimum version of GLib,
+Meson will also pass this to the Vala compiler using the
+`--target-glib` option.
+
+This is needed when using GTK+'s user interface definition files with
+Vala's `GtkTemplate`, `GtkChild` and `GtkCallback` attributes.
+This requires `--target-glib 2.38`, or a newer version, to be passed
+to Vala. With Meson this is simply done with:
+
+```meson
+project('vala app', 'vala', 'c')
+
+dependencies = 
+    dependency('glib-2.0', version: '>=2.38'),
+    dependency('gobject-2.0'),
+    dependency('gtk+-3.0'),
+
+
+sources = files('app.vala')
+
+executable('app_name', sources, dependencies: dependencies)
+```
+
+Using `GtkTemplate` also requires the GTK+ user interface definition
+files to be built in to the binary as GResources. For completeness,
+the next example shows this:
+
+```meson
+project('vala app', 'vala', 'c')
+
+dependencies = 
+    dependency('glib-2.0', version: '>=2.38'),
+    dependency('gobject-2.0'),
+    dependency('gtk+-3.0'),
+
+
+sources = files('app.vala')
+
+sources += import( 'gnome' ).compile_resources(
+    'project-resources',
+    'src/resources/resources.gresource.xml',
+    source_dir: 'src/resources',
+)
+
+executable('app_name', sources, dependencies: dependencies)
+```
+
+
+### Adding to Vala's search path
+
+So far we have covered the cases where the VAPI file is either
+distributed with Vala or the library. A VAPI can also be included in
+the source files of your project. The convention is to put it in the
+`vapi` directory of your project.
+
+This is needed when a library does not have a VAPI or your project
+needs to link to another component in the project that uses the C ABI.
+For example if part of the project is written in C.
+
+The Vala compiler's `--vapidir` option is used to add the project
+directory to the VAPI search path. In Meson this is done with the
+`add_project_arguments()` function:
+
+```meson
+project('vala app', 'vala', 'c')
+
+vapi_dir = meson.current_source_dir() / 'vapi'
+
+add_project_arguments('--vapidir', vapi_dir, language: 'vala')
+
+dependencies = 
+    dependency('glib-2.0'),
+    dependency('gobject-2.0'),
+    dependency('foo'), # 'foo.vapi' will be resolved as './vapi/foo.vapi'
+
+
+sources = files('app.vala')
+
+executable('app_name', sources, dependencies: dependencies)
+```
+
+If the VAPI is for an external library then make sure that the VAPI
+name corresponds to the pkg-config file name.
+
+The `vala-extra-vapis`
+repository(https://gitlab.gnome.org/GNOME/vala-extra-vapis) is a
+community maintained repository of VAPIs that are not distributed.
+Developers use the repository to share early work on new bindings and
+improvements to existing bindings. So the VAPIs can frequently change.
+It is recommended VAPIs from this repository are copied in to your
+project's source files.
+
+This also works well for starting to write new bindings before they
+are shared with the `vala-extra-vapis` repository.
+
+
+### Libraries without pkg-config files
+
+A library that does not have a corresponding pkg-config file may mean
+`dependency()` is unsuitable for finding the C and Vala interface
+files. In this case it is necessary to use the `find_library()` method
+of the compiler object.
+
+The first example uses Vala's POSIX binding. There is no pkg-config
+file because POSIX includes the standard C library on Unix systems.
+All that is needed is the VAPI file, `posix.vapi`. This is included
+with Vala and installed in Vala's standard search path. Meson just
+needs to be told to only find the library for the Vala compiler:
+
+```meson
+project('vala app', 'vala', 'c')
+
+dependencies = 
+    dependency('glib-2.0'),
+    dependency('gobject-2.0'),
+    meson.get_compiler('vala').find_library('posix'),
+
+
+sources = files('app.vala')
+
+executable('app_name', sources, dependencies: dependencies)
+```
+
+The next example shows how to link with a C library where no
+additional VAPI is needed. The standard maths functions are already
+bound in `glib-2.0.vapi`, but the GNU C library requires linking to
+the maths library separately. In this example Meson is told to find
+the library only for the C compiler:
+
+```meson
+project('vala app', 'vala', 'c')
+
+dependencies = 
+    dependency('glib-2.0'),
+    dependency('gobject-2.0'),
+    meson.get_compiler('c').find_library('m', required: false),
+
+
+sources = files('app.vala')
+
+executable('app_name', sources, dependencies: dependencies)
+```
+
+The `required: false` means the build will continue when using another
+C library that does not separate the maths library. See Add math
+library (-lm) portably(howtox.md#add-math-library-lm-portably).
+
+The final example shows how to use a library that does not have a
+pkg-config file and the VAPI is in the `vapi` directory of your
+project source files:
+
+```meson
+project('vala app', 'vala', 'c')
+
+vapi_dir = meson.current_source_dir() / 'vapi'
+
+add_project_arguments('--vapidir', vapi_dir, language: 'vala')
+
+dependencies = 
+    dependency('glib-2.0'),
+    dependency('gobject-2.0'),
+    meson.get_compiler('c').find_library('foo'),
+    meson.get_compiler('vala').find_library('foo', dirs: vapi_dir),
+
+
+sources = files('app.vala')
+
+executable('app_name', sources, dependencies: dependencies)
+```
+The `find_library()` method of the C compiler object will try to find the C
+header files and the library to link with.
+
+The `find_library()` method of the Vala compiler object needs to have the `dir`
+keyword added to include the project VAPI directory. This is not added
+automatically by `add_project_arguments()`.
+
+### Working with the Vala Preprocessor
+
+Passing arguments to Vala's
+preprocessor(https://wiki.gnome.org/Projects/Vala/Manual/Preprocessor)
+requires specifying the language as `vala`. For example, the following
+statement sets the preprocessor symbol `USE_FUSE`:
+
+```meson
+add_project_arguments('-D', 'USE_FUSE', language: 'vala')
+```
+
+If you need to pass an argument to the C pre-processor then specify
+the language as c. For example to set FUSE_USE_VERSION to 26 use:
+
+```meson
+add_project_arguments('-DFUSE_USE_VERSION=26', language: 'c')
+```
+
+## Building libraries
+
+
+### Changing C header and VAPI names
+
+Meson's library target automatically
+outputs the C header and the VAPI. They can be renamed by setting the
+`vala_header` and `vala_vapi` arguments respectively:
+
+```meson
+foo_lib = shared_library('foo', 'foo.vala',
+                  vala_header: 'foo.h',
+                  vala_vapi: 'foo-1.0.vapi',
+                  dependencies: glib_dep, gobject_dep,
+                  install: true,
+                  install_dir: true, true, true)
+```
+
+In this example, the second and third elements of the `install_dir`
+array indicate the destination with `true` to use default directories
+(i.e. `include` and `share/vala/vapi`).
+
+
+### GObject Introspection and language bindings
+
+A 'binding' allows another programming language to use a library
+written in Vala. Because Vala uses the GObject type system as its
+runtime type system it is very easy to use introspection to generate a
+binding. A Meson build of a Vala library can generate the GObject
+introspection metadata. The metadata is then used in separate projects
+with language specific
+tools(https://wiki.gnome.org/Projects/Vala/LibraryWritingBindings) to
+generate a binding.
+
+The main form of metadata is a GObject Introspection Repository (GIR)
+XML file. GIRs are mostly used by languages that generate bindings at
+compile time. Languages that generate bindings at runtime mostly use a
+typelib file, which is generated from the GIR.
+
+Meson can generate a GIR as part of the build. For a Vala library the
+`vala_gir` option has to be set for the `library`:
+
+```meson
+foo_lib = shared_library('foo', 'foo.vala',
+                  vala_gir: 'Foo-1.0.gir',
+                  dependencies: glib_dep, gobject_dep,
+                  install: true,
+                  install_dir: true, true, true, true)
+```
+
+The `true` value in `install_dir` tells Meson to use the default
+directory (i.e. `share/gir-1.0` for GIRs). The fourth element in the
+`install_dir` array indicates where the GIR file will be installed.
+
+To then generate a typelib file use a custom target with the
+`g-ir-compiler` program and a dependency on the library:
+
+```meson
+g_ir_compiler = find_program('g-ir-compiler')
+custom_target('foo typelib', command: g_ir_compiler, '--output', '@OUTPUT@', '@INPUT@',
+              input: meson.current_build_dir() / 'Foo-1.0.gir',
+              output: 'Foo-1.0.typelib',
+              depends: foo_lib,
+              install: true,
+              install_dir: get_option('libdir') / 'girepository-1.0')
+```

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/Videos.md Added

@@ -0,0 +1,45 @@
+---
+short-description: Videos about Meson
+...
+
+# Videos
+
+ - Behind (and under) the scenes of the Meson build
+   system(https://www.youtube.com/watch?v=iLN6wL7ExHU), Linux.conf.au
+   2020
+
+ - Behind the Scenes of a C++ Build
+   System(https://www.youtube.com/watch?v=34KzT2yvQuM), CppCon 2019
+
+ - Compiling Multi-Million Line C++ Code Bases Effortlessly with the
+   Meson Build system(https://www.youtube.com/watch?v=SCZLnopmYBM),
+   CppCon 2018
+
+ - The Meson Build System, 4+ years of work to become an overnight
+   success(https://www.youtube.com/watch?v=gHdTzdXkhRY), Linux.conf.au 2018
+
+ - Power through simplicity, using Python in the Meson Build
+   System(https://youtu.be/3jF3oVsjIEM), Piter.py, 2017
+
+ - Meson and the changing Linux build
+   landscape(https://media.ccc.de/v/ASG2017-111-meson_and_the_changing_linux_build_landscape),
+   All Systems Go 2017
+
+ - Meson, compiling the world with
+   Python(https://www.youtube.com/watch?v=sEO4DC8hm34), Europython
+   2017
+
+ - Builds, dependencies and deployment in a modern multiplatform
+   world(https://www.youtube.com/embed/CTJtKtQ8R5k), Linux.conf.au
+   2016
+
+ - New world, new tools(https://www.youtube.com/embed/0-gx1qU2pPo),
+   Libre Application Summit 2016
+
+ - Making build systems not
+   suck(https://www.youtube.com/embed/KPi0AuVpxLI), Linux.conf.au
+   2015, Auckland, New Zealand
+
+ - Lightning talk at FOSDEM
+   2014(http://mirror.onet.pl/pub/mirrors/video.fosdem.org/2014/H2215_Ferrer/Sunday/Introducing_the_Meson_build_system.webm),
+   The first ever public presentation on Meson

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/Vs-External.md Added

@@ -0,0 +1,57 @@
+# Visual Studio's external build projects
+
+Visual Studio supports developing projects that have an external build
+system. If you wish to use this integration method, here is how you
+set it up. This documentation describes Visual Studio 2019. Other
+versions have not been tested, but they should work roughly in the
+same way.
+
+## Creating and compiling
+
+Check out your entire project in some directory. Then open Visual
+Studio and select `File -> New -> Project` and from the list of
+project types select `Makefile project`. Click `Next`.
+
+Type your project's name In the `Project name` entry box. In this
+example we're going to use `testproj`. Next select the `Location`
+entry and browse to the root of your project sources. Make sure that
+the checkbox `Place solution and project in the same directory` is
+checked. Click `Create`.
+
+The next dialog page defines build commands, which you should set up
+as follows:
+
+| entry | value |
+| ----- | ----- |
+|build  | `meson compile -C $(Configuration)` |
+|clean  | `meson compile -C $(Configuration) --clean` |
+|rebuild| `meson compile -C $(Configuration) --clean && meson compile -C $(Configuration)` |
+|Output | `$(Configuration)\name_of_your_executable.exe|
+
+
+Then click `Finish`.
+
+Visual Studio has created a subdirectory in your source root. It is
+named after the project name. In this case it would be `testproj`. Now
+you need to set up Meson for building both Debug and Release versions
+in this directory. Open a VS dev tool terminal, go to the source root
+and issue the following commands.
+
+```
+meson testproj\Debug
+meson testproj\Release --buildtype=debugoptimized
+```
+
+Now you should have a working VS solution that compiles and runs both
+in Debug and Release modes.
+
+## Adding sources to the project
+
+This project is not very useful on its own, because it does not list
+any source files. VS does not seem to support adding entire source
+trees at once, so you have to add sources to the solution manually.
+
+In the main view go to `Solution Explorer`, right click on the project
+you just created and select `Add -> Existing Item`, browse to your
+source tree and select all files you want to have in this project. Now
+you can use the editor and debugger as in a normal VS project.

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/Wayland-module.md Added

@@ -0,0 +1,76 @@
+# Unstable Wayland Module
+
+This module is available since version 0.62.0.
+
+This module provides helper functions to find wayland protocol
+xmls and to generate .c and .h files using wayland-scanner
+
+**Note**: this module is unstable. It is only provided as a technology
+preview. Its API may change in arbitrary ways between releases or it
+might be removed from Meson altogether.
+
+## Quick Usage
+
+```meson
+project('hello-wayland', 'c')
+
+wl_dep = dependency('wayland-client')
+wl_mod = import('unstable-wayland')
+
+xml = wl_mod.find_protocol('xdg-shell')
+xdg_shell = wl_mod.scan_xml(xml)
+
+executable('hw', 'main.c', xdg_shell, dependencies : wl_dep)
+```
+
+## Methods
+
+### find_protocol
+```meson
+xml = wl_mod.find_protocol(
+  'xdg-decoration',
+  state : 'unstable',
+  version : 1,
+)
+```
+This function requires one positional argument: the protocol base name.
+
+It takes the following keyword arguments:
+- `state` Optional arg that specifies the current state of the protocol.
+  Either `'stable'`, `'staging'`, or `'unstable'`. The default is `'stable'`.
+- `version` The backwards incompatible version number as integer.
+  Required for staging and unstable, but not allowed for stable.
+
+**Returns**: a @file that can be passed to scan_xml(#scan_xml)
+
+### scan_xml
+```meson
+generated = wl_mod.scan_xml(
+  'my-protocol.xml',
+  client : true,
+  server : true,
+  public : false,
+  include_core_only : true,
+)
+```
+This function accepts one or more arguments of either string or file type.
+
+It takes the following keyword arguments:
+- `public` Optional arg that specifies the scope of the generated code.
+  The default is false.
+- `client` Optional arg that specifies if client side header file is
+  generated. The default is true.
+- `server` Optional arg that specifies if server side header file is
+  generated. The default is false.
+- `include_core_only` Optional arg that specifies that generated headers only include
+  `wayland-<client|server>-core.h` instead of `wayland-<client|server>.h`. 
+  The default is true. Since *0.64.0*
+
+**Returns**: a list of @custom_tgt in the order source, client side header,
+server side header. Generated header files have the name
+`<name>-<client|server>-protocol.h`.
+
+## Links
+- Official Wayland Documentation(https://wayland.freedesktop.org/docs/html/)
+- Wayland GitLab(https://gitlab.freedesktop.org/wayland)
+- Wayland Book(https://wayland-book.com/)

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/Windows-module.md Added

@@ -0,0 +1,43 @@
+# Windows module
+
+This module provides functionality used to build applications for
+Windows.
+
+## Methods
+
+### compile_resources
+
+```
+  windows = import('windows')
+  windows.compile_resources(...(string | File | CustomTarget | CustomTargetIndex),
+                            args: string,
+                            depend_files: (string | File),
+                            depends: (BuildTarget | CustomTarget)
+                            include_directories: (IncludeDirectories | string)): CustomTarget
+```
+
+Compiles Windows `rc` files specified in the positional arguments.
+Returns a list of `CustomTarget` objects that you put in the list of sources for
+the target you want to have the resources in.
+
+*Since 0.61.0* CustomTargetIndexs and CustomTargets with more than out output
+*may be used as positional arguments.
+
+This method has the following keyword arguments:
+
+- `args` lists extra arguments to pass to the resource compiler
+- `depend_files` lists resource files that the resource script depends on
+  (e.g. bitmap, cursor, font, html, icon, message table, binary data or manifest
+  files referenced by the resource script) (*since 0.47.0*)
+- `depends` lists target(s) that this target depends on, even though it does not
+  take them as an argument (e.g. as above, but generated) (*since 0.47.0*)
+- `include_directories` lists directories to be both searched by the resource
+  compiler for referenced resource files, and added to the preprocessor include
+  search path.
+
+The resource compiler executable used is the first which exists from the
+following list:
+
+1. The `windres` executable given in the `binaries` section of the cross-file
+2. The `WINDRES` environment variable
+3. The resource compiler which is part of the same toolset as the C or C++ compiler in use.

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/Wrap-best-practices-and-tips.md Added

@@ -0,0 +1,158 @@
+# Wrap best practices and tips
+
+There are several things you need to take into consideration when
+writing a Meson build definition for a project. This is especially
+true when the project will be used as a subproject. This page lists a
+few things to consider when writing your definitions.
+
+## Do not put config.h in external search path
+
+Many projects use a `config.h` header file that they use for
+configuring their project internally. These files are never installed
+to the system header files so there are no inclusion collisions. This
+is not the case with subprojects, your project tree may have an
+arbitrary number of configuration files, so we need to ensure they
+don't clash.
+
+The basic problem is that the users of the subproject must be able to
+include subproject headers without seeing its `config.h` file. The
+most correct solution is to rename the `config.h` file into something
+unique, such as `foobar-config.h`. This is usually not feasible unless
+you are the maintainer of the subproject in question.
+
+The pragmatic solution is to put the config header in a directory that
+has no other header files and then hide that from everyone else. One
+way is to create a top level subdirectory called `internal` and use
+that to build your own sources, like this:
+
+```meson
+subdir('internal') # create config.h in this subdir
+internal_inc = include_directories('internal')
+shared_library('foo', 'foo.c', include_directories : internal_inc)
+```
+
+Many projects keep their `config.h` in the top level directory that
+has no other source files in it. In that case you don't need to move
+it but can just do this instead:
+
+```meson
+internal_inc = include_directories('.') # At top level meson.build
+```
+
+## Make libraries buildable both as static and shared
+
+Some platforms (e.g. iOS) requires linking everything in your main app
+statically. In other cases you might want shared libraries. They are
+also faster during development due to Meson's relinking optimization.
+However building both library types on all builds is slow and
+wasteful.
+
+Your project should use the `library` method that can be toggled
+between shared and static with the `default_library` builtin option.
+
+
+```meson
+mylib = library('foo', 'foo.c')
+```
+
+## Declare generated headers explicitly
+
+Meson's Ninja backend works differently from Make and other
+systems. Rather than processing things directory per directory, it
+looks at the entire build definition at once and runs the individual
+compile jobs in what might look to the outside as a random order.
+
+The reason for this is that this is much more efficient so your builds
+finish faster. The downside is that you have to be careful with your
+dependencies. The most common problem here is headers that are
+generated at compile time with e.g. code generators. If these headers
+are needed when building code that uses these libraries, the compile
+job might be run before the code generation step. The fix is to make
+the dependency explicit like this:
+
+```meson
+myheader = custom_target(...)
+mylibrary = shared_library(...)
+mydep = declare_dependency(link_with : mylibrary,
+  include_directories : include_directories(...),
+  sources : myheader)
+```
+
+And then you can use the dependency in the usual way:
+
+```meson
+executable('dep_using_exe', 'main.c',
+  dependencies : mydep)
+```
+
+Meson will ensure that the header file has been built before compiling `main.c`.
+
+## Avoid exposing compilable source files in declare_dependency
+
+The main use for the `sources` argument in `declare_dependency` is to
+construct the correct dependency graph for the backends, as
+demonstrated in the previous section. It is extremely important to
+note that it should *not* be used to directly expose compilable
+sources (`.c`, `.cpp`, etc.) of dependencies, and should rather only
+be used for header/config files. The following example will illustrate
+what can go wrong if you accidentally expose compilable source files.
+
+So you've read about unity builds and how Meson natively supports
+them. You decide to expose the sources of dependencies in order to
+have unity builds that include their dependencies. For your support
+library you do
+
+```meson
+my_support_sources = files(...)
+
+mysupportlib = shared_library(
+  ...
+  sources : my_support_sources,
+  ...)
+mysupportlib_dep = declare_dependency(
+  ...
+  link_with : mylibrary,
+  sources : my_support_sources,
+  ...)
+```
+
+And for your main project you do:
+
+```meson
+mylibrary = shared_library(
+  ...
+  dependencies : mysupportlib_dep,
+  ...)
+myexe = executable(
+  ...
+  link_with : mylibrary,
+  dependencies : mysupportlib_dep,
+  ...)
+```
+
+This is extremely dangerous. When building, `mylibrary` will build and
+link the support sources `my_support_sources` into the resulting
+shared library. Then, for `myexe`, these same support sources will be
+compiled again, will be linked into the resulting executable, in
+addition to them being already present in `mylibrary`. This can
+quickly run afoul of the One Definition Rule
+(ODR)(https://en.wikipedia.org/wiki/One_Definition_Rule) in C++, as
+you have more than one definition of a symbol, yielding undefined
+behavior. While C does not have a strict ODR rule, there is no
+language in the standard which guarantees such behavior to work.
+Violations of the ODR can lead to weird idiosyncratic failures such as
+segfaults. In the overwhelming number of cases, exposing library
+sources via the `sources` argument in `declare_dependency` is thus
+incorrect. If you wish to get full cross-library performance, consider
+building `mysupportlib` as a static library instead and employing LTO.
+
+There are exceptions to this rule. If there are some natural
+constraints on how your library is to be used, you can expose sources.
+For instance, the WrapDB module for GoogleTest directly exposes the
+sources of GTest and GMock. This is valid, as GTest and GMock will
+only ever be used in *terminal* link targets. A terminal target is the
+final target in a dependency link chain, for instance `myexe` in the
+last example, whereas `mylibrary` is an intermediate link target. For
+most libraries this rule is not applicable though, as you cannot in
+general control how others consume your library, and as such should
+not expose sources.

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/Wrap-dependency-system-manual.md Added

@@ -0,0 +1,303 @@
+# Wrap dependency system manual
+
+One of the major problems of multiplatform development is wrangling
+all your dependencies. This is awkward on many platforms, especially
+on ones that do not have a built-in package manager. The latter problem
+has been worked around by having third party package managers. They
+are not really a solution for end user deployment, because you can't
+tell them to install a package manager just to use your app. On these
+platforms you must produce self-contained applications. Same applies
+when destination platform is missing (up-to-date versions of) your
+application's dependencies.
+
+The traditional approach to this has been to bundle dependencies
+inside your own project. Either as prebuilt libraries and headers or
+by embedding the source code inside your source tree and rewriting
+your build system to build them as part of your project.
+
+This is both tedious and error prone because it is always done by
+hand. The Wrap dependency system of Meson aims to provide an automated
+way to do this.
+
+## How it works
+
+Meson has a concept of subprojects(Subprojects.md). They are a way
+of nesting one Meson project inside another. Any project that builds
+with Meson can detect that it is built as a subproject and build
+itself in a way that makes it easy to use (usually this means as a
+static library).
+
+To use this kind of a project as a dependency you could just copy and
+extract it inside your project's `subprojects` directory.
+
+However there is a simpler way. You can specify a Wrap file that tells
+Meson how to download it for you. If you then use this subproject in
+your build, Meson will automatically download and extract it during
+build. This makes subproject embedding extremely easy.
+
+All wrap files must have a name of `<project_name>.wrap` form and be
+in `subprojects` dir.
+
+Currently Meson has four kinds of wraps:
+- wrap-file
+- wrap-git
+- wrap-hg
+- wrap-svn
+
+## wrap format
+
+Wrap files are written in ini format, with a single header containing
+the type of wrap, followed by properties describing how to obtain the
+sources, validate them, and modify them if needed. An example
+wrap-file for the wrap named `libfoobar` would have a filename
+`libfoobar.wrap` and would look like this:
+
+```ini
+wrap-file
+directory = libfoobar-1.0
+
+source_url = https://example.com/foobar-1.0.tar.gz
+source_filename = foobar-1.0.tar.gz
+source_hash = 5ebeea0dfb75d090ea0e7ff84799b2a7a1550db3fe61eb5f6f61c2e971e57663
+```
+
+An example wrap-git will look like this:
+
+```ini
+wrap-git
+url = https://github.com/libfoobar/libfoobar.git
+revision = head
+depth = 1
+```
+
+## Accepted configuration properties for wraps
+
+- `directory` - name of the subproject root directory, defaults to the
+  name of the wrap.
+
+Since *0.55.0* those can be used in all wrap types, they were
+previously reserved to `wrap-file`:
+
+- `patch_url` - download url to retrieve an optional overlay archive
+- `patch_fallback_url` - fallback URL to be used when download from `patch_url` fails *Since: 0.55.0*
+- `patch_filename` - filename of the downloaded overlay archive
+- `patch_hash` - sha256 checksum of the downloaded overlay archive
+- `patch_directory` - *Since 0.55.0* Overlay directory, alternative to `patch_filename` in the case
+  files are local instead of a downloaded archive. The directory must be placed in
+  `subprojects/packagefiles`.
+- `diff_files` - *Since 0.63.0* Comma-separated list of local diff files (see
+  Diff files(#diff-files) below).
+
+### Specific to wrap-file
+- `source_url` - download url to retrieve the wrap-file source archive
+- `source_fallback_url` - fallback URL to be used when download from `source_url` fails *Since: 0.55.0*
+- `source_filename` - filename of the downloaded source archive
+- `source_hash` - sha256 checksum of the downloaded source archive
+- `lead_directory_missing` - for `wrap-file` create the leading
+  directory name. Needed when the source file does not have a leading
+  directory.
+
+Since *0.55.0* it is possible to use only the `source_filename` and
+`patch_filename` value in a .wrap file (without `source_url` and
+`patch_url`) to specify a local archive in the
+`subprojects/packagefiles` directory. The `*_hash` entries are
+optional when using this method. This method should be preferred over
+the old `packagecache` approach described below.
+
+Since *0.49.0* if `source_filename` or `patch_filename` is found in the
+project's `subprojects/packagecache` directory, it will be used instead
+of downloading the file, even if `--wrap-mode` option is set to
+`nodownload`. The file's hash will be checked.
+
+### Specific to VCS-based wraps
+- `url` - name of the wrap-git repository to clone. Required.
+- `revision` - name of the revision to checkout. Must be either: a
+  valid value (such as a git tag) for the VCS's `checkout` command, or
+  (for git) `head` to track upstream's default branch. Required.
+
+### Specific to wrap-git
+- `depth` - shallowly clone the repository to X number of commits. This saves bandwidth and disk
+  space, and should typically always be specified unless commit history is needed. Note
+  that git always allow shallowly cloning branches, but in order to
+  clone commit ids shallowly, the server must support
+  `uploadpack.allowReachableSHA1InWant=true`.  *(since 0.52.0)*
+- `push-url` - alternative url to configure as a git push-url. Useful if
+  the subproject will be developed and changes pushed upstream.
+  *(since 0.37.0)*
+- `clone-recursive` - also clone submodules of the repository
+  *(since 0.48.0)*
+
+## wrap-file with Meson build patch
+
+Unfortunately most software projects in the world do not build with
+Meson. Because of this Meson allows you to specify a patch URL.
+
+For historic reasons this is called a "patch", however, it serves as an
+overlay to add or replace files rather than modifying them. The file
+must be an archive; it is downloaded and automatically extracted into
+the subproject. The extracted files will include a Meson build
+definition for the given subproject.
+
+This approach makes it extremely simple to embed dependencies that
+require build system changes. You can write the Meson build definition
+for the dependency in total isolation. This is a lot better than doing
+it inside your own source tree, especially if it contains hundreds of
+thousands of lines of code. Once you have a working build definition,
+just zip up the Meson build files (and others you have changed) and
+put them somewhere where you can download them.
+
+Prior to *0.55.0* Meson build patches were only supported for
+wrap-file mode. When using wrap-git, the repository must contain all
+Meson build definitions. Since *0.55.0* Meson build patches are
+supported for any wrap modes, including wrap-git.
+
+## Diff files
+
+*Since: 0.63.0*
+
+You can also provide local patch files in `diff` format. For historic reasons,
+they are referred to as "diff files", since the "patch" name is already used for
+overlay archives.
+
+The diff files are described by the `diff_files` property (a comma-separated
+list), and must be available locally in the `subprojects/packagefiles`
+directory.
+
+Meson will apply the diff files after extracting or cloning the project, and
+after applying the overlay archive (`patch_*`). For this feature, the `patch` or
+`git` command-line tool must be available.
+
+The diff files will be applied with `-p1`, i.e. treating the first path
+component as a prefix to be stripped. This is the default for diffs produced by
+Git.
+
+```ini
+wrap-file
+directory = libfoobar-1.0
+
+source_url = https://example.com/foobar-1.0.tar.gz
+source_filename = foobar-1.0.tar.gz
+source_hash = 5ebeea0dfb75d090ea0e7ff84799b2a7a1550db3fe61eb5f6f61c2e971e57663
+
+diff_files = libfoobar-1.0/0001.patch, libfoobar-1.0/0002.patch
+```
+
+## `provide` section
+
+*Since *0.55.0*
+
+Wrap files can define the dependencies it provides in the `provide`
+section.
+
+```ini
+provide
+dependency_names = foo-1.0
+```
+
+When a wrap file provides the dependency `foo-1.0`, as above, any call to
+`dependency('foo-1.0')` will automatically fallback to that subproject even if
+no `fallback` keyword argument is given. A wrap file named `foo.wrap` implicitly
+provides the dependency name `foo` even when the `provide` section is missing.
+
+Optional dependencies, like `dependency('foo-1.0', required: get_option('foo_opt'))`
+where `foo_opt` is a feature option set to `auto`, will not fallback to the
+subproject defined in the wrap file, for 2 reasons:
+- It allows for looking the dependency in other ways first, for example using
+  `cc.find_library('foo')`, and only fallback if that fails:
+
+```meson
+# this won't use fallback defined in foo.wrap
+foo_dep = dependency('foo-1.0', required: false)
+if not foo_dep.found()
+  foo_dep = cc.find_library('foo', has_headers: 'foo.h', required: false)
+  if not foo_dep.found()
+    # This will use the fallback
+    foo_dep = dependency('foo-1.0')
+    # or
+    foo_dep = dependency('foo-1.0', required: false, fallback: 'foo')
+  endif
+endif
+```
+
+- Sometimes not-found dependency is preferable to a fallback when the
+  feature is not explicitly requested by the user. In that case
+  `dependency('foo-1.0', required: get_option('foo_opt'))` will only
+  fallback when the user sets `foo_opt` to `enabled` instead of
+  `auto`.
+*Since 0.58.0* optional dependency like above will fallback to the subproject
+defined in the wrap file in the case `wrap_mode` is set to `forcefallback`
+or `force_fallback_for` contains the subproject.
+
+If it is desired to fallback for an optional dependency, the
+`fallback` or `allow_fallback` keyword arguments must be passed
+explicitly. *Since 0.56.0*, `dependency('foo-1.0', required:
+get_option('foo_opt'), allow_fallback: true)` will use the fallback
+even when `foo_opt` is set to `auto`. On version *0.55.0* the same
+effect could be achieved with `dependency('foo-1.0', required:
+get_option('foo_opt'), fallback: 'foo')`.
+
+This mechanism assumes the subproject calls
+`meson.override_dependency('foo-1.0', foo_dep)` so Meson knows which
+dependency object should be used as fallback. Since that method was
+introduced in version *0.54.0*, as a transitional aid for projects
+that do not yet make use of it the variable name can be provided in
+the wrap file with entries in the format `foo-1.0 = foo_dep`.
+
+For example when using a recent enough version of glib that uses
+`meson.override_dependency()` to override `glib-2.0`, `gobject-2.0`
+and `gio-2.0`, a wrap file would look like:
+
+```ini
+wrap-git
+url=https://gitlab.gnome.org/GNOME/glib.git
+revision=glib-2-62
+depth=1
+
+provide
+dependency_names = glib-2.0, gobject-2.0, gio-2.0
+```
+
+With older version of glib dependency variable names need to be
+specified:
+
+```ini
+wrap-git
+url=https://gitlab.gnome.org/GNOME/glib.git
+revision=glib-2-62
+depth=1
+
+provide
+glib-2.0=glib_dep
+gobject-2.0=gobject_dep
+gio-2.0=gio_dep
+```
+
+Programs can also be provided by wrap files, with the `program_names`
+key:
+
+```ini
+provide
+program_names = myprog, otherprog
+```
+
+With such wrap file, `find_program('myprog')` will automatically
+fallback to use the subproject, assuming it uses
+`meson.override_find_program('myprog')`.
+
+## Using wrapped projects
+
+Wraps provide a convenient way of obtaining a project into your
+subproject directory. Then you use it as a regular subproject (see
+subprojects(Subprojects.md)).
+
+## Getting wraps
+
+Usually you don't want to write your wraps by hand.
+
+There is an online repository called
+WrapDB(https://wrapdb.mesonbuild.com) that provides many
+dependencies ready to use. You can read more about WrapDB
+here(Using-the-WrapDB.md).
+
+There is also a Meson subcommand to get and manage wraps (see using
+wraptool(Using-wraptool.md)).

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/Wrapdb-projects.md Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/Yaml-RefMan.md Added

@@ -0,0 +1,201 @@
+---
+title: YAML Reference manual
+short-description: Editing and maintaining the Reference manual
+...
+
+# Reference Manual
+
+The Reference Manual(Reference-manual.md) is automatically generated out of YAML
+files in `docs/yaml`. This allows the Meson project to enforce a consistent
+style of the Reference Manual and enables easier style changes to the generated
+Markdown files without touching the actual documentation.
+Additionally, multiple generation backends can be supported (besides the
+Markdown generator for mesonbuild.com).
+
+The generator that reads these YAML files is located in `docs/refman`, with the
+main executable being `docs/genrefman.py`.  By default `genrefman.py` will load
+the yaml manual using a strict subset of yaml at the cost of loading slowly.
+You may optionally disable all these safety checks using the `fastyaml` loader,
+which will significantly speed things up at the cost of being less correct.
+
+The following python packages are required for the `genrefman` script:
+
+- chevron
+- strictyaml
+
+## Linking to the Reference Manual
+
+Links to the Reference Manual can be inserted *anywhere* in the Meson docs with
+tags like this: `<tag>`. This guarantees that links remain stable (even if
+the structure of the Reference Manual changes) and are uniformly formatted
+everywhere.
+
+To link to functions, the function name should be put into the tag:
+`<func name>`.
+Methods (for all kinds of objects, including modules) can be linked to like
+this: `<object name>.<method name>`.
+To link to objects themself, the `@<object name>` syntax can be used.
+
+These tags do **not** need to be put in inline code! A hotdoc extension handles
+the formatting here. If tags need to be placed (for instance, to include reference
+directly in code blocks), the `#<remaining tag>` syntax should be used.
+
+Examples:
+- Functions: executable
+- Methods: meson.version
+- Objects: @str
+
+Now the same in a code block:
+
+```meson
+#@str #executable('main', 
+    'file_@0@.cpp'.format(#meson.version)
+)
+```
+
+
+## Directory structure
+
+The directory structure under `docs/yaml` is important, since it determines how
+the YAML files are interpreted:
+
+- `builtins`: Documentation for builtin objects, such as `meson`
+- `elementary`: Strings, lists, integers, void, etc.
+- `objects`: All Objects returned by functions and methods but **not** modules
+- `functions`: All root meson functions (executable, project, etc.)
+
+Finally, modules are defined inside the `modules` subdirectory. Here, each
+module has its own directory. The module itself **must** be in a file called
+`module.yaml`. All objects returned by the module are then located next to this
+file.
+
+The name of the YAML files themself are ignored (with the exception of
+`module.yaml`) and carry no specific meaning. However, it is recommended to name
+the YAML files after the `name` entry of the object.
+
+All objects and functions whose name starts with a `_` are marked as private and
+are *not* exported in the final documents. The primary purpose of these files
+is to make inheriting functions and arguments easier.
+
+
+
+# YAML schema
+
+The YAML files themself are structured as follows:
+
+## Functions
+
+```yaml
+name: executable     # The name of the function                required
+returns: build_tgt   # Must be a `name` of an existing object  required
+description: |
+  The first line until the first dot of the description is the brief.
+  All other lines are not part of the brief and should document the function
+
+  Here the full Markdown syntax is supported, such as links, `inline code`,
+  code blocks, and references to other parts of the Reference Manual: @str.
+
+  This is true for **all** description keys in all YAML files. Defining a
+  description is **always** required.
+
+since:      0.42.0       # A valid Meson version
+deprecated: 100.99.0     # A valid Meson version
+
+example: |
+  Similar to `description`, but is put under a different section and should
+  contain an example.
+
+notes:
+- A list of notes that should stand out.
+- Should be used sparingly.
+- Notes are optional.
+
+warnings:
+- Similar to notes, but a warning
+- Warnings are also optional.
+
+
+# To avoid duplicating documentation / code, argument inheritance is supported with
+# the following optional keys:
+
+posargs_inherit: _build_target_base  # Use the posargs definition of `_build_target_base` here
+optargs_inherit: _build_target_base  # Use the optargs definition of `_build_target_base` here
+varargs_inherit: _build_target_base  # Use the varargs definition of `_build_target_base` here
+kwargs_inherit: _build_target_base   # Add all kwargs of `_build_target_base` to this function
+
+# Whether argument flattening (see Syntax.md) is enabled
+# for this function. Defaults to `true`.
+args_flattening: true
+
+posargs:
+  arg_name:
+    type: bool | dep           # required
+    description: Some text.    # required
+    since: 0.42.0
+    deprecated: 100.99.0
+    default: false             # Is technically supported buy should **not** be used for posargs
+
+  another_arg:
+    ...
+
+optargs:
+  optional_arg:
+    type: int                  # required
+    description: Hello World   # required
+    since: 0.42.0
+    deprecated: 100.99.0
+    default: false             # Default values can make sense here
+
+  next_arg:
+    ...
+
+varargs:
+  name: Some name                # required
+  type: str | liststr | int    # required
+  description: Some helpful text # required
+  since: 0.42.0
+  deprecated: 100.99.0
+  min_varargs: 1
+  max_varargs: 21
+
+
+kwargs:
+  kwarg_name:
+    type: str                      # required
+    description: Meson is great!   # required
+    since: 0.42.0
+    deprecated: 100.99.0
+    default: false
+    required: false                # Some kwargs may be required
+```
+
+
+## Objects
+
+```yaml
+name: build_tgt                       # required
+long_name: Build target               # required
+description: Just some description.   # required
+example: Same as for functions
+
+# Objects can be marked as containers. In this case they can be used in a `type`
+# like this `containerheld | objects`. Currently this only makes sense for
+# lists and dicts. There is almost no reason to set this to true for other objects.
+is_container: true
+
+since:      0.42.0
+deprecated: 100.99.0
+
+# Notes and warnings work the same as with functions
+notes:
+warnings:
+
+# Inheritance is also supported for objects. Here all methods from the parent
+# object are inherited. The trick with `_private` objects also works here
+# to help with more complex structures.
+extends: tgt
+
+# Methods are a list of functions (see the previous section).
+methods:
+- ...
+```

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/_Sidebar.md Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/_include_qt_base.md Added

@@ -0,0 +1,168 @@
+## compile_resources
+
+*New in 0.59.0*
+
+Compiles Qt's resources collection files (.qrc) into c++ files for compilation.
+
+It takes no positional arguments, and the following keyword arguments:
+  - `name` (string | empty): if provided a single .cpp file will be generated,
+    and the output of all qrc files will be combined in this file, otherwise
+    each qrc file be written to its own cpp file.
+  - `sources` (File | string | custom_target | custom_target index | generator_output):
+    A list of sources to be transpiled. Required, must have at least one source
+    *New in 0.60.0*: support for custom_target, custom_target_index, and generator_output.
+  - `extra_args` string: Extra arguments to pass directly to `qt-rcc`
+  - `method` string: The method to use to detect qt, see `dependency()` for more
+    information.
+
+## compile_ui
+
+*New in 0.59.0*
+
+Compiles Qt's ui files (.ui) into header files.
+
+It takes no positional arguments, and the following keyword arguments:
+  - `sources` (File | string | custom_target | custom_target index | generator_output):
+    A list of sources to be transpiled. Required, must have at least one source
+    *New in 0.60.0*: support for custom_target, custom_target_index, and generator_output.
+  - `extra_args` string: Extra arguments to pass directly to `qt-uic`
+  - `method` string: The method to use to detect qt, see `dependency()` for more
+    information.
+
+## compile_moc
+
+*New in 0.59.0*
+
+Compiles Qt's moc files (.moc) into header and/or source files. At least one of
+the keyword arguments `headers` and `sources` must be provided.
+
+It takes no positional arguments, and the following keyword arguments:
+  - `sources` (File | string | custom_target | custom_target index | generator_output):
+    A list of sources to be transpiled into .moc files for manual inclusion.
+    *New in 0.60.0*: support for custom_target, custom_target_index, and generator_output.
+  - `headers` (File | string | custom_target | custom_target index | generator_output):
+     A list of headers to be transpiled into .cpp files
+    *New in 0.60.0*: support for custom_target, custom_target_index, and generator_output.
+  - `extra_args` string: Extra arguments to pass directly to `qt-moc`
+  - `method` string: The method to use to detect qt, see `dependency()` for more
+    information.
+  - `dependencies`: dependency objects whose include directories are used by moc.
+  - `include_directories` (string | IncludeDirectory): A list of `include_directory()`
+    objects used when transpiling the .moc files
+
+## preprocess
+
+Consider using `compile_resources`, `compile_ui`, and `compile_moc` instead.
+
+Takes sources for moc, uic, and rcc, and converts them into c++ files for
+compilation.
+
+Has the following signature: `qt.preprocess(name: str | None, *sources: str)`
+
+If the `name` parameter is passed then all of the rcc files will be written to a single output file
+
+The variadic `sources` arguments have been deprecated since Meson 0.59.0, as has the `sources` keyword argument. These passed files unmodified through the preprocessor, don't do this, just add the output of the generator to another sources list:
+```meson
+sources = files('a.cpp', 'main.cpp', 'bar.c')
+sources += qt.preprocess(qresources : 'resources')
+```
+
+This method takes the following keyword arguments:
+ - `qresources` (string | File): Passed to the RCC compiler
+ - `ui_files`: (string | File | CustomTarget): Passed the `uic` compiler
+ - `moc_sources`: (string | File | CustomTarget): Passed the `moc` compiler. These are converted into .moc files meant to be `#include`ed
+ - `moc_headers`: (string | File | CustomTarget): Passied the `moc` compiler. These will be converted into .cpp files
+ - `include_directories` (IncludeDirectories | string), the directories to add to header search path for `moc`
+ - `moc_extra_arguments` string: any additional arguments to `moc`. Since v0.44.0.
+ - `uic_extra_arguments` string: any additional arguments to `uic`. Since v0.49.0.
+ - `rcc_extra_arguments` string: any additional arguments to `rcc`. Since v0.49.0.
+ - `dependencies` Dependency: dependency objects needed by moc. Available since v0.48.0.
+ - `sources`: a list of extra sources, which are added to the output unchanged. Deprecated in 0.59.0.
+
+It returns an array of targets and sources to pass to a compilation target.
+
+## compile_translations (since v0.44.0)
+
+This method generates the necessary targets to build translation files with
+lrelease, it takes no positional arguments, and the following keyword arguments:
+
+ - `ts_files` (File | string | custom_target | custom_target index | generator_output):
+    the list of input translation files produced by Qt's lupdate tool.
+    *New in 0.60.0*: support for custom_target, custom_target_index, and generator_output.
+ - `install` bool: when true, this target is installed during the install step (optional).
+ - `install_dir` string: directory to install to (optional).
+ - `build_by_default` bool: when set to true, to have this target be built by
+   default, that is, when invoking `meson compile`; the default value is false
+   (optional).
+ - `qresource` string: rcc source file to extract ts_files from; cannot be used
+   with ts_files kwarg. Available since v0.56.0.
+ - `rcc_extra_arguments` string: any additional arguments to `rcc` (optional),
+   when used with `qresource. Available since v0.56.0.
+
+Returns either: a list of custom targets for the compiled
+translations, or, if using a `qresource` file, a single custom target
+containing the processed source file, which should be passed to a main
+build target.
+
+## has_tools
+
+*since 0.54.0*
+
+This method returns `true` if all tools used by this module are found,
+`false` otherwise.
+
+It should be used to compile optional Qt code:
+```meson
+qt5 = import('qt5')
+if qt5.has_tools(required: get_option('qt_feature'))
+  moc_files = qt5.preprocess(...)
+  ...
+endif
+```
+
+This method takes the following keyword arguments:
+- `required` bool | FeatureOption: by default, `required` is set to `false`. If `required` is set to
+  `true` or an enabled `feature`(Build-options.md#features) and some tools are
+  missing Meson will abort.
+- `method` string: method used to find the Qt dependency (`auto` by default).
+
+## Dependencies
+
+See Qt dependencies(Dependencies.md#qt4-qt5)
+
+The 'modules' argument is used to include Qt modules in the project.
+See the Qt documentation for the list of
+modules(http://doc.qt.io/qt-5/qtmodules.html).
+
+The 'private_headers' argument allows usage of Qt's modules private
+headers. (since v0.47.0)
+
+## Example
+A simple example would look like this:
+
+```meson
+qt5 = import('qt5')
+qt5_dep = dependency('qt5', modules: 'Core', 'Gui')
+inc = include_directories('includes')
+moc_files = qt5.compile_moc(headers : 'myclass.h',
+                            extra_arguments: '-DMAKES_MY_MOC_HEADER_COMPILE',
+                            include_directories: inc,
+                            dependencies: qt5_dep)
+translations = qt5.compile_translations(ts_files : 'myTranslation_fr.ts', build_by_default : true)
+executable('myprog', 'main.cpp', 'myclass.cpp', moc_files,
+           include_directories: inc,
+           dependencies : qt5_dep)
+```
+
+Sometimes, translations are embedded inside the binary using qresource
+files. In this case the ts files do not need to be explicitly listed,
+but will be inferred from the built qm files listed in the qresource
+file. For example:
+
+```meson
+qt5 = import('qt5')
+qt5_dep = dependency('qt5', modules: 'Core', 'Gui')
+lang_cpp = qt5.compile_translations(qresource: 'lang.qrc')
+executable('myprog', 'main.cpp', lang_cpp,
+           dependencies: qt5_dep)
+```

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/howtox.md Added

@@ -0,0 +1,325 @@
+# How do I do X in Meson?
+
+This page lists code snippets for common tasks. These are written
+mostly using the C compiler, but the same approach should work on
+almost all other compilers.
+
+## Set compiler
+
+When first running Meson, set it in an environment variable.
+
+```console
+$ CC=mycc meson <options>
+```
+
+Note that environment variables like `CC` only refer to the host
+platform in cross builds.  That is, `CC` refers to the compiler used to
+compile programs that run on the machine we will eventually install the
+project on. The compiler used to build things that run on the machine we
+do the building can be specified with `CC_FOR_BUILD`. You can use it in
+cross builds.
+
+Note that environment variables are never the idiomatic way to do
+anything with Meson, however. It is better to use the native and cross
+files. And the tools for the host platform in cross builds can only be
+specified with a cross file.
+
+There is a table of all environment variables supported
+Here(Reference-tables.md#compiler-and-linker-selection-variables)
+
+
+## Set linker
+
+*New in 0.53.0*
+
+Like the compiler, the linker is selected via the `<compiler
+variable>_LD` environment variable, or through the `<compiler
+entry>_ld` entry in a native or cross file. You must be aware of
+whether you're using a compiler that invokes the linker itself (most
+compilers including GCC and Clang) or a linker that is invoked
+directly (when using MSVC or compilers that act like it, including
+Clang-Cl). With the former `c_ld` or `CC_LD` should be the value to
+pass to the compiler's special argument (such as `-fuse-ld` with clang
+and gcc), with the latter it should be an executable, such as
+`lld-link.exe`.
+
+*NOTE* In Meson 0.53.0 the `ld` entry in the cross/native file and the
+`LD` environment variable were used, this resulted in a large number
+of regressions and was changed in 0.53.1 to `<lang>_ld` and `<comp
+variable>_LD`.
+
+```console
+$ CC=clang CC_LD=lld meson <options>
+```
+
+or
+
+```console
+$ CC=clang-cl CC_LD=link meson <options>
+```
+
+or in a cross or native file:
+
+```ini
+binaries
+c = 'clang'
+c_ld = 'lld'
+```
+
+There is a table of all environment variables supported
+Here(Reference-tables.md#compiler-and-linker-selection-variables)
+
+
+## Set default C/C++ language version
+
+```meson
+project('myproj', 'c', 'cpp',
+        default_options : 'c_std=c11', 'cpp_std=c++11')
+```
+
+The language version can also be set on a per-target basis.
+
+```meson
+executable(..., override_options : 'c_std=c11')
+```
+
+## Enable threads
+
+Lots of people seem to do this manually with `cc.find_library('pthread')`
+or something similar. Do not do that. It is not portable. Instead do
+this.
+
+```meson
+thread_dep = dependency('threads')
+executable(..., dependencies : thread_dep)
+```
+
+## Set extra compiler and linker flags from the outside (when e.g. building distro packages)
+
+The behavior is the same as with other build systems, with environment
+variables during first invocation. Do not use these when you need to
+rebuild the source
+
+```console
+$ CFLAGS=-fsomething LDFLAGS=-Wl,--linker-flag meson <options>
+```
+
+## Use an argument only with a specific compiler
+
+First check which arguments to use.
+
+```meson
+if meson.get_compiler('c').get_id() == 'clang'
+  extra_args = '-fclang-flag'
+else
+  extra_args = 
+endif
+```
+
+Then use it in a target.
+
+```meson
+executable(..., c_args : extra_args)
+```
+
+If you want to use the arguments on all targets, then do this.
+
+```meson
+if meson.get_compiler('c').get_id() == 'clang'
+  add_global_arguments('-fclang-flag', language : 'c')
+endif
+```
+
+## Set a command's output to configuration
+
+```meson
+txt = run_command('script', 'argument', check: true).stdout().strip()
+cdata = configuration_data()
+cdata.set('SOMETHING', txt)
+configure_file(...)
+```
+
+## Generate configuration data from files
+
+The fs module(#Fs-modules) offers the `read` function which enables adding
+the contents of arbitrary files to configuration data (among other uses):
+
+```meson
+fs = import('fs')
+cdata = configuration_data()
+copyright = fs.read('LICENSE')
+cdata.set('COPYRIGHT', copyright)
+if build_machine.system() == 'linux'
+    os_release = fs.read('/etc/os-release')
+    cdata.set('LINUX_BUILDER', os_release)
+endif
+configure_file(...)
+```
+
+## Generate a runnable script with `configure_file`
+
+`configure_file` preserves metadata so if your template file has
+execute permissions, the generated file will have them too.
+
+## Producing a coverage report
+
+First initialize the build directory with this command.
+
+```console
+$ meson <other flags> -Db_coverage=true
+```
+
+Then issue the following commands.
+
+```console
+$ meson compile
+$ meson test
+$ meson compile coverage-html (or coverage-xml)
+```
+
+The coverage report can be found in the meson-logs subdirectory.
+
+*New in 0.55.0* llvm-cov support for use with clang
+
+## Add some optimization to debug builds
+
+By default the debug build does not use any optimizations. This is the
+desired approach most of the time. However some projects benefit from
+having some minor optimizations enabled. GCC even has a specific
+compiler flag `-Og` for this. To enable its use, just issue the
+following command.
+
+```console
+$ meson configure -Dc_args=-Og
+```
+
+This causes all subsequent builds to use this command line argument.
+
+## Use address sanitizer
+
+Clang comes with a selection of analysis tools such as the address
+sanitizer(https://clang.llvm.org/docs/AddressSanitizer.html). Meson
+has native support for these with the `b_sanitize` option.
+
+```console
+$ meson <other options> -Db_sanitize=address
+```
+
+After this you just compile your code and run the test suite. Address
+sanitizer will abort executables which have bugs so they show up as
+test failures.
+
+## Use Clang static analyzer
+
+Install scan-build program, then do this:
+
+```console
+$ meson setup builddir
+$ ninja -C builddir scan-build
+```
+
+You can use the `SCANBUILD` environment variable to choose the
+scan-build executable.
+
+```console
+$ SCANBUILD=<your exe> ninja -C builddir scan-build
+```
+
+You can use it for passing arguments to scan-build program by
+creating a script, for example:
+
+```sh
+#!/bin/sh
+scan-build -v --status-bugs "$@"
+```
+
+And then pass it through the variable (remember to use absolute path):
+
+```console
+$ SCANBUILD=$(pwd)/my-scan-build.sh ninja -C builddir scan-build
+```
+
+## Use profile guided optimization
+
+Using profile guided optimization with GCC is a two phase
+operation. First we set up the project with profile measurements
+enabled and compile it.
+
+```console
+$ meson setup <Meson options, such as --buildtype=debugoptimized> -Db_pgo=generate
+$ meson compile -C builddir
+```
+
+Then we need to run the program with some representative input. This
+step depends on your project.
+
+Once that is done we change the compiler flags to use the generated
+information and rebuild.
+
+```console
+$ meson configure -Db_pgo=use
+$ meson compile
+```
+
+After these steps the resulting binary is fully optimized.
+
+## Add math library (`-lm`) portably
+
+Some platforms (e.g. Linux) have a standalone math library. Other
+platforms (pretty much everyone else) do not. How to specify that `m`
+is used only when needed?
+
+```meson
+cc = meson.get_compiler('c')
+m_dep = cc.find_library('m', required : false)
+executable(..., dependencies : m_dep)
+```
+
+## Install an executable to `libexecdir`
+
+```meson
+executable(..., install : true, install_dir : get_option('libexecdir'))
+```
+
+## Use existing `Find<name>.cmake` files
+
+Meson can use the CMake `find_package()` ecosystem if CMake is
+installed. To find a dependency with custom `Find<name>.cmake`, set
+the `cmake_module_path` property to the path in your project where the
+CMake scripts are stored.
+
+Example for a `FindCmakeOnlyDep.cmake` in a `cmake` subdirectory:
+
+```meson
+cm_dep = dependency('CmakeOnlyDep', cmake_module_path : 'cmake')
+```
+
+The `cmake_module_path` property is only needed for custom CMake scripts. System
+wide CMake scripts are found automatically.
+
+More information can be found here(Dependencies.md#cmake)
+
+## Get a default not-found dependency?
+
+```meson
+null_dep = dependency('', required : false)
+```
+
+This can be used in cases where you want a default value, but might override it
+later.
+
+```meson
+# Not needed on Windows!
+my_dep = dependency('', required : false)
+if host_machine.system() in 'freebsd', 'netbsd', 'openbsd', 'dragonfly'
+  my_dep = dependency('some dep', required : false)
+elif host_machine.system() == 'linux'
+  my_dep = dependency('some other dep', required : false)
+endif
+
+executable(
+  'myexe',
+  my_sources,
+  deps : my_dep
+)
+```

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/i18n-module.md Added

@@ -0,0 +1,76 @@
+# I18n module
+
+This module provides internationalisation and localisation functionality.
+
+## Usage
+
+To use this module, just do: **`i18n = import('i18n')`**. The
+following functions will then be available as methods on the object
+with the name `i18n`. You can, of course, replace the name `i18n` with
+anything else.
+
+### i18n.gettext()
+
+Sets up gettext localisation so that translations are built and placed
+into their proper locations during install. Takes one positional
+argument which is the name of the gettext module.
+
+* `args`: list of extra arguments to pass to `xgettext` when
+  generating the pot file
+* `data_dirs`: (*Added 0.36.0*) list of directories to be set for
+  `GETTEXTDATADIRS` env var (Requires gettext 0.19.8+), used for local
+  its files
+* `languages`: list of languages that are to be generated. As of
+  0.37.0 this is optional and the
+  LINGUAS(https://www.gnu.org/software/gettext/manual/html_node/po_002fLINGUAS.html)
+  file is read.
+* `preset`: (*Added 0.37.0*) name of a preset list of arguments,
+  current option is `'glib'`, see
+  source(https://github.com/mesonbuild/meson/blob/master/mesonbuild/modules/i18n.py)
+  for for their value
+* `install`: (*Added 0.43.0*) if false, do not install the built translations.
+* `install_dir`: (*Added 0.50.0*) override default install location, default is `localedir`
+
+This function also defines targets for maintainers to use:
+**Note**: These output to the source directory
+
+* `<project_id>-pot`: runs `xgettext` to regenerate the pot file
+* `<project_id>-update-po`: regenerates the `.po` files from current `.pot` file
+* `<project_id>-gmo`: builds the translations without installing
+
+(*since 0.60.0*) Returns a list containing:
+* a list of built `.mo` files
+* the maintainer `-pot` target
+* the maintainer `-update-po` target
+
+### i18n.merge_file()
+
+This merges translations into a text file using `msgfmt`. See
+custom_target
+for normal keywords. In addition it accepts these keywords:
+
+* `output`: same as `custom_target` but only accepts one item
+* `install_dir`: same as `custom_target` but only accepts one item
+* `install_tag`: same as `custom_target` but only accepts one item
+* `data_dirs`: (*Added 0.41.0*) list of directories for its files (See
+  also `i18n.gettext()`)
+* `po_dir`: directory containing translations, relative to current directory
+* `type`: type of file, valid options are `'xml'` (default) and `'desktop'`
+* `args`: (*Added 0.51.0*) list of extra arguments to pass to `msgfmt`
+
+*Added 0.37.0*
+
+### i18n.itstool_join()
+
+This joins translations into a XML file using `itstool`. See
+custom_target
+for normal keywords. In addition it accepts these keywords:
+
+* `output`: same as `custom_target` but only accepts one item
+* `install_dir`: same as `custom_target` but only accepts one item
+* `install_tag`: same as `custom_target` but only accepts one item
+* `its_files`: filenames of ITS files that should be used explicitly
+  (XML translation rules are autodetected otherwise).
+* `mo_targets` *required*: mo file generation targets as returned by `i18n.gettext()`.
+
+*Added 0.62.0*

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/images Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/images/buildtime.png Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/images/conftime.png Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/images/emptytime.png Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/images/glib_build.png Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/images/glib_conf.png Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/images/glib_empty.png Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/images/glib_link.png Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/images/gtksample.png Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/images/linux_alldone.png Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/images/meson_mac1.png Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/images/meson_mac2.png Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/images/meson_mac3.png Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/images/meson_mac4.png Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/images/meson_mac5.png Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/images/osx_xcode.png Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/images/py3-install-1.png Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/images/py3-install-2.png Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/images/py3-install-3.png Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/images/sdltutorial_01.png Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/images/sdltutorial_02.png Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/images/sdltutorial_03.png Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/images/sdltutorial_04.png Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/images/sdltutorial_05.png Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/images/sdltutorial_06.png Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/images/sdltutorial_07.png Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/images/win_dlvs.png Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/images/win_downloadmeson.png Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/images/win_installvs.png Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/images/win_vstoolsprompt.png Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/images/win_working.png Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/index.md Added

@@ -0,0 +1,62 @@
+---
+render-subpages: false
+...
+
+# The Meson Build system
+
+## Overview
+
+Meson is an open source build system meant to be both extremely fast,
+and, even more importantly, as user friendly as possible.
+
+The main design point of Meson is that every moment a developer spends
+writing or debugging build definitions is a second wasted. So is every
+second spent waiting for the build system to actually start compiling
+code.
+
+## Features
+
+*   multiplatform support for Linux, macOS, Windows, GCC, Clang, Visual Studio and others
+*   supported languages include C, C++, D, Fortran, Java, Rust
+*   build definitions in a very readable and user friendly non-Turing complete DSL
+*   cross compilation for many operating systems as well as bare metal
+*   optimized for extremely fast full and incremental builds without sacrificing correctness
+*   built-in multiplatform dependency provider that works together with distro packages
+*   fun!
+
+## Quickstart for beginners
+
+Are you an absolute beginner when it comes to programming? No worries,
+read this beginner guide(SimpleStart.md) to get started.
+
+## Community
+
+The easiest way for most people to connect to other Meson developers is
+a web chat. The channel to use is `#mesonbuild` either via Matrix (web
+interface(https://app.element.io/#/room/#mesonbuild:matrix.org)) or
+OFTC IRC(https://www.oftc.net/).
+
+Other methods of communication include the mailing
+list(https://groups.google.com/forum/#!forum/mesonbuild) (hosted by
+Google Groups) and the
+Discussions(https://github.com/mesonbuild/meson/discussions) section
+of the Meson GitHub repository.
+
+### Projects using Meson(Users.md)
+
+Many projects are using Meson and they're
+a great resource for learning what to (and what not to!) do when
+converting existing projects to Meson.
+
+A short list of Meson users can be found here(Users.md)
+but there are many more. We would love to hear about your success
+stories too and how things could be improved too!
+
+## Development
+
+All development on Meson is done on the GitHub
+project(https://github.com/mesonbuild/meson). Instructions for
+contributing can be found on the contribution page(Contributing.md).
+
+
+You do not need to sign a CLA to contribute to Meson.

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/legal.md Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/snippets Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/snippets/add_release_note_snippets_here Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/markdown/snippets/clang_cl_c++20.md Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/meson.build Added

@@ -0,0 +1,128 @@
+project('Meson documentation', version: '1.0')
+
+cur_bdir = meson.current_build_dir()
+
+# Only the script knows which files are being generated
+docs_gen = custom_target(
+    'gen_docs',
+    input: files('markdown/index.md'),
+    output: 'gen_docs.stamp',
+    command: 
+        files('../tools/regenerate_docs.py'),
+        '--output-dir', cur_bdir,
+        '--dummy-output-file', '@OUTPUT@',
+    ,
+    build_by_default: true,
+    install: false)
+
+sitemap = files('sitemap.txt')
+
+genrefman = find_program('./genrefman.py')
+refman_binary = custom_target(
+    'gen_refman_bin',
+    input: sitemap,
+    output: 'reference_manual.bin',
+    depfile: 'reman_dep.d',
+    command: 
+        genrefman,
+        '-l', 'yaml',
+        '-g', 'pickle',
+        '-o', '@OUTPUT@',
+        '--depfile', '@DEPFILE@',
+        '--force-color',
+    
+)
+
+refman_md = custom_target(
+    'gen_refman_md',
+    input: refman_binary,
+    output: 'configured_sitemap.txt', 'refman_links.json',
+    command: 
+        genrefman,
+        '-l', 'pickle',
+        '-g', 'md',
+        '-s', sitemap,
+        '-i', '@INPUT@',
+        '-o', '@OUTPUT0@',
+        '--link-defs', '@OUTPUT1@',
+        '--force-color',
+        '--no-modules',
+    ,
+)
+sitemap = refman_md0
+
+refman_json = custom_target(
+    'gen_refman_json',
+    build_by_default: true,
+    input: refman_binary,
+    output: 'reference_manual.json',
+    command: 
+        genrefman,
+        '-l', 'pickle',
+        '-g', 'json',
+        '-i', '@INPUT@',
+        '-o', '@OUTPUT@',
+        '--force-color',
+    ,
+)
+
+refman_man = custom_target(
+    'gen_refman_man',
+    build_by_default: true,
+    input: refman_binary,
+    output: 'meson-reference.3',
+    command: 
+        genrefman,
+        '-l', 'pickle',
+        '-g', 'man',
+        '-i', '@INPUT@',
+        '-o', '@OUTPUT@',
+        '--force-color',
+        '--no-modules',
+    ,
+)
+
+genrelnotes = custom_target(
+    output: 'sitemap-genrelnotes.txt',
+    build_always_stale: true,
+    command: find_program('genrelnotes.py'),
+        '--input-sitemap', sitemap,
+        '--output-sitemap', '@OUTPUT0@',
+        '--output-dir', meson.current_build_dir(),
+        '--source-dir', meson.current_source_dir(),
+    
+)
+sitemap = genrelnotes0
+
+test('validate_docs', find_program('./jsonvalidator.py'), args: refman_json)
+
+hotdoc_prog = find_program('hotdoc', version: '>=0.13.7')
+
+hotdoc = import('hotdoc')
+documentation = hotdoc.generate_doc(meson.project_name(),
+    project_version: meson.project_version(),
+    sitemap: sitemap,
+    build_by_default: true,
+    depends: docs_gen,
+    index: 'markdown/index.md',
+    install: false,
+    extra_assets: 'images/',
+    include_paths: 'markdown', cur_bdir,
+    default_license: 'CC-BY-SAv4.0',
+    html_extra_theme: join_paths('theme', 'extra'),
+    git_upload_repository: 'git@github.com:mesonbuild/mesonbuild.github.io.git',
+    edit_on_github_repository: 'https://github.com/mesonbuild/meson',
+    syntax_highlighting_activate: true,
+    keep_markup_in_code_blocks: true,
+    extra_extension: meson.current_source_dir() / 'extensions' / 'refman_links.py',
+    refman_data_file: refman_md1,
+)
+
+run_target('upload',
+    command: hotdoc_prog, 'run',
+      '--conf-file', documentation.config_path(),
+      '--git-upload',
+      '-vv',
+    ,
+    depends: documentation,
+)

_service:tar_scm:meson-1.0.1.tar.gz/docs/refman Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/refman/__init__.py Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/refman/generatorbase.py Added

@@ -0,0 +1,76 @@
+# Copyright 2021 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.
+
+from abc import ABCMeta, abstractmethod
+import typing as T
+
+from .model import ReferenceManual, Function, Method, Object, ObjectType, NamedObject
+
+_N = T.TypeVar('_N', bound=NamedObject)
+
+class GeneratorBase(metaclass=ABCMeta):
+    def __init__(self, manual: ReferenceManual) -> None:
+        self.manual = manual
+
+    @abstractmethod
+    def generate(self) -> None:
+        pass
+
+    @staticmethod
+    def brief(raw: _N) -> str:
+        desc_lines = raw.description.split('\n')
+        brief = desc_lines0
+        if '.' in brief and '' not in brief:
+            brief = brief:brief.index('.')
+        return brief.strip()
+
+    @staticmethod
+    def sorted_and_filtered(raw: T.List_N) -> T.List_N:
+        def key_fn(fn: NamedObject) -> str:
+            if isinstance(fn, Method):
+                return f'1_{fn.obj.name}.{fn.name}'
+            return f'0_{fn.name}'
+        return sorted(x for x in raw if not x.hidden, key=key_fn)
+
+    @staticmethod
+    def _extract_meson_version() -> str:
+        from mesonbuild.coredata import version
+        return version
+
+    @property
+    def functions(self) -> T.ListFunction:
+        return GeneratorBase.sorted_and_filtered(self.manual.functions)
+
+    @property
+    def objects(self) -> T.ListObject:
+        return GeneratorBase.sorted_and_filtered(self.manual.objects)
+
+    @property
+    def elementary(self) -> T.ListObject:
+        return x for x in self.objects if x.obj_type == ObjectType.ELEMENTARY
+
+    @property
+    def builtins(self) -> T.ListObject:
+        return x for x in self.objects if x.obj_type == ObjectType.BUILTIN
+
+    @property
+    def returned(self) -> T.ListObject:
+        return x for x in self.objects if x.obj_type == ObjectType.RETURNED and x.defined_by_module is None
+
+    @property
+    def modules(self) -> T.ListObject:
+        return x for x in self.objects if x.obj_type == ObjectType.MODULE
+
+    def extract_returned_by_module(self, module: Object) -> T.ListObject:
+        return x for x in self.objects if x.obj_type == ObjectType.RETURNED and x.defined_by_module is module

_service:tar_scm:meson-1.0.1.tar.gz/docs/refman/generatorjson.py Added

@@ -0,0 +1,114 @@
+# SPDX-License-Identifer: Apache-2.0
+# Copyright 2021 The Meson development team
+
+from pathlib import Path
+import json
+import re
+
+from .generatorbase import GeneratorBase
+from . import jsonschema as J
+from .model import (
+    ReferenceManual,
+    Function,
+    Object,
+    Type,
+
+    PosArg,
+    VarArgs,
+    Kwarg,
+)
+
+import typing as T
+
+class GeneratorJSON(GeneratorBase):
+    def __init__(self, manual: ReferenceManual, out: Path, enable_modules: bool) -> None:
+        super().__init__(manual)
+        self.out = out
+        self.enable_modules = enable_modules
+
+    def _generate_type(self, typ: Type) -> T.ListJ.Type:
+        return 
+            {
+                'obj': x.data_type.name,
+                'holds': self._generate_type(x.holds) if x.holds else ,
+            }
+            for x in typ.resolved
+        
+
+    def _generate_type_str(self, typ: Type) -> str:
+        # Remove all whitespaces
+        return re.sub(r' \n\r\t', '', typ.raw)
+
+    def _generate_arg(self, arg: T.UnionPosArg, VarArgs, Kwarg, isOptarg: bool = False) -> J.Argument:
+        return {
+            'name': arg.name,
+            'description': arg.description,
+            'since': arg.since if arg.since else None,
+            'deprecated': arg.deprecated if arg.deprecated else None,
+            'type': self._generate_type(arg.type),
+            'type_str': self._generate_type_str(arg.type),
+            'required': arg.required if isinstance(arg, Kwarg) else not isOptarg and not isinstance(arg, VarArgs),
+            'default': arg.default if isinstance(arg, (PosArg, Kwarg)) else None,
+            'min_varargs': arg.min_varargs if isinstance(arg, VarArgs) and arg.min_varargs > 0 else None,
+            'max_varargs': arg.max_varargs if isinstance(arg, VarArgs) and arg.max_varargs > 0 else None,
+
+            # Not yet supported
+            'notes': ,
+            'warnings': ,
+        }
+
+    def _generate_function(self, func: Function) -> J.Function:
+        return {
+            'name': func.name,
+            'description': func.description,
+            'since': func.since if func.since else None,
+            'deprecated': func.deprecated if func.deprecated else None,
+            'notes': func.notes,
+            'warnings': func.warnings,
+            'example': func.example if func.example else None,
+            'returns': self._generate_type(func.returns),
+            'returns_str': self._generate_type_str(func.returns),
+            'posargs': {x.name: self._generate_arg(x) for x in func.posargs},
+            'optargs': {x.name: self._generate_arg(x, True) for x in func.optargs},
+            'kwargs': {x.name: self._generate_arg(x) for x in self.sorted_and_filtered(list(func.kwargs.values()))},
+            'varargs': self._generate_arg(func.varargs) if func.varargs else None,
+            'arg_flattening': func.arg_flattening,
+        }
+
+    def _generate_objects(self, obj: Object) -> J.Object:
+        return {
+            'name': obj.name,
+            'description': obj.description,
+            'since': obj.since if obj.since else None,
+            'deprecated': obj.deprecated if obj.deprecated else None,
+            'notes': obj.notes,
+            'warnings': obj.warnings,
+            'defined_by_module': obj.defined_by_module.name if obj.defined_by_module else None,
+            'object_type': obj.obj_type.name,
+            'is_container': obj.is_container,
+            'example': obj.example if obj.example else None,
+            'extends': obj.extends if obj.extends else None,
+            'returned_by': x.name for x in self.sorted_and_filtered(obj.returned_by),
+            'extended_by': x.name for x in self.sorted_and_filtered(obj.extended_by),
+            'methods': {x.name: self._generate_function(x) for x in self.sorted_and_filtered(obj.methods)},
+        }
+
+    def generate(self) -> None:
+        data: J.Root = {
+            'version_major': J.VERSION_MAJOR,
+            'version_minor': J.VERSION_MINOR,
+            'meson_version': self._extract_meson_version(),
+            'functions': {x.name: self._generate_function(x) for x in self.sorted_and_filtered(self.functions)},
+            'objects': {x.name: self._generate_objects(x) for x in self.sorted_and_filtered(self.objects)},
+            'objects_by_type': {
+                'elementary': x.name for x in self.elementary,
+                'builtins': x.name for x in self.builtins,
+                'returned': x.name for x in self.returned,
+                'modules': {
+                    x.name: y.name for y in self.sorted_and_filtered(self.extract_returned_by_module(x))
+                    for x in self.modules
+                },
+            },
+        }
+
+        self.out.write_text(json.dumps(data), encoding='utf-8')

_service:tar_scm:meson-1.0.1.tar.gz/docs/refman/generatorman.py Added

@@ -0,0 +1,382 @@
+import re
+from pathlib import Path
+
+from .generatorbase import GeneratorBase
+from .model import (
+    ReferenceManual,
+    Function,
+    Object,
+    PosArg,
+    VarArgs,
+    Kwarg,
+)
+
+import typing as T
+
+
+class ManPage:
+    def __init__(self, path: Path):
+        self.path = path
+        self.text = ""
+
+    def reset_font(self) -> None:
+        self.text += ".P\n"
+
+    def title(self, name: str, section: int) -> None:
+        import datetime
+
+        date = datetime.date.today()
+        self.reset_font()
+        self.text += f'.TH "{name}" "{section}" "{date}"\n'
+
+    def section(self, name: str) -> None:
+        self.reset_font()
+        self.text += f".SH {name}\n"
+
+    def subsection(self, name: str) -> None:
+        self.reset_font()
+        self.text += f".SS {name}\n"
+
+    def par(self, text: str) -> None:
+        self.reset_font()
+        self.text += f"{text}\n"
+
+    def indent(self, amount: int = 4) -> None:
+        self.text += f".RS {amount}\n"
+
+    def unindent(self) -> None:
+        self.text += ".RE\n"
+
+    def br(self) -> None:
+        self.text += ".br\n"
+
+    def nl(self) -> None:
+        self.text += "\n"
+
+    def line(self, text: str) -> None:
+        if text and text0 in ".", "'":
+            self.text += "\\"
+        self.text += f"{text}\n"
+
+    def inline(self, text: str) -> None:
+        self.text += f"{text}"
+
+    def write(self) -> None:
+        self.path.write_text(self.text, encoding="utf-8")
+
+    @staticmethod
+    def bold(text: str) -> str:
+        return f"\\fB{text}\\fR"
+
+    @staticmethod
+    def italic(text: str) -> str:
+        return f"\\fI{text}\\fR"
+
+
+class GeneratorMan(GeneratorBase):
+    def __init__(
+        self, manual: ReferenceManual, out: Path, enable_modules: bool
+    ) -> None:
+        super().__init__(manual)
+        self.out = out
+        self.enable_modules = enable_modules
+        self.links: T.Liststr = 
+
+    def generate_description(self, page: ManPage, desc: str) -> None:
+        def italicise(match: T.Matchstr) -> str:
+            v = match.group(1)
+            if v0 == "@":
+                v = v1:
+
+            return ManPage.italic(v)
+
+        desc = re.sub(re.compile(r"\$.*?)\\", re.DOTALL), italicise, desc)
+
+        def linkify(match: T.Matchstr) -> str:
+            replacement = ManPage.italic(match.group(1))
+
+            if match.group(2)0 != "#":
+                if match.group(2) in self.links:
+                    num = self.links.index(match.group(2))
+                else:
+                    self.links.append(match.group(2))
+                    num = len(self.links)
+
+                replacement += f"{num}"
+
+            return replacement
+
+        desc = re.sub(re.compile(r"\(.*?)\\((.*?)$", re.DOTALL), linkify, desc)
+
+        def bold(match: T.Matchstr) -> str:
+            return ManPage.bold(match.group(1))
+
+        desc = re.sub(re.compile(r"\*(.*?)\*"), bold, desc)
+
+        isCode = False
+        for chunk in desc.split("```"):
+            if isCode:
+                page.indent()
+                lines = chunk.strip().split("\n")
+                if lines0 == "meson":
+                    lines = lines1:
+
+                for line in lines:
+                    page.line(line)
+                    page.br()
+                page.unindent()
+            else:
+                inList = False
+                for line in chunk.strip().split("\n"):
+                    if len(line) == 0:
+                        page.nl()
+                        if inList:
+                            page.nl()
+                            inList = False
+                    elif line0:2 in "- ", "* ":
+                        if inList:
+                            page.nl()
+                            page.br()
+                        else:
+                            inList = True
+
+                        page.inline(line.strip() + " ")
+                    elif inList and line0 == " ":
+                        page.inline(line.strip() + " ")
+                    else:
+                        inList = False
+                        page.line(line)
+
+                if inList:
+                    page.nl()
+
+            isCode = not isCode
+
+    def function_name(self, f: Function, o: Object = None) -> str:
+        name = ""
+        if o is not None:
+            name += f"{o.name}."
+
+        name += f.name
+        return name
+
+    def generate_function_signature(
+        self, page: ManPage, f: Function, o: Object = None
+    ) -> None:
+        args = 
+
+        if f.posargs:
+            args += arg.name for arg in f.posargs
+
+        if f.varargs:
+            args += f.varargs.name + "..."
+
+        if f.optargs:
+            args += f"{arg.name}" for arg in f.optargs
+
+        for kwarg in self.sorted_and_filtered(list(f.kwargs.values())):
+            kw = kwarg.name + ":"
+            if kwarg.default:
+                kw += " " + ManPage.bold(kwarg.default)
+            args += kw
+
+        ret = ManPage.italic(f.returns.raw) + " "
+
+        prefix = f"{ret}{self.function_name(f, o)}("
+        sig = ", ".join(args)
+        suffix = ")"
+
+        if len(prefix) + len(sig) + len(suffix) > 70:
+            page.line(prefix)
+            page.br()
+            page.indent()
+            for arg in args:
+                page.line(arg + ",")
+                page.br()
+            page.unindent()
+            page.line(suffix)
+        else:
+            page.line(prefix + sig + suffix)
+
+    def base_info(
+        self, x: T.UnionPosArg, VarArgs, Kwarg, Function, Object
+    ) -> T.Liststr:
+        info = 
+        if x.deprecated:
+            info += ManPage.bold("deprecated") + f" since {x.deprecated}"
+        if x.since:
+            info += f"since {x.since}"
+
+        return info
+
+    def generate_function_arg(
+        self,
+        page: ManPage,
+        arg: T.UnionPosArg, VarArgs, Kwarg,
+        isOptarg: bool = False,
+    ) -> None:
+        required = (
+            arg.required
+            if isinstance(arg, Kwarg)
+            else not isOptarg and not isinstance(arg, VarArgs)
+        )
+
+        page.line(ManPage.bold(arg.name))
+
+        info = ManPage.italic(arg.type.raw)
+
+        if required:
+            info += ManPage.bold("required")
+        if isinstance(arg, (PosArg, Kwarg)) and arg.default:
+            info += f"default: {arg.default}"
+        if isinstance(arg, VarArgs):
+            mn = 0 if arg.min_varargs < 0 else arg.min_varargs
+            mx = "N" if arg.max_varargs < 0 else arg.max_varargs
+            info += f"{mn}...{mx} times"
+
+        info += self.base_info(arg)
+
+        page.line(", ".join(info))
+
+        page.br()
+        page.indent(2)
+        self.generate_description(page, arg.description.strip())
+        page.unindent()
+        page.nl()
+
+    def generate_function_argument_section(
+        self,
+        page: ManPage,
+        name: str,
+        args: T.SequenceT.UnionPosArg, VarArgs, Kwarg,
+        isOptarg: bool = False,
+    ) -> None:
+        if not args:
+            return
+
+        page.line(ManPage.bold(name))
+        page.indent()
+        for arg in args:
+            self.generate_function_arg(page, arg, isOptarg)
+        page.unindent()
+
+    def generate_sub_sub_section(
+        self, page: ManPage, name: str, text: T.Liststr, process: bool = True
+    ) -> None:
+        page.line(ManPage.bold(name))
+        page.indent()
+        if process:
+            for line in text:
+                self.generate_description(page, line.strip())
+        else:
+            page.line("\n\n".join(line.strip() for line in text))
+        page.unindent()
+
+    def generate_function(self, page: ManPage, f: Function, obj: Object = None) -> None:
+        page.subsection(self.function_name(f, obj) + "()")
+        page.indent(0)
+
+        page.line(ManPage.bold("SYNOPSIS"))
+        page.indent()
+        self.generate_function_signature(page, f, obj)
+
+        info = self.base_info(f)
+        if info:
+            page.nl()
+            page.line(", ".join(info))
+        page.unindent()
+        page.nl()
+
+        self.generate_sub_sub_section(page, "DESCRIPTION", f.description)
+        page.nl()
+
+        self.generate_function_argument_section(page, "POSARGS", f.posargs)
+        if f.varargs:
+            self.generate_function_argument_section(page, "VARARGS", f.varargs)
+        self.generate_function_argument_section(page, "OPTARGS", f.optargs, True)
+        self.generate_function_argument_section(
+            page, "KWARGS", self.sorted_and_filtered(list(f.kwargs.values()))
+        )
+
+        if f.notes:
+            self.generate_sub_sub_section(page, "NOTES", f.notes)
+        if f.warnings:
+            self.generate_sub_sub_section(page, "WARNINGS", f.warnings)
+        if f.example:
+            self.generate_sub_sub_section(page, "EXAMPLE", f.example)
+
+        page.unindent()
+
+    def generate_object(self, page: ManPage, obj: Object) -> None:
+        page.subsection(obj.name)
+        page.indent(2)
+
+        info = self.base_info(obj)
+        if info:
+            page.line(", ".join(info))
+            page.br()
+
+        if obj.extends:
+            page.line(ManPage.bold("extends: ") + obj.extends)
+            page.br()
+
+        ret = x.name for x in self.sorted_and_filtered(obj.returned_by)
+        if ret:
+            page.line(ManPage.bold("returned_by: ") + ", ".join(ret))
+            page.br()
+
+        ext = x.name for x in self.sorted_and_filtered(obj.extended_by)
+        if ext:
+            page.line(ManPage.bold("extended_by: ") + ", ".join(ext))
+            page.br()
+
+        page.nl()
+
+        self.generate_description(page, obj.description.strip())
+        page.nl()
+
+        if obj.notes:
+            self.generate_sub_sub_section(page, "NOTES", obj.notes)
+        if obj.warnings:
+            self.generate_sub_sub_section(page, "WARNINGS", obj.warnings)
+        if obj.example:
+            self.generate_sub_sub_section(page, "EXAMPLE", obj.example)
+
+        page.unindent()
+
+    def generate(self) -> None:
+        page = ManPage(self.out)
+
+        page.title("meson-reference", 3)
+
+        page.section("NAME")
+        page.par(
+            f"meson-reference v{self._extract_meson_version()}"
+            + " - a reference for meson functions and objects"
+        )
+
+        page.section("DESCRIPTION")
+        self.generate_description(
+            page,
+            """This manual is divided into two sections, *FUNCTIONS* and *OBJECTS*.  *FUNCTIONS* contains a reference for all meson functions and methods.  Methods are denoted by object_name.method_name().  *OBJECTS* contains additional information about each object.""",
+        )
+
+        page.section("FUNCTIONS")
+        for f in self.sorted_and_filtered(self.functions):
+            self.generate_function(page, f)
+
+        for obj in self.sorted_and_filtered(self.objects):
+            for f in self.sorted_and_filtered(obj.methods):
+                self.generate_function(page, f, obj)
+
+        page.section("OBJECTS")
+        for obj in self.sorted_and_filtered(self.objects):
+            self.generate_object(page, obj)
+
+        page.section("SEE ALSO")
+        for i in range(len(self.links)):
+            link = self.linksi
+            page.line(f"{i + 1} {link}")
+            page.br()
+
+        page.write()

_service:tar_scm:meson-1.0.1.tar.gz/docs/refman/generatormd.py Added

@@ -0,0 +1,393 @@
+# Copyright 2021 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.
+
+from .generatorbase import GeneratorBase
+import re
+import json
+
+from .model import (
+    ReferenceManual,
+    Function,
+    Method,
+    Object,
+    ObjectType,
+    Type,
+    DataTypeInfo,
+    ArgBase,
+    PosArg,
+    VarArgs,
+    Kwarg,
+)
+
+from pathlib import Path
+from textwrap import dedent
+import typing as T
+
+from mesonbuild import mlog
+
+PlaceholderTypes = T.UnionNone, str, bool
+FunctionDictType = T.Dict
+    str,
+    T.Union
+        PlaceholderTypes,
+        T.Dictstr, PlaceholderTypes,
+        T.Dictstr, T.Dictstr, PlaceholderTypes,
+        T.Dictstr, T.ListT.Dictstr, PlaceholderTypes,
+        T.ListT.Dictstr, PlaceholderTypes,
+        T.Liststr,
+    
+
+
+_ROOT_BASENAME = 'Reference-manual'
+
+_OBJ_ID_MAP = {
+    ObjectType.ELEMENTARY: 'elementary',
+    ObjectType.BUILTIN: 'builtin',
+    ObjectType.MODULE: 'module',
+    ObjectType.RETURNED: 'returned',
+}
+
+# Indent all but the first line with 4*depth spaces.
+# This function is designed to be used with `dedent`
+# and fstrings where multiline strings are used during
+# the string interpolation.
+def smart_indent(raw: str, depth: int = 3) -> str:
+    lines = raw.split('\n')
+    first_line = lines0
+    lines = ' ' * (4 * depth) + x for x in lines
+    lines0 = first_line  # Do not indent the first line
+    return '\n'.join(lines)
+
+def code_block(code: str) -> str:
+    code = dedent(code)
+    return f'<pre><code class="language-meson">{code}</code></pre>'
+
+class GeneratorMD(GeneratorBase):
+    def __init__(self, manual: ReferenceManual, sitemap_out: Path, sitemap_in: Path, link_def_out: Path, enable_modules: bool) -> None:
+        super().__init__(manual)
+        self.sitemap_out = sitemap_out.resolve()
+        self.sitemap_in = sitemap_in.resolve()
+        self.link_def_out = link_def_out.resolve()
+        self.out_dir = self.sitemap_out.parent
+        self.enable_modules = enable_modules
+        self.generated_files: T.Dictstr, str = {}
+
+    # Utility functions
+    def _gen_filename(self, file_id: str, *, extension: str = 'md') -> str:
+        parts = file_id.split('.')
+        assert parts0 == 'root'
+        assert all(x for x in parts)
+        parts0 = _ROOT_BASENAME
+        parts = re.sub(r'0-9+_', '', x) for x in parts
+        return f'{"_".join(parts)}.{extension}'
+
+    def _gen_object_file_id(self, obj: Object) -> str:
+        '''
+            Deterministically generate a unique file ID for the Object.
+
+            This ID determines where the object will be inserted in the sitemap.
+        '''
+        if obj.obj_type == ObjectType.RETURNED and obj.defined_by_module is not None:
+            base = self._gen_object_file_id(obj.defined_by_module)
+            return f'{base}.{obj.name}'
+        return f'root.{_OBJ_ID_MAPobj.obj_type}.{obj.name}'
+
+    def _link_to_object(self, obj: T.UnionFunction, Object, in_code_block: bool = False) -> str:
+        '''
+            Generate a palaceholder tag for the the function/method/object documentation.
+            This tag is then replaced in the custom hotdoc plugin.
+        '''
+        prefix = '#' if in_code_block else ''
+        if isinstance(obj, Object):
+            return f'{prefix}@{obj.name}'
+        elif isinstance(obj, Method):
+            return f'{prefix}{obj.obj.name}.{obj.name}'
+        elif isinstance(obj, Function):
+            return f'{prefix}{obj.name}'
+        else:
+            raise RuntimeError(f'Invalid argument {obj}')
+
+    def _write_file(self, data: str, file_id: str) -> None:#
+        ''' Write the data to disk and store the id for the generated data '''
+
+        self.generated_filesfile_id = self._gen_filename(file_id)
+        out_file = self.out_dir / self.generated_filesfile_id
+        out_file.write_text(data, encoding='ascii')
+        mlog.log('Generated', mlog.bold(out_file.name))
+
+    def _write_template(self, data: T.Dictstr, T.Any, file_id: str, template_name: T.Optionalstr = None) -> None:
+        ''' Render the template mustache files and write the result '''
+        template_dir = Path(__file__).resolve().parent / 'templates'
+        template_name = template_name or file_id
+        template_name = f'{template_name}.mustache'
+        template_file = template_dir / template_name
+
+        # Import here, so that other generators don't also depend on it
+        import chevron
+        result = chevron.render(
+            template=template_file.read_text(encoding='utf-8'),
+            data=data,
+            partials_path=template_dir.as_posix(),
+            warn=True,
+        )
+
+        self._write_file(result, file_id)
+
+
+    # Actual generator functions
+    def _gen_func_or_method(self, func: Function) -> FunctionDictType:
+        def render_type(typ: Type, in_code_block: bool = False) -> str:
+            def data_type_to_str(dt: DataTypeInfo) -> str:
+                base = self._link_to_object(dt.data_type, in_code_block)
+                if dt.holds:
+                    return f'{base}{render_type(dt.holds, in_code_block)}'
+                return base
+            assert typ.resolved
+            return ' | '.join(data_type_to_str(x) for x in typ.resolved)
+
+        def len_stripped(s: str) -> int:
+            s = s.replace('', '')
+            # I know, this regex is ugly but it works.
+            return len(re.sub(r'\$#|@)*(^$', r'\2', s))
+
+        def render_signature() -> str:
+            # Skip a lot of computations if the function does not take any arguments
+            if not any(func.posargs, func.optargs, func.kwargs, func.varargs):
+                return f'{render_type(func.returns, True)} {func.name}()'
+
+            signature = dedent(f'''\
+                # {self.brief(func)}
+                {render_type(func.returns, True)} {func.name}(
+            ''')
+
+            # Calculate maximum lengths of the type and name
+            all_args: T.ListArgBase = 
+            all_args += func.posargs
+            all_args += func.optargs
+            all_args += func.varargs if func.varargs else 
+
+            max_type_len = 0
+            max_name_len = 0
+            if all_args:
+                max_type_len = max(len_stripped(render_type(x.type)) for x in all_args)
+                max_name_len = max(len(x.name) for x in all_args)
+
+            # Generate some common strings
+            def prepare(arg: ArgBase) -> T.Tuplestr, str, str, str:
+                type_str = render_type(arg.type, True)
+                type_len = len_stripped(type_str)
+                type_space = ' ' * (max_type_len - type_len)
+                name_space = ' ' * (max_name_len - len(arg.name))
+                name_str = f'<b>{arg.name.replace("<", "&lt;").replace(">", "&gt;")}</b>'
+                return type_str, type_space, name_str, name_space
+
+            for i in func.posargs:
+                type_str, type_space, name_str, name_space = prepare(i)
+                signature += f'  {type_str}{type_space} {name_str},{name_space}     # {self.brief(i)}\n'
+
+            for i in func.optargs:
+                type_str, type_space, name_str, name_space = prepare(i)
+                signature += f'  {type_str}{type_space} {name_str},{name_space}   # {self.brief(i)}\n'
+
+            if func.varargs:
+                type_str, type_space, name_str, name_space = prepare(func.varargs)
+                signature += f'  {type_str}{type_space} {name_str}...,{name_space}  # {self.brief(func.varargs)}\n'
+
+            # Abort if there are no kwargs
+            if not func.kwargs:
+                return signature + ')'
+
+            # Only add this separator if there are any posargs
+            if all_args:
+                signature += '\n  # Keyword arguments:\n'
+
+            # Recalculate lengths for kwargs
+            all_args = list(func.kwargs.values())
+            max_type_len = max(len_stripped(render_type(x.type)) for x in all_args)
+            max_name_len = max(len(x.name) for x in all_args)
+
+            for kwarg in self.sorted_and_filtered(list(func.kwargs.values())):
+                type_str, type_space, name_str, name_space = prepare(kwarg)
+                required = ' <i>required</i> ' if kwarg.required else '            '
+                required = required if any(x.required for x in func.kwargs.values()) else ''
+                signature += f'  {name_str}{name_space} : {type_str}{type_space} {required} # {self.brief(kwarg)}\n'
+
+            return signature + ')'
+
+        def gen_arg_data(arg: T.UnionPosArg, Kwarg, VarArgs, *, optional: bool = False) -> T.Dictstr, PlaceholderTypes:
+            data: T.Dictstr, PlaceholderTypes = {
+                'name': arg.name,
+                'type': render_type(arg.type),
+                'description': arg.description,
+                'since': arg.since or None,
+                'deprecated': arg.deprecated or None,
+                'optional': optional,
+                'default': None,
+            }
+
+            if isinstance(arg, VarArgs):
+                data.update({
+                    'min': str(arg.min_varargs) if arg.min_varargs > 0 else '0',
+                    'max': str(arg.max_varargs) if arg.max_varargs > 0 else 'infinity',
+                })
+            if isinstance(arg, (Kwarg, PosArg)):
+                data.update({'default': arg.default or None})
+            if isinstance(arg, Kwarg):
+                data.update({'required': arg.required})
+            return data
+
+        mname = f'\\{func.name}' if func.name == 'index' else func.name
+
+        data: FunctionDictType = {
+            'name': f'{func.obj.name}.{mname}' if isinstance(func, Method) else func.name,
+            'base_level': '##' if isinstance(func, Method) else '#',
+            'type_name_upper': 'Method' if isinstance(func, Method) else 'Function',
+            'type_name': 'method' if isinstance(func, Method) else 'function',
+            'description': func.description,
+            'notes': func.notes,
+            'warnings': func.warnings,
+            'example': func.example or None,
+            'signature_level': 'h4' if isinstance(func, Method) else 'h3',
+            'signature': render_signature(),
+            'has_args': bool(func.posargs or func.optargs or func.kwargs or func.varargs),
+            # Merge posargs and optargs by generating the *optional* tag for optargs
+            'posargs': {
+                'args': gen_arg_data(x) for x in func.posargs + gen_arg_data(x, optional=True) for x in func.optargs
+            } if func.posargs or func.optargs else None,
+            'kwargs':  {'args': gen_arg_data(x) for x in self.sorted_and_filtered(list(func.kwargs.values()))} if func.kwargs else None,
+            'varargs': gen_arg_data(func.varargs) if func.varargs else None,
+            'arg_flattening': func.arg_flattening,
+
+            # For the feature taggs template
+            'since': func.since or None,
+            'deprecated': func.deprecated or None,
+            'optional': False,
+            'default': None
+        }
+
+        return data
+
+    def _write_object(self, obj: Object) -> None:
+        data = {
+            'name': obj.name,
+            'description': obj.description,
+            'notes': obj.notes,
+            'warnings': obj.warnings,
+            'long_name': obj.long_name,
+            'obj_type_name': _OBJ_ID_MAPobj.obj_type.capitalize(),
+            'example': obj.example or None,
+            'has_methods': bool(obj.methods),
+            'has_inherited_methods': bool(obj.inherited_methods),
+            'has_subclasses': bool(obj.extended_by),
+            'is_returned': bool(obj.returned_by),
+            'extends': obj.extends_obj.name if obj.extends_obj else None,
+            'returned_by': self._link_to_object(x) for x in self.sorted_and_filtered(obj.returned_by),
+            'extended_by': self._link_to_object(x) for x in self.sorted_and_filtered(obj.extended_by),
+            'methods': self._gen_func_or_method(m) for m in self.sorted_and_filtered(obj.methods),
+            'inherited_methods': self._gen_func_or_method(m) for m in self.sorted_and_filtered(obj.inherited_methods),
+        }
+
+        self._write_template(data, self._gen_object_file_id(obj), 'object')
+
+    def _write_functions(self) -> None:
+        data = {'functions': self._gen_func_or_method(x) for x in self.functions}
+        self._write_template(data, 'root.functions')
+
+    def _root_refman_docs(self) -> None:
+        def gen_obj_links(objs: T.ListObject) -> T.ListT.Dictstr, str:
+            ret: T.ListT.Dictstr, str = 
+            for o in objs:
+                ret += {'indent': '', 'link': self._link_to_object(o), 'brief': self.brief(o)}
+                for m in self.sorted_and_filtered(o.methods):
+                    ret += {'indent': '  ', 'link': self._link_to_object(m), 'brief': self.brief(m)}
+                if o.obj_type == ObjectType.MODULE and self.extract_returned_by_module(o):
+                    tmp = gen_obj_links(self.extract_returned_by_module(o))
+                    tmp = {**x, 'indent': '  ' + x'indent'} for x in tmp
+                    ret += {'indent': '  ', 'link': '**New objects:**', 'brief': ''}
+                    ret += *tmp
+            return ret
+
+        data = {
+            'root': self._gen_filename('root'),
+            'elementary': gen_obj_links(self.elementary),
+            'returned': gen_obj_links(self.returned),
+            'builtins': gen_obj_links(self.builtins),
+            'modules': gen_obj_links(self.modules),
+            'functions': {'indent': '', 'link': self._link_to_object(x), 'brief': self.brief(x)} for x in self.functions,
+            'enable_modules': self.enable_modules,
+        }
+
+        dummy = {'root': self._gen_filename('root')}
+
+        self._write_template(data, 'root')
+        self._write_template({**dummy, 'name': 'Elementary types'}, f'root.{_OBJ_ID_MAPObjectType.ELEMENTARY}', 'dummy')
+        self._write_template({**dummy, 'name': 'Builtin objects'},  f'root.{_OBJ_ID_MAPObjectType.BUILTIN}',    'dummy')
+        self._write_template({**dummy, 'name': 'Returned objects'}, f'root.{_OBJ_ID_MAPObjectType.RETURNED}',   'dummy')
+
+        if self.enable_modules:
+            self._write_template({**dummy, 'name': 'Modules'},          f'root.{_OBJ_ID_MAPObjectType.MODULE}',     'dummy')
+
+
+    def generate(self) -> None:
+        mlog.log('Generating markdown files...')
+        with mlog.nested():
+            self._write_functions()
+            for obj in self.objects:
+                if not self.enable_modules and (obj.obj_type == ObjectType.MODULE or obj.defined_by_module is not None):
+                    continue
+                self._write_object(obj)
+            self._root_refman_docs()
+            self._configure_sitemap()
+            self._generate_link_def()
+
+    def _configure_sitemap(self) -> None:
+        '''
+            Replaces the `@REFMAN_PLACEHOLDER@` placeholder with the reference
+            manual sitemap. The structure of the sitemap is derived from the
+            file IDs.
+        '''
+        raw = self.sitemap_in.read_text(encoding='utf-8')
+        out = ''
+        for l in raw.split('\n'):
+            if '@REFMAN_PLACEHOLDER@' not in l:
+                out += f'{l}\n'
+                continue
+            mlog.log('Generating', mlog.bold(self.sitemap_out.as_posix()))
+            base_indent = l.replace('@REFMAN_PLACEHOLDER@', '')
+            for k in sorted(self.generated_files.keys()):
+                indent = base_indent + '\t' * k.count('.')
+                out += f'{indent}{self.generated_filesk}\n'
+        self.sitemap_out.write_text(out, encoding='utf-8')
+
+    def _generate_link_def(self) -> None:
+        '''
+            Generate the link definition file for the refman_links hotdoc
+            plugin. The plugin is then responsible for replacing the tag
+            tags with custom HTML elements.
+        '''
+        data: T.Dictstr, str = {}
+
+        # Objects and methods
+        for obj in self.objects:
+            obj_file = self._gen_filename(self._gen_object_file_id(obj), extension='html')
+            dataf'@{obj.name}' = obj_file
+            for m in obj.methods:
+                dataf'{obj.name}.{m.name}' = f'{obj_file}#{obj.name}{m.name}'
+
+        # Functions
+        funcs_file = self._gen_filename('root.functions', extension='html')
+        for fn in self.functions:
+            datafn.name = f'{funcs_file}#{fn.name}'
+
+        self.link_def_out.write_text(json.dumps(data, indent=2), encoding='utf-8')

_service:tar_scm:meson-1.0.1.tar.gz/docs/refman/generatorpickle.py Added

@@ -0,0 +1,26 @@
+# Copyright 2021 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 pickle
+from pathlib import Path
+from .generatorbase import GeneratorBase
+from .model import ReferenceManual
+
+class GeneratorPickle(GeneratorBase):
+    def __init__(self, manual: ReferenceManual, outpath: Path) -> None:
+        self.out = outpath
+        super().__init__(manual)
+
+    def generate(self) -> None:
+        self.out.write_bytes(pickle.dumps(self.manual))

_service:tar_scm:meson-1.0.1.tar.gz/docs/refman/generatorprint.py Added

@@ -0,0 +1,87 @@
+# Copyright 2021 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.
+
+from .generatorbase import GeneratorBase
+from .model import ReferenceManual, Object, Function, DataTypeInfo, Type, ObjectType
+
+from mesonbuild import mlog
+import typing as T
+
+def my_nested() -> T.ContextManagerNone:
+    prefix = '|' * len(mlog.log_depth)
+    return mlog.nested(prefix)
+
+class GeneratorPrint(GeneratorBase):
+    def _types_to_string(self, typ: Type) -> str:
+        def _data_type_to_str(dt: DataTypeInfo) -> str:
+            if dt.holds:
+                return f'{dt.data_type.name}{self._types_to_string(dt.holds)}'
+            return dt.data_type.name
+        return ' | '.join(_data_type_to_str(x) for x in typ.resolved)
+
+    def _generate_function(self, func: Function) -> None:
+        mlog.log()
+        mlog.log('Function', mlog.bold(func.name))
+        with my_nested():
+            desc = func.description
+            if '\n' in desc:
+                desc = desc:desc.index('\n')
+            mlog.log('Description:', mlog.bold(desc))
+            mlog.log('Return type:', mlog.bold(self._types_to_string(func.returns)))
+            mlog.log('Pos args:   ', mlog.bold(str(x.name for x in func.posargs)))
+            mlog.log('Opt args:   ', mlog.bold(str(x.name for x in func.optargs)))
+            mlog.log('Varargs:    ', mlog.bold(func.varargs.name if func.varargs is not None else 'null'))
+            mlog.log('Kwargs:     ', mlog.bold(str(list(func.kwargs.keys()))))
+
+    def _generate_object(self, obj: Object) -> None:
+        tags = 
+        tags += {
+            ObjectType.ELEMENTARY: mlog.yellow('elementary'),
+            ObjectType.BUILTIN: mlog.green('builtin'),
+            ObjectType.MODULE: mlog.blue('module'),
+            ObjectType.RETURNED: mlog.cyan('returned'),
+        }obj.obj_type
+        if obj.is_container:
+            tags += mlog.red('container')
+        mlog.log()
+        mlog.log('Object', mlog.bold(obj.name), *tags)
+        with my_nested():
+            desc = obj.description
+            if '\n' in desc:
+                desc = desc:desc.index('\n')
+            mlog.log('Description:', mlog.bold(desc))
+            mlog.log('Returned by:', mlog.bold(str(x.name for x in obj.returned_by)))
+            mlog.log('Methods:')
+            with my_nested():
+                for m in obj.methods:
+                    self._generate_function(m)
+
+    def generate(self) -> None:
+        mlog.log('\n\n', mlog.bold('=== Functions ==='), '\n')
+        for f in self.functions:
+            self._generate_function(f)
+        mlog.log('\n\n', mlog.bold('=== Elementary ==='), '\n')
+        for obj in self.elementary:
+            self._generate_object(obj)
+        mlog.log('\n\n', mlog.bold('=== Builtins ==='), '\n')
+        for obj in self.builtins:
+            self._generate_object(obj)
+        mlog.log('\n\n', mlog.bold('=== Returned objects ==='), '\n')
+        for obj in self.returned:
+            self._generate_object(obj)
+        mlog.log('\n\n', mlog.bold('=== Modules ==='), '\n')
+        for obj in self.modules:
+            self._generate_object(obj)
+            for mod_obj in self.extract_returned_by_module(obj):
+                self._generate_object(mod_obj)

_service:tar_scm:meson-1.0.1.tar.gz/docs/refman/jsonschema.py Added

@@ -0,0 +1,88 @@
+# SPDX-License-Identifer: Apache-2.0
+# Copyright 2021 The Meson development team
+
+import typing as T
+
+# The following variables define the current version of
+# the JSON documentation format. This is different from
+# the Meson version
+
+VERSION_MAJOR = 1  # Changes here indicate breaking format changes (changes to existing keys)
+VERSION_MINOR = 1  # Changes here indicate non-breaking changes (only new keys are added to the existing structure)
+
+class BaseObject(T.TypedDict):
+    '''
+        Base object for most dicts in the JSON doc.
+
+        All objects inheriting from BaseObject will support
+        the keys specified here:
+    '''
+    name:        str
+    description: str
+    since:       T.Optionalstr
+    deprecated:  T.Optionalstr
+    notes:       T.Liststr
+    warnings:    T.Liststr
+
+class Type(T.TypedDict):
+    obj:   str                 # References an object from `root.objects`
+    holds: T.Sequenceobject  # Mypy does not support recursive dicts, but this should be T.ListType...
+
+class Argument(BaseObject):
+    '''
+        Object that represents any type of a single function or method argument.
+    '''
+    type:        T.ListType  # A non-empty list of types that are supported.
+    type_str:    str           # Formatted version of `type`. Is guaranteed to not contain any whitespaces.
+    required:    bool
+    default:     T.Optionalstr
+    min_varargs: T.Optionalint  # Only relevant for varargs, must be `null` for all other types of arguments
+    max_varargs: T.Optionalint  # Only relevant for varargs, must be `null` for all other types of arguments
+
+class Function(BaseObject):
+    '''
+        Represents a function or method.
+    '''
+    returns:        T.ListType  # A non-empty list of types that are supported.
+    returns_str:    str           # Formatted version of `returns`. Is guaranteed to not contain any whitespaces.
+    example:        T.Optionalstr
+    posargs:        T.Dictstr, Argument
+    optargs:        T.Dictstr, Argument
+    kwargs:         T.Dictstr, Argument
+    varargs:        T.OptionalArgument
+    arg_flattening: bool
+
+class Object(BaseObject):
+    '''
+        Represents all types of Meson objects. The specific object type is stored in the `object_type` field.
+    '''
+    example:           T.Optionalstr
+    object_type:       str                    # Defines the object type: Must be one of: ELEMENTARY, BUILTIN, MODULE, RETURNED
+    methods:           T.Dictstr, Function
+    is_container:      bool
+    extends:           T.Optionalstr
+    returned_by:       T.Liststr
+    extended_by:       T.Liststr
+    defined_by_module: T.Optionalstr
+
+class ObjectsByType(T.TypedDict):
+    '''
+        References to other objects are stored here for ease of navigation / filtering
+    '''
+    elementary: T.Liststr
+    builtins:   T.Liststr
+    returned:   T.Liststr
+    modules:    T.Dictstr, T.Liststr
+
+
+
+class Root(T.TypedDict):
+    '''
+        The root object of the JSON reference manual
+    '''
+    version_major:   int # See the description above for
+    version_minor:   int # VERSION_MAJOR and VERSION_MINOR
+    meson_version:   str
+    functions:       T.Dictstr, Function  # A mapping of <name> to a `Function` object for *all* Meson functions
+    objects:         T.Dictstr, Object    # A mapping of <name> to a `Object`   object for *all* Meson objects (including modules, elementary, etc.)
+    objects_by_type: ObjectsByType

_service:tar_scm:meson-1.0.1.tar.gz/docs/refman/loaderbase.py Added

@@ -0,0 +1,216 @@
+# Copyright 2021 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.
+
+from abc import ABCMeta, abstractmethod
+from pathlib import Path
+import re
+import typing as T
+
+from .model import (
+    NamedObject,
+    FetureCheck,
+    ArgBase,
+    PosArg,
+    DataTypeInfo,
+    Type,
+    Function,
+    Method,
+    Object,
+    ObjectType,
+    ReferenceManual,
+)
+
+from mesonbuild import mlog
+
+class _Resolver:
+    def __init__(self) -> None:
+        self.type_map: T.Dictstr, Object = {}
+        self.func_map: T.Dictstr, T.UnionFunction, Method = {}
+        self.processed_funcs: T.Setstr = set()
+
+    def _validate_named_object(self, obj: NamedObject) -> None:
+        name_regex = re.compile(r'a-zA-Z0-9_+')
+        obj.name = obj.name.strip()
+        obj.description = obj.description.strip()
+        assert obj.name and obj.description, 'Both name and description must be set'
+        assert obj.name.islower(), f'Object names must be lower case ({obj.name})'
+        assert name_regex.match(obj.name) or obj.name == 'index', f'Invalid name {obj.name}'
+
+    def _validate_feature_check(self, obj: FetureCheck) -> None:
+        meson_version_reg = re.compile(r'0-9+\.0-9+\.0-9+')
+        obj.since = obj.since.strip()
+        obj.deprecated = obj.deprecated.strip()
+        if obj.since:
+            assert meson_version_reg.match(obj.since)
+        if obj.deprecated:
+            assert meson_version_reg.match(obj.deprecated)
+
+    def _resolve_type(self, raw: str) -> Type:
+        typ = Type(raw)
+        # We can't use `types = raw.split('|')`, because of `liststr | env`
+        types: T.Liststr = ''
+        stack = 0
+        for c in raw:
+            if stack == 0 and c == '|':
+                types += ''
+                continue
+            if c == '':
+                stack += 1
+            if c == '':
+                stack -= 1
+            types-1 += c
+        types = x.strip() for x in types
+        for t in types:
+            t = t.strip()
+            idx = t.find('')
+            base_type = t
+            held_type = None
+            if idx > 0:
+                base_type = t:idx
+                held_type = self._resolve_type(tidx+1:-1)
+            assert base_type in self.type_map, f'No known object {t}'
+            obj = self.type_mapbase_type
+            typ.resolved += DataTypeInfo(obj, held_type)
+        return typ
+
+    def _validate_func(self, func: T.UnionFunction, Method) -> None:
+        # Always run basic checks, since they also slightly post-process (strip) some strings
+        self._validate_named_object(func)
+        self._validate_feature_check(func)
+
+        func_id = f'{func.obj.name}.{func.name}' if isinstance(func, Method) else func.name
+        if func_id in self.processed_funcs:
+            return
+
+        func.returns = self._resolve_type(func.returns.raw)
+
+        all_args: T.ListArgBase = 
+        all_args += func.posargs
+        all_args += func.optargs
+        all_args += func.kwargs.values()
+        all_args += func.varargs if func.varargs else 
+
+        for arg in all_args:
+            arg.type = self._resolve_type(arg.type.raw)
+
+        # Handle returned_by
+        for obj in func.returns.resolved:
+            obj.data_type.returned_by += func
+
+        # Handle kwargs inehritance
+        for base_name in func.kwargs_inherit:
+            base_name = base_name.strip()
+            assert base_name in self.func_map, f'Unknown base function `{base_name}` for {func.name}'
+            base = self.func_mapbase_name
+            if base_name not in self.processed_funcs:
+                self._validate_func(base)
+
+            curr_keys = set(func.kwargs.keys())
+            base_keys = set(base.kwargs.keys())
+
+            # Calculate the missing kwargs from the current set
+            missing = {k: v for k, v in base.kwargs.items() if k in base_keys - curr_keys}
+            func.kwargs.update(missing)
+
+        # Handloe other args inheritance
+        _T = T.TypeVar('_T', bound=T.UnionArgBase, T.ListPosArg)
+        def resolve_inherit(name: str, curr: _T, resolver: T.CallableFunction, _T) -> _T:
+            if name and not curr:
+                name = name.strip()
+                assert name in self.func_map, f'Unknown base function `{name}` for {func.name}'
+                if name not in self.processed_funcs:
+                    self._validate_func(self.func_mapname)
+                ref_args = resolver(self.func_mapname)
+                assert ref_args is not None, f'Inherited function `{name}` does not have inherited args set'
+                return ref_args
+            return curr
+
+        func.posargs = resolve_inherit(func.posargs_inherit, func.posargs, lambda x: x.posargs)
+        func.optargs = resolve_inherit(func.optargs_inherit, func.optargs, lambda x: x.optargs)
+        func.varargs = resolve_inherit(func.varargs_inherit, func.varargs, lambda x: x.varargs)
+
+        self.processed_funcs.add(func_id)
+
+    def validate_and_resolve(self, manual: ReferenceManual) -> ReferenceManual:
+        mlog.log('Validating loaded manual...')
+
+        # build type map and func map for methods
+        for obj in manual.objects:
+            assert obj.name not in self.type_map, f'Duplicate object name {obj.name}'
+            self.type_mapobj.name = obj
+            for m in obj.methods:
+                mid = f'{obj.name}.{m.name}'
+                assert mid not in self.type_map, f'Duplicate method {mid}'
+                self.func_mapmid = m
+
+        # Build func map for functions
+        for func in manual.functions:
+            assert func.name not in *self.func_map.keys(), f'Duplicate function {func.name}'
+            self.func_mapfunc.name = func
+
+        mlog.log('Validating functions...')
+        for func in manual.functions:
+            mlog.log(' -- validating', mlog.bold(func.name))
+            self._validate_func(func)
+
+        mlog.log('Validating objects...')
+        for obj in manual.objects:
+            mlog.log(' -- validating', mlog.bold(obj.name))
+            self._validate_named_object(obj)
+            self._validate_feature_check(obj)
+            # Resolve and validate inheritance
+            if obj.extends:
+                assert obj.extends in self.type_map, f'Unknown extends object {obj.extends} in {obj.name}'
+                obj.extends_obj = self.type_mapobj.extends
+                obj.extends_obj.extended_by += obj
+            # Only returned objects can be associated with module
+            if obj.obj_type is not ObjectType.RETURNED:
+                assert obj.defined_by_module is None
+            for m in obj.methods:
+                assert m.obj is obj
+                self._validate_func(m)
+
+        # Resolve inherited methods
+        for obj in manual.objects:
+            inherited_methods = obj.inherited_methods
+            curr = obj.extends_obj
+            while curr is not None:
+                inherited_methods += curr.methods
+                curr = curr.extends_obj
+        return manual
+
+class LoaderBase(metaclass=ABCMeta):
+    def __init__(self) -> None:
+        self._input_files: T.ListPath = 
+
+    @property
+    def input_files(self) -> T.ListPath:
+        return list(self._input_files)
+
+    def read_file(self, f: Path) -> str:
+        assert f.exists()
+        assert f.is_file()
+        self._input_files += f.resolve()
+        return f.read_text(encoding='utf-8')
+
+    @abstractmethod
+    def load_impl(self) -> ReferenceManual:
+        pass
+
+    def load(self) -> ReferenceManual:
+        self._input_files =   # Reset input files
+        manual = self.load_impl()
+        resolver = _Resolver()
+        with mlog.nested():
+            return resolver.validate_and_resolve(manual)

_service:tar_scm:meson-1.0.1.tar.gz/docs/refman/loaderpickle.py Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/refman/loaderyaml.py Added

@@ -0,0 +1,315 @@
+# Copyright 2021 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.
+
+from .loaderbase import LoaderBase
+from .model import (
+    Type,
+    PosArg,
+    VarArgs,
+    Kwarg,
+    Function,
+    Method,
+    ObjectType,
+    Object,
+    ReferenceManual,
+)
+
+from mesonbuild import mlog
+from mesonbuild import mesonlib
+
+from pathlib import Path
+import typing as T
+
+class Template:
+    d_feature_check: T.Dictstr, T.Any = {}
+    s_posarg: T.Dictstr, T.Any = {}
+    s_varargs: T.Dictstr, T.Any = {}
+    s_kwarg: T.Dictstr, T.Any = {}
+    s_function: T.Dictstr, T.Any = {}
+    s_object: T.Dictstr, T.Any = {}
+
+class StrictTemplate(Template):
+    def __init__(self) -> None:
+        from strictyaml import Map, MapPattern, Optional, Str, Seq, Int, Bool, EmptyList, OrValidator
+
+        d_named_object = {
+            'name': Str(),
+            'description': Str(),
+        }
+
+        d_feture_check = {
+            Optional('since', default=''): Str(),
+            Optional('deprecated', default=''): Str(),
+        }
+
+        self.s_posarg = Map({
+            **d_feture_check,
+            'description': Str(),
+            'type': Str(),
+            Optional('default', default=''): Str(),
+        })
+
+        self.s_varargs = Map({
+            **d_named_object, **d_feture_check,
+            'type': Str(),
+            Optional('min_varargs', default=-1): Int(),
+            Optional('max_varargs', default=-1): Int(),
+        })
+
+        self.s_kwarg = Map({
+            **d_feture_check,
+            'type': Str(),
+            'description': Str(),
+            Optional('required', default=False): Bool(),
+            Optional('default', default=''): Str(),
+        })
+
+        self.s_function = Map({
+            **d_named_object, **d_feture_check,
+            'returns': Str(),
+            Optional('notes', default=): OrValidator(Seq(Str()), EmptyList()),
+            Optional('warnings', default=): OrValidator(Seq(Str()), EmptyList()),
+            Optional('example', default=''): Str(),
+            Optional('posargs'): MapPattern(Str(), self.s_posarg),
+            Optional('optargs'): MapPattern(Str(), self.s_posarg),
+            Optional('varargs'): self.s_varargs,
+            Optional('posargs_inherit', default=''): Str(),
+            Optional('optargs_inherit', default=''): Str(),
+            Optional('varargs_inherit', default=''): Str(),
+            Optional('kwargs'): MapPattern(Str(), self.s_kwarg),
+            Optional('kwargs_inherit', default=): OrValidator(OrValidator(Seq(Str()), EmptyList()), Str()),
+            Optional('arg_flattening', default=True): Bool(),
+        })
+
+        self.s_object = Map({
+            **d_named_object, **d_feture_check,
+            'long_name': Str(),
+            Optional('extends', default=''): Str(),
+            Optional('notes', default=): OrValidator(Seq(Str()), EmptyList()),
+            Optional('warnings', default=): OrValidator(Seq(Str()), EmptyList()),
+            Optional('example', default=''): Str(),
+            Optional('methods'): Seq(self.s_function),
+            Optional('is_container', default=False): Bool()
+        })
+
+class FastTemplate(Template):
+    d_feature_check: T.Dictstr, T.Any = {
+        'since': '',
+        'deprecated': '',
+    }
+
+    s_posarg = {
+        **d_feature_check,
+        'default': '',
+    }
+
+    s_varargs: T.Dictstr, T.Any = {
+        **d_feature_check,
+        'min_varargs': -1,
+        'max_varargs': -1,
+    }
+
+    s_kwarg = {
+        **d_feature_check,
+        'required': False,
+        'default': '',
+    }
+
+    s_function = {
+        **d_feature_check,
+        'notes': ,
+        'warnings': ,
+        'example': '',
+        'posargs': {},
+        'optargs': {},
+        'varargs': None,
+        'posargs_inherit': '',
+        'optargs_inherit': '',
+        'varargs_inherit': '',
+        'kwargs': {},
+        'kwargs_inherit': ,
+        'arg_flattening': True,
+    }
+
+    s_object = {
+        **d_feature_check,
+        'extends': '',
+        'notes': ,
+        'warnings': ,
+        'example': '',
+        'methods': ,
+        'is_container': False,
+    }
+
+class LoaderYAML(LoaderBase):
+    def __init__(self, yaml_dir: Path, strict: bool=True) -> None:
+        super().__init__()
+        self.yaml_dir = yaml_dir
+        self.func_dir = self.yaml_dir / 'functions'
+        self.elem_dir = self.yaml_dir / 'elementary'
+        self.objs_dir = self.yaml_dir / 'objects'
+        self.builtin_dir = self.yaml_dir / 'builtins'
+        self.modules_dir = self.yaml_dir / 'modules'
+        self.strict = strict
+
+        template: Template
+        if self.strict:
+            import strictyaml
+            def loader(file: str, template: T.Any, label: str) -> T.Dict:
+                r: T.Dict = strictyaml.load(file, template, label=label).data
+                return r
+
+            self._load = loader
+            template = StrictTemplate()
+        else:
+            import yaml
+            from yaml import CLoader
+            def loader(file: str, template: T.Any, label: str) -> T.Dict:
+                return {**template, **yaml.load(file, Loader=CLoader)}
+
+            self._load = loader
+            template = FastTemplate()
+
+        self.template = template
+
+    def _fix_default(self, v: T.Dict) -> None:
+        if v"default" is False:
+            v"default" = "false"
+        elif v"default" is True:
+            v"default" = "true"
+        else:
+            v"default" = str(v"default")
+
+    def _process_function_base(self, raw: T.Dict, obj: T.OptionalObject = None) -> Function:
+        # Handle arguments
+        posargs = raw.pop('posargs', {})
+        optargs = raw.pop('optargs', {})
+        varargs = raw.pop('varargs', None)
+        kwargs = raw.pop('kwargs', {})
+
+        # Fix kwargs_inherit
+        if isinstance(raw'kwargs_inherit', str):
+            raw'kwargs_inherit' = raw'kwargs_inherit'
+
+        # Parse args
+        posargs_mapped: T.ListPosArg = 
+        optargs_mapped: T.ListPosArg = 
+        varargs_mapped: T.OptionalVarArgs = None
+        kwargs_mapped: T.Dictstr, Kwarg = {}
+
+        for k, v in posargs.items():
+            if not self.strict:
+                v = {**self.template.s_posarg, **v}
+                self._fix_default(v)
+            v'type' = Type(v'type')
+            posargs_mapped += PosArg(name=k, **v)
+
+        for k, v in optargs.items():
+            if not self.strict:
+                v = {**self.template.s_posarg, **v}
+                self._fix_default(v)
+            v'type' = Type(v'type')
+            optargs_mapped += PosArg(name=k, **v)
+
+        for k, v in kwargs.items():
+            if not self.strict:
+                v = {**self.template.s_kwarg, **v}
+                self._fix_default(v)
+            v'type' = Type(v'type')
+            kwargs_mappedk = Kwarg(name=k, **v)
+
+        if varargs is not None:
+            if not self.strict:
+                varargs = {**self.template.s_varargs, **varargs}
+            varargs'type' = Type(varargs'type')
+            varargs_mapped = VarArgs(**varargs)
+
+        raw'returns' = Type(raw'returns')
+
+        # Build function object
+        if obj is not None:
+            return Method(
+                posargs=posargs_mapped,
+                optargs=optargs_mapped,
+                varargs=varargs_mapped,
+                kwargs=kwargs_mapped,
+                obj=obj,
+                **raw,
+            )
+        return Function(
+            posargs=posargs_mapped,
+            optargs=optargs_mapped,
+            varargs=varargs_mapped,
+            kwargs=kwargs_mapped,
+            **raw,
+        )
+
+    def _load_function(self, path: Path, obj: T.OptionalObject = None) -> Function:
+        path_label = path.relative_to(self.yaml_dir).as_posix()
+        mlog.log('Loading', mlog.bold(path_label))
+        raw = self._load(self.read_file(path), self.template.s_function, label=path_label)
+        return self._process_function_base(raw)
+
+    def _load_object(self, obj_type: ObjectType, path: Path) -> Object:
+        path_label = path.relative_to(self.yaml_dir).as_posix()
+        mlog.log(f'Loading', mlog.bold(path_label))
+        raw = self._load(self.read_file(path), self.template.s_object, label=path_label)
+
+        def as_methods(mlist: T.ListFunction) -> T.ListMethod:
+            res: T.ListMethod = 
+            for i in mlist:
+                assert isinstance(i, Method)
+                res += i
+            return res
+
+        methods = raw.pop('methods', )
+        obj = Object(methods=, obj_type=obj_type, **raw)
+
+        newmethods = 
+        for x in methods:
+            if not self.strict:
+                x = {**self.template.s_function, **x}
+            newmethods += self._process_function_base(x, obj)
+        obj.methods = as_methods(newmethods)
+        return obj
+
+    def _load_module(self, path: Path) -> T.ListObject:
+        assert path.is_dir()
+        module = self._load_object(ObjectType.MODULE, path / 'module.yaml')
+        objs = 
+        for p in path.iterdir():
+            if p.name == 'module.yaml':
+                continue
+            obj = self._load_object(ObjectType.RETURNED, p)
+            obj.defined_by_module = module
+            objs += obj
+        return module, *objs
+
+    def load_impl(self) -> ReferenceManual:
+        mlog.log('Loading YAML reference manual')
+        with mlog.nested():
+            manual = ReferenceManual(
+                functions=self._load_function(x) for x in self.func_dir.iterdir(),
+                objects=mesonlib.listify(
+                    self._load_object(ObjectType.ELEMENTARY, x) for x in self.elem_dir.iterdir(),
+                    self._load_object(ObjectType.RETURNED, x) for x in self.objs_dir.iterdir(),
+                    self._load_object(ObjectType.BUILTIN, x) for x in self.builtin_dir.iterdir(),
+                    self._load_module(x) for x in self.modules_dir.iterdir()
+                , flatten=True)
+            )
+
+            if not self.strict:
+                mlog.warning('YAML reference manual loaded using the best-effort fastyaml loader.  Results are not guaranteed to be stable or correct.')
+
+            return manual

_service:tar_scm:meson-1.0.1.tar.gz/docs/refman/main.py Added

@@ -0,0 +1,88 @@
+# Copyright 2021 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.
+
+from pathlib import Path
+import argparse
+import typing as T
+
+from mesonbuild import mlog
+
+from .loaderbase import LoaderBase
+from .loaderpickle import LoaderPickle
+from .loaderyaml import LoaderYAML
+
+from .generatorbase import GeneratorBase
+from .generatorjson import GeneratorJSON
+from .generatorprint import GeneratorPrint
+from .generatorpickle import GeneratorPickle
+from .generatormd import GeneratorMD
+from .generatorman import GeneratorMan
+
+meson_root = Path(__file__).absolute().parents2
+
+def main() -> int:
+    parser = argparse.ArgumentParser(description='Meson reference manual generator')
+    parser.add_argument('-l', '--loader', type=str, default='yaml', choices='yaml', 'fastyaml', 'pickle', help='Information loader backend')
+    parser.add_argument('-g', '--generator', type=str, choices='print', 'pickle', 'md', 'json', 'man', required=True, help='Generator backend')
+    parser.add_argument('-s', '--sitemap', type=Path, default=meson_root / 'docs' / 'sitemap.txt', help='Path to the input sitemap.txt')
+    parser.add_argument('-o', '--out', type=Path, required=True, help='Output directory for generated files')
+    parser.add_argument('-i', '--input', type=Path, default=meson_root / 'docs' / 'yaml', help='Input path for the selected loader')
+    parser.add_argument('--link-defs', type=Path, help='Output file for the MD generator link definition file')
+    parser.add_argument('--depfile', type=Path, default=None, help='Set to generate a depfile')
+    parser.add_argument('-q', '--quiet', action='store_true', help='Suppress verbose output')
+    parser.add_argument('--force-color', action='store_true', help='Force enable colors')
+    parser.add_argument('--no-modules', action='store_true', help='Disable building modules')
+    args = parser.parse_args()
+
+    if args.quiet:
+        mlog.set_quiet()
+
+    if args.force_color:
+        mlog.colorize_console = lambda: True
+
+    loaders: T.Dictstr, T.Callable, LoaderBase = {
+        'yaml': lambda: LoaderYAML(args.input),
+        'fastyaml': lambda: LoaderYAML(args.input, strict=False),
+        'pickle': lambda: LoaderPickle(args.input),
+    }
+
+    loader = loadersargs.loader()
+    refMan = loader.load()
+
+    generators: T.Dictstr, T.Callable, GeneratorBase = {
+        'print': lambda: GeneratorPrint(refMan),
+        'pickle': lambda: GeneratorPickle(refMan, args.out),
+        'md': lambda: GeneratorMD(refMan, args.out, args.sitemap, args.link_defs, not args.no_modules),
+        'json': lambda: GeneratorJSON(refMan, args.out, not args.no_modules),
+        'man': lambda: GeneratorMan(refMan, args.out, not args.no_modules),
+    }
+    generator = generatorsargs.generator()
+
+    # Generate the depfile if required
+    if args.depfile is not None:
+        assert isinstance(args.depfile, Path)
+        assert isinstance(args.out, Path)
+
+        # Also add all files of this package
+        script_files = list(Path(__file__).resolve().parent.glob('**/*.py'))
+        templates = list(Path(__file__).resolve().parent.glob('**/*.mustache'))
+
+        out_text = f'{args.out.resolve().as_posix()}: \\\n'
+        for input in loader.input_files + script_files + templates:
+            out_text += f'    {input.resolve().as_posix():<93} \\\n'
+
+        args.depfile.write_text(out_text, encoding='utf-8')
+
+    generator.generate()
+    return 0

_service:tar_scm:meson-1.0.1.tar.gz/docs/refman/model.py Added

@@ -0,0 +1,114 @@
+# Copyright 2021 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.
+
+from dataclasses import dataclass, field
+from enum import Enum
+import typing as T
+
+# Utils
+@dataclass
+class NamedObject:
+    name: str
+    description: str
+
+    @property
+    def hidden(self) -> bool:
+        return self.name.startswith('_')
+
+@dataclass
+class FetureCheck:
+    since: str
+    deprecated: str
+
+@dataclass
+class DataTypeInfo:
+    data_type: 'Object'
+    holds: T.Optional'Type'
+
+@dataclass
+class Type:
+    raw: str
+    resolved: T.ListDataTypeInfo = field(init=False, default_factory=list)
+
+
+# Arguments
+@dataclass
+class ArgBase(NamedObject, FetureCheck):
+    type: Type
+
+@dataclass
+class PosArg(ArgBase):
+    default: str
+
+@dataclass
+class VarArgs(ArgBase):
+    min_varargs: int
+    max_varargs: int
+
+@dataclass
+class Kwarg(ArgBase):
+    required: bool
+    default: str
+
+
+# Function
+@dataclass
+class Function(NamedObject, FetureCheck):
+    notes: T.Liststr
+    warnings: T.Liststr
+    returns: Type
+    example: str
+    posargs: T.ListPosArg
+    optargs: T.ListPosArg
+    varargs: T.OptionalVarArgs
+    kwargs: T.Dictstr, Kwarg
+    posargs_inherit: str
+    optargs_inherit: str
+    varargs_inherit: str
+    kwargs_inherit: T.Liststr
+    arg_flattening: bool
+
+@dataclass
+class Method(Function):
+    obj: 'Object'
+
+
+# Types and objects
+class ObjectType(Enum):
+    ELEMENTARY = 0
+    BUILTIN = 1
+    MODULE = 2
+    RETURNED = 3
+
+@dataclass
+class Object(NamedObject, FetureCheck):
+    notes: T.Liststr
+    warnings: T.Liststr
+    long_name: str
+    example: str
+    obj_type: ObjectType
+    methods: T.ListMethod
+    is_container: bool
+    extends: str
+    extends_obj: T.Optional'Object' = None
+    defined_by_module: T.Optional'Object' = None
+    returned_by: T.ListT.UnionFunction, Method = field(default_factory=list)
+    extended_by: T.List'Object' = field(default_factory=list)
+    inherited_methods: T.ListMethod = field(default_factory=list)
+
+# ROOT
+@dataclass
+class ReferenceManual:
+    functions: T.ListFunction
+    objects: T.ListObject

_service:tar_scm:meson-1.0.1.tar.gz/docs/refman/templates Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/refman/templates/args.mustache Added

@@ -0,0 +1,28 @@
+
+<style>
+  .nomargin p:last-child { margin-bottom: 0px !important; }
+</style>
+<table>
+  <thead>
+    <tr>
+      <th style="white-space: nowrap; text-align: center;">Name</th>
+      <th style="white-space: nowrap; text-align: center;">Type</th>
+      <th style="width: 56%;">Description</th>
+      <th style="white-space: nowrap; text-align: center; width: 0px;">Tags</th>
+    </tr>
+  </thead>
+  <tbody class="nomargin">
+    {{#args}}
+    <tr>
+      <td style="white-space: nowrap; text-align: center; padding: 6px;"><code class="language-meson">{{name}}</code></td>
+      <td style="white-space: revert; text-align: center; padding: 6px; word-wrap: break-word;">{{&type}}</td>
+      
+      <td style="width: 56%; padding: 6px;">
+
+{{&description}}
+</td>
+      <td style="white-space: nowrap; text-align: center; padding: 6px; width: 0px;">{{>taggs}}</td>
+    </tr>
+    {{/args}}
+  </tbody>
+</table>

_service:tar_scm:meson-1.0.1.tar.gz/docs/refman/templates/dummy.mustache Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/refman/templates/func.mustache Added

@@ -0,0 +1,59 @@
+{{base_level}}# {{name}}()
+
+{{&description}}
+
+<p style="padding: 5px; margin: 0px;"></p> 
+<div style="display: flex;">
+  <{{signature_level}} style="margin-top: 0px;">Signature</{{signature_level}}>
+  <div style="flex-grow: 1;"></div>
+  <div>{{>taggs}}</div>
+</div>
+
+<pre><code class="language-meson">{{&signature}}</code></pre>
+
+{{#example}}
+  <p style="padding: 5px; margin: 0px;"></p> 
+
+  {{base_level}}## Example
+
+{{&example}}
+{{/example}}
+
+{{>notes}}
+
+{{#has_args}}
+  <p style="padding: 5px; margin: 0px;"></p> 
+
+  {{base_level}}## Arguments
+
+{{^arg_flattening}}
+  Argument flattening(Syntax.md#argument-flattening) is **NOT SUPPORTED** by this function.
+{{/arg_flattening}}
+{{/has_args}}
+
+{{#posargs}}
+  The {{type_name}} `{{name}}()` accepts the following positional arguments:
+
+  {{>args}}
+
+  <p style="padding: 5px; margin: 0px;"></p> 
+{{/posargs}}
+
+{{#varargs}}
+  {{#posargs}}Additionally, the{{/posargs}}{{^posargs}}The{{/posargs}}
+  {{type_name}} accepts between `{{min}}` and `{{max}}` variadic
+  arguments (`{{name}}...`) of type <code>{{&type}}</code>.
+
+  {{&description}}
+
+  {{>taggs}}
+
+  <p style="padding: 5px; margin: 0px;"></p> 
+{{/varargs}}
+
+{{#kwargs}}
+  {{#posargs}}Finally, `{{name}}()`{{/posargs}}{{^posargs}}The {{type_name}} `{{name}}()`{{/posargs}}
+  accepts the following keyword arguments:
+
+  {{>args}}
+{{/kwargs}}

_service:tar_scm:meson-1.0.1.tar.gz/docs/refman/templates/notes.mustache Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/refman/templates/object.mustache Added

@@ -0,0 +1,62 @@
+---
+short-description: "{{obj_type_name}} object: {{long_name}}"
+title: {{name}}{{#extends}} (extends {{.}}){{/extends}}
+render-subpages: false
+...
+# {{long_name}} (`{{name}}`{{#extends}} extends @{{.}}{{/extends}})
+
+{{&description}}
+
+{{#has_subclasses}}
+## Extended by
+
+{{long_name}} is extended by the following subtypes:
+{{#extended_by}}
+- {{&.}}
+{{/extended_by}}
+{{/has_subclasses}}
+
+{{#is_returned}}
+## Returned by
+
+{{long_name}} objects are returned by the following functions and methods:
+{{#returned_by}}
+- {{&.}}
+{{/returned_by}}
+{{/is_returned}}
+
+{{#example}}
+## Example
+
+<pre><code class="language-meson">{{&example}}</code></pre>
+{{/example}}
+
+{{>notes}}
+
+{{#has_methods}}
+## {{long_name}} methods
+
+{{#methods}}
+<p style="padding: 7.5px; margin: 0px;"></p>
+
+{{>func}}
+
+<p style="padding: 7.5px; margin: 0px;"></p>
+
+---
+{{/methods}}
+{{/has_methods}}
+
+{{#has_inherited_methods}}
+## Inherited methods
+
+{{#inherited_methods}}
+<p style="padding: 7.5px; margin: 0px;"></p>
+
+{{>func}}
+
+<p style="padding: 7.5px; margin: 0px;"></p>
+
+---
+{{/inherited_methods}}
+{{/has_inherited_methods}}

_service:tar_scm:meson-1.0.1.tar.gz/docs/refman/templates/root.functions.mustache Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/refman/templates/root.mustache Added

@@ -0,0 +1,58 @@
+---
+short-description: The Meson reference manual
+render-subpages: false
+...
+
+# Reference manual
+
+This is the root page of the online Meson reference manual. This
+manual is also available in a more machine readable format as a
+JSON documented attached to every release since *0.60.0*. See our
+IDE integration(IDE-integration.md) documentation for more
+information.
+
+All functions and methods are documented in detail in the
+following subpages:
+
+## Elementary types
+
+{{#elementary}}
+{{indent}}- {{&link}}
+{{/elementary}}
+
+## Functions
+
+The following functions are available in build files. Click on each
+to see the description and usage. The objects returned by them are
+listed here(#returned-objects).
+
+{{#functions}}
+{{indent}}- {{&link}}
+{{/functions}}
+
+## Builtin objects
+
+These are built-in objects that are always available.
+
+{{#builtins}}
+{{indent}}- {{&link}}
+{{/builtins}}
+
+## Returned objects
+
+These are objects that can be returned by functions(#functions)
+or other methods.
+
+{{#returned}}
+{{indent}}- {{&link}}
+{{/returned}}
+
+{{#enable_modules}}
+## Modules
+
+{{#modules}}
+{{indent}}- {{&link}}
+{{/modules}}
+{{/enable_modules}}
+
+

_service:tar_scm:meson-1.0.1.tar.gz/docs/refman/templates/root_link.mustache Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/refman/templates/taggs.mustache Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/sitemap.txt Added

@@ -0,0 +1,144 @@
+index.md
+	SimpleStart.md
+	Getting-meson.md
+		Getting-meson_zh.md
+		Getting-meson_ptbr.md
+	Quick-guide.md
+	Tutorial.md
+	GuiTutorial.md
+	Manual.md
+		Overview.md
+		Running-Meson.md
+		Commands.md
+		Builtin-options.md
+		Using-with-Visual-Studio.md
+		Meson-sample.md
+		Syntax.md
+		Machine-files.md
+		Native-environments.md
+		Build-targets.md
+		Include-directories.md
+		Installing.md
+		Adding-arguments.md
+		Configuration.md
+		Compiler-properties.md
+		Dependencies.md
+		Threads.md
+		External-commands.md
+		Precompiled-headers.md
+		Unity-builds.md
+		Feature-autodetection.md
+		Generating-sources.md
+		Unit-tests.md
+		Cross-compilation.md
+		Localisation.md
+		Build-options.md
+		Subprojects.md
+		Disabler.md
+		Code-formatting.md
+		Modules.md
+			CMake-module.md
+			Cuda-module.md
+			Dlang-module.md
+			External-Project-module.md
+			Fs-module.md
+			Gnome-module.md
+			Hotdoc-module.md
+			Icestorm-module.md
+			Java-module.md
+			Keyval-module.md
+			Pkgconfig-module.md
+			Python-3-module.md
+			Python-module.md
+			Qt4-module.md
+			Qt5-module.md
+			Qt6-module.md
+			Rust-module.md
+			Simd-module.md
+			SourceSet-module.md
+			Windows-module.md
+			i18n-module.md
+			Wayland-module.md
+		Java.md
+		Vala.md
+		D.md
+		Cython.md
+		Rust.md
+		IDE-integration.md
+		Custom-build-targets.md
+		Build-system-converters.md
+		Configuring-a-build-directory.md
+		Run-targets.md
+		Creating-releases.md
+		Creating-OSX-packages.md
+		Creating-Linux-binaries.md
+		Project-templates.md
+	@REFMAN_PLACEHOLDER@
+	Reference-tables.md
+	Style-guide.md
+	Rewriter.md
+	FAQ.md
+	Reproducible-builds.md
+	howtox.md
+	Wrapdb-projects.md
+	Wrap-dependency-system-manual.md
+		Adding-new-projects-to-wrapdb.md
+		Using-the-WrapDB.md
+		Using-wraptool.md
+		Wrap-best-practices-and-tips.md
+		Shipping-prebuilt-binaries-as-wraps.md
+	Release-notes.md
+		Release-notes-for-1.0.0.md
+		Release-notes-for-0.64.0.md
+		Release-notes-for-0.63.0.md
+		Release-notes-for-0.62.0.md
+		Release-notes-for-0.61.0.md
+		Release-notes-for-0.60.0.md
+		Release-notes-for-0.59.0.md
+		Release-notes-for-0.58.0.md
+		Release-notes-for-0.57.0.md
+		Release-notes-for-0.56.0.md
+		Release-notes-for-0.55.0.md
+		Release-notes-for-0.54.0.md
+		Release-notes-for-0.53.0.md
+		Release-notes-for-0.52.0.md
+		Release-notes-for-0.51.0.md
+		Release-notes-for-0.50.0.md
+		Release-notes-for-0.49.0.md
+		Release-notes-for-0.48.0.md
+		Release-notes-for-0.47.0.md
+		Release-notes-for-0.46.0.md
+		Release-notes-for-0.45.0.md
+		Release-notes-for-0.44.0.md
+		Release-notes-for-0.43.0.md
+		Release-notes-for-0.42.0.md
+		Release-notes-for-0.41.0.md
+		Release-notes-for-0.40.0.md
+		Release-notes-for-0.39.0.md
+		Release-notes-for-0.38.0.md
+		Release-notes-for-0.37.0.md
+	Additional.md
+		Release-procedure.md
+		Performance-comparison.md
+			ARM-performance-test.md
+			Simple-comparison.md
+		Comparisons.md
+		Conference-presentations.md
+		Contact-information.md
+		Continuous-Integration.md
+		Design-rationale.md
+		IndepthTutorial.md
+		In-the-press.md
+		Mixing-build-systems.md
+		Pkg-config-files.md
+		Playground.md
+		Porting-from-autotools.md
+		Use-of-Python.md
+		Users.md
+		Using-multiple-build-directories.md
+		Vs-External.md
+	Contributing.md
+		Yaml-RefMan.md
+		MesonCI.md
+	legal.md
+	Videos.md

_service:tar_scm:meson-1.0.1.tar.gz/docs/theme Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/theme/extra Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/theme/extra/images Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/theme/extra/images/favicon.png Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/theme/extra/images/meson_logo.png Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/theme/extra/prism_components Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/theme/extra/prism_components/prism-meson.js Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/theme/extra/prism_components/prism-meson.min.js Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/theme/extra/templates Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/theme/extra/templates/brand-logo.html Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/theme/extra/templates/extra_head.html Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/theme/extra/templates/license.html Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/theme/extra/templates/navbar_center.html Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/theme/extra/templates/navbar_links.html Added

@@ -0,0 +1,54 @@
+@require(page)
+
+<li class="dropdown">
+  <a class="dropdown-toggle" role="button" data-toggle="dropdown" aria-haspopup="true" aria-expanded="false">
+    Modules <span class="caret"></span>
+  </a>
+  <ul class="dropdown-menu" id="modules-menu">
+    @for tup in  \
+            ("CMake-module.html","CMake"), \
+            ("Cuda-module.html","CUDA"), \
+            ("Dlang-module.html","Dlang"), \
+            ("External-Project-module.html","External Project"), \
+            ("Fs-module.html","Filesystem"), \
+            ("Gnome-module.html","GNOME"), \
+            ("Hotdoc-module.html","Hotdoc"), \
+            ("i18n-module.html","i18n"), \
+            ("Icestorm-module.html","Icestorm"), \
+            ("Java-module.html","Java"), \
+            ("Keyval-module.html","Keyval"), \
+            ("Pkgconfig-module.html","Pkgconfig"), \
+            ("Python-3-module.html","Python 3"), \
+            ("Python-module.html","Python"), \
+            ("Qt4-module.html","Qt4"), \
+            ("Qt5-module.html","Qt5"), \
+            ("Qt6-module.html","Qt6"), \
+            ("Rust-module.html","Rust"), \
+            ("Simd-module.html","Simd"), \
+            ("SourceSet-module.html","SourceSet"), \
+            ("Wayland-module.html","Wayland"), \
+            ("Windows-module.html","Windows"):
+        <li>
+            <a href="@tup0">@tup1</a>
+        </li>
+    @end
+	</ul>
+</li>
+\
+<li class="dropdown">
+	<a class="dropdown-toggle" role="button" data-toggle="dropdown" aria-haspopup="true" aria-expanded="false">
+		Quick References <span class="caret"></span>
+	</a>
+	<ul class="dropdown-menu" id="quick-refs-menu">
+		@for tup in (("Reference-manual.html", "Functions"), \
+           ("Build-options.html", "Options"), \
+           ("Configuration.html", "Configuration"), \
+           ("Dependencies.html", "Dependencies"), \
+           ("Unit-tests.html", "Tests"), \
+           ("Syntax.html", "Syntax")):
+			<li>
+				<a href="@tup0">@tup1</a>
+			</li>
+		@end
+	</ul>
+</li>

_service:tar_scm:meson-1.0.1.tar.gz/docs/yaml Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/yaml/builtins Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/yaml/builtins/build_machine.yaml Added

@@ -0,0 +1,37 @@
+name: build_machine
+long_name: Build machine information
+description: |
+  Provides information about the build machine -- the machine that is doing the actual compilation.
+  See Cross-compilation(Cross-compilation.md).
+
+  Currently, these values are populated using
+  `platform.system()`(https://docs.python.org/3.7/library/platform.html#platform.system) and
+  `platform.machine()`(https://docs.python.org/3.7/library/platform.html#platform.machine).
+  If you think the returned values for any of these are incorrect for
+  your system or CPU, or if your OS is not in the linked table, please
+  file a bug(https://github.com/mesonbuild/meson/issues/new) report
+  with details and we'll look into it.
+
+methods:
+- name: cpu_family
+  returns: str
+  description: |
+    Returns the CPU family name.
+    This table(Reference-tables.md#cpu-families) contains
+    all known CPU families. These are guaranteed to continue working.
+
+- name: cpu
+  returns: str
+  description: Returns a more specific CPU name, such as `i686`, `amd64`, etc.
+
+- name: system
+  returns: str
+  description: |
+    Returns the operating system name.
+    This table(Reference-tables.md#operating-system-names) Lists
+    all of the currently known Operating System names, these are
+    guaranteed to continue working.
+
+- name: endian
+  returns: str
+  description: returns `'big'` on big-endian systems and `'little'` on little-endian systems.

_service:tar_scm:meson-1.0.1.tar.gz/docs/yaml/builtins/host_machine.yaml Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/yaml/builtins/meson.yaml Added

@@ -0,0 +1,472 @@
+name: meson
+long_name: Meson object
+description: |
+  The `meson` object allows you to introspect various properties of the
+  system. This object is always mapped in the `meson` variable.
+
+methods:
+  - name: add_dist_script
+    returns: void
+    since: 0.48.0
+    description: |
+      Causes the script given as argument to run during `dist`
+      operation after the
+      distribution source has been generated but before it is
+      archived. Note that this runs the script file that is in the
+      _staging_ directory, not the one in the source directory. If the
+      script file can not be found in the staging directory, it is a hard
+      error. The `MESON_DIST_ROOT` environment variables is set when dist scripts is
+      run.
+
+      *(since 0.54.0)* The `MESON_SOURCE_ROOT` and `MESON_BUILD_ROOT`
+      environment variables are set when dist scripts are run. They are path to the
+      root source and build directory of the main project, even when the script
+      comes from a subproject.
+
+      *(since 0.58.0)* This command can be invoked from a subproject, it was a hard
+      error in earlier versions. Subproject dist scripts will only be executed
+      when running `meson dist --include-subprojects`. `MESON_PROJECT_SOURCE_ROOT`,
+      `MESON_PROJECT_BUILD_ROOT` and `MESON_PROJECT_DIST_ROOT` environment
+      variables are set when dist scripts are run. They are identical to
+      `MESON_SOURCE_ROOT`, `MESON_BUILD_ROOT` and `MESON_DIST_ROOT` for main project
+      scripts, but for subproject scripts they have the path to the root of the
+      subproject appended, usually `subprojects/<subproject-name>`.
+
+    posargs:
+      script_name:
+        type: str | file | external_program
+        description: |
+          The script to execute.
+
+          *(since 0.55.0)* The output of find_program as well as strings are accepted.
+
+          *(since 0.57.0)* @file objects and the output of configure_file may be used.
+
+    varargs:
+      name: arg
+      type: str | file | external_program
+      since: 0.49.0
+      description: |
+        Additional arguments
+
+        *(since 0.55.0)* The output of configure_file, files, and find_program
+        as well as strings are accepted.
+
+  - name: add_install_script
+    returns: void
+    description: |
+      Causes the script given as an argument to be run during the install step,
+      this script  will have the environment variables `MESON_SOURCE_ROOT`,
+      `MESON_BUILD_ROOT`, `MESON_INSTALL_PREFIX`,
+      `MESON_INSTALL_DESTDIR_PREFIX`, and `MESONINTROSPECT` set.
+      All positional arguments are passed as parameters.
+
+      *(since 0.54.0)* If `meson install` is called with the `--quiet` option, the
+      environment variable `MESON_INSTALL_QUIET` will be set.
+
+      Meson uses the `DESTDIR` environment variable as set by the
+      inherited environment to determine the (temporary) installation
+      location for files. Your install script must be aware of this while
+      manipulating and installing files. The correct way to handle this is
+      with the `MESON_INSTALL_DESTDIR_PREFIX` variable which is always set
+      and contains `DESTDIR` (if set) and `prefix` joined together. This
+      is useful because both are usually absolute paths and there are
+      platform-specific edge-cases in joining two absolute paths.
+
+      In case it is needed, `MESON_INSTALL_PREFIX` is also always set and
+      has the value of the `prefix` option passed to Meson.
+
+      `MESONINTROSPECT` contains the path to the introspect command that
+      corresponds to the `meson` executable that was used to configure the
+      build. (This might be a different path than the first executable
+      found in `PATH`.) It can be used to query build configuration. Note
+      that the value will contain many parts, f.ex., it may be `python3
+      /path/to/meson.py introspect`. The user is responsible for splitting
+      the string to an array if needed by splitting lexically like a UNIX
+      shell would. If your script uses Python, `shlex.split()` is the
+      easiest correct way to do this.
+
+    posargs:
+      script_name:
+        type: str | file | external_program | exe | custom_tgt | custom_idx
+        description: |
+          The script to execute.
+
+          *(since 0.55.0)* The output of find_program, executable,
+          custom_target, as well as strings are accepted.
+
+          *(since 0.57.0)* @file objects and the output of configure_file may be used.
+
+    varargs:
+      name: arg
+      type: str | file | external_program | exe | custom_tgt | custom_idx
+      since: 0.49.0
+      description: |
+        Additional arguments
+
+        *(since 0.55.0)* The output of find_program, executable,
+        custom_target, as well as strings are accepted.
+
+    kwargs:
+      skip_if_destdir:
+        type: bool
+        since: 0.57.0
+        default: false
+        description: |
+          If `true` the script will not be run if DESTDIR is set during installation.
+          This is useful in the case the script updates system wide
+          cache that is only needed when copying files into final destination.
+
+      install_tag:
+        type: str
+        since: 0.60.0
+        description: |
+          A string used by the `meson install --tags` command
+          to install only a subset of the files.
+          By default the script has no install tag which means it is not being run when
+          `meson install --tags` argument is specified.
+
+  - name: add_postconf_script
+    returns: void
+    description: |
+      Runs the given command after all project files have been generated.
+      This script will have the environment variables
+      `MESON_SOURCE_ROOT` and `MESON_BUILD_ROOT` set.
+
+    posargs_inherit: meson.add_dist_script
+    varargs_inherit: meson.add_dist_script
+
+  - name: backend
+    returns: str
+    since: 0.37.0
+    description: |
+      Returns a string representing the current backend:
+
+      - `ninja`
+      - `vs2010`
+      - `vs2012`
+      - `vs2013`
+      - `vs2015`
+      - `vs2017`
+      - `vs2019`
+      - `vs2022`
+      - `xcode`
+
+  - name: build_root
+    returns: str
+    deprecated: 0.56.0
+    description: |
+      Returns a string with the absolute path to the build root directory.
+      This function will return the
+      build root of the parent project if called from a subproject, which is usually
+      not what you want. Try using meson.current_build_dir or meson.project_build_root.
+      In the rare cases where the root of the main project is needed,
+      use meson.global_build_root that has the same behaviour but with a more explicit
+      name.
+
+  - name: source_root
+    returns: str
+    deprecated: 0.56.0
+    description: |
+      Returns a string with the absolute path to the source root directory.
+
+      This function will return the source root of the
+      parent project if called from a subproject, which is usually not what you want.
+      Try using meson.current_source_dir or meson.project_source_root.
+      In the rare cases where the root of the main project is needed,
+      use meson.global_source_root that has the same behaviour but with a more explicit
+      name.
+
+    notes:
+      - |
+        You should use the files function
+        to refer to files in the root source directory instead of
+        constructing paths manually with meson.source_root.
+
+  - name: project_build_root
+    returns: str
+    since: 0.56.0
+    description: Returns a string with the absolute path to the build root directory of the current (sub)project.
+
+  - name: project_source_root
+    returns: str
+    since: 0.56.0
+    description: Returns a string with the absolute path to the source root directory of the current (sub)project.
+
+  - name: global_build_root
+    returns: str
+    since: 0.58.0
+    description: |
+      Returns a string with the absolute path to the build root directory.
+      This function will return the build root of the
+      main project if called from a subproject, which is usually not what you want.
+      It is usually preferable to use meson.current_build_dir or meson.project_build_root.
+
+  - name: global_source_root
+    returns: str
+    since: 0.58.0
+    description: |
+      Returns a string with the absolute path to the source root directory
+      This function will return the source root of the
+      main project if called from a subproject, which is usually not what you want.
+      It is usually preferable to use meson.current_source_dir or meson.project_source_root.
+
+  - name: current_build_dir
+    returns: str
+    description: Returns a string with the absolute path to the current build directory.
+
+  - name: current_source_dir
+    returns: str
+    description: Returns a string to the current source directory.
+    notes:
+      - |
+        **You do not need to use this function!**
+
+        When passing files from the current source directory to a function since
+        that is the default. Also, you can use the files function to
+        refer to files in the current or any other source directory instead
+        of constructing paths manually with meson.current_source_dir.
+
+  - name: get_compiler
+    returns: compiler
+    description: Returns a @compiler object describing a compiler.
+
+    posargs:
+      language:
+        type: str
+        description: |
+          The language of the compiler to return.
+
+          See our list of supported languages(Reference-tables.md#language-arguments-parameter-names).
+
+    kwargs:
+      native:
+        type: bool
+        default: false
+        description: |
+          When set to `true` Meson returns the compiler for the build
+          machine (the "native" compiler) and when `false` it returns the host
+          compiler (the "cross" compiler). If `native` is omitted, Meson
+          returns the "cross" compiler if we're currently cross-compiling and
+          the "native" compiler if we're not.
+
+  - name: get_cross_property
+    returns: any
+    deprecated: 0.58.0
+    description: |
+      Returns the given property from a cross file, the optional fallback_value
+      is returned if not cross compiling or the given property is not found.
+
+      This method is replaced by meson.get_external_property.
+
+    arg_flattening: false
+    posargs_inherit: meson.get_external_property
+    optargs_inherit: meson.get_external_property
+
+  - name: get_external_property
+    returns: any
+    since: 0.54.0
+    description: |
+      Returns the given property from a native or cross file.
+      The optional fallback_value is returned if the given property is not found.
+
+    arg_flattening: false
+
+    posargs:
+      propname:
+        type: str
+        description: Name of the property in the cross / native file.
+
+    optargs:
+      fallback_value:
+        type: any
+        description: Value to return if `propname` is not set in the machine file.
+
+    kwargs:
+      native:
+        type: bool
+        description: |
+          Setting `native` to `true` forces retrieving a variable from the
+          native file, even when cross-compiling.
+          If `native: false` or not specified, the variable is retrieved from the
+          cross-file if cross-compiling, and from the native-file when not cross-compiling.
+
+  - name: has_external_property
+    returns: bool
+    since: 0.58.0
+    description: Checks whether the given property exist in a native or cross file.
+    posargs_inherit: meson.get_external_property
+    kwargs_inherit: meson.get_external_property
+
+  - name: can_run_host_binaries
+    returns: bool
+    since: 0.55.0
+    description: |
+      Returns true if the build machine can run binaries compiled for the host.
+      This returns `true` unless you are
+      cross compiling, need a helper to run host binaries, and don't have one.
+      For example when cross compiling from Linux to Windows, one can use `wine`
+      as the helper.
+
+  - name: has_exe_wrapper
+    returns: bool
+    deprecated: 0.55.0
+    description: Use meson.can_run_host_binaries instead.
+
+  - name: install_dependency_manifest
+    returns: void
+    description: |
+      Installs a manifest file
+      containing a list of all subprojects, their versions and license
+      files to the file name given as the argument.
+
+    posargs:
+      output_name:
+        type: str
+        description: Name of the manifest file to install
+
+  - name: override_find_program
+    returns: void
+    since: 0.46.0
+    description: |
+      specifies that whenever find_program is used to find a program
+      named `progname`, Meson should not look it up on the system but
+      instead return `program`, which may either be the result of
+      find_program, configure_file or executable.
+
+      *(since 0.55.0)* If a version
+      check is passed to find_program for a program that has been overridden with
+      an executable, the current project version is used.
+
+    posargs:
+      progname:
+        type: str
+        description: The name of the program to override.
+
+      program:
+        type: exe | file | external_program
+        description: The program to set as the override for `progname`.
+
+  - name: override_dependency
+    returns: void
+    since: 0.54.0
+    description: |
+      Specifies that whenever dependency with `name` is used, Meson should not
+      look it up on the system but instead return `dep_object`, which may either be
+      the result of dependency or declare_dependency.
+
+      Doing this in a subproject allows the parent
+      project to retrieve the dependency without having to know the dependency
+      variable name: `dependency(name, fallback : subproject_name)`.
+
+    posargs:
+      name:
+        type: str
+        description: The name of the dependency to override.
+
+      dep_object:
+        type: dep
+        description: The dependency to set as the override for `name`.
+
+    kwargs:
+      native:
+        type: bool
+        default: false
+        description: |
+          If set to `true`, the dependency is always overwritten for the build machine.
+          Otherwise, the dependency is overwritten for the host machine, which
+          differs from the build machine when cross-compiling.
+
+      static:
+        type: bool
+        since: 0.60.0
+        description: |
+          Used to override static and/or shared dependencies separately.
+          If not specified it is assumed
+          `dep_object` follows `default_library` option value.
+
+  - name: is_cross_build
+    returns: bool
+    description: Returns `true` if the current build is a cross build(Cross-compilation.md) and `false` otherwise.
+
+  - name: is_subproject
+    returns: bool
+    description: Returns `true` if the current project is being built as a subproject of some other project and `false` otherwise.
+
+  - name: is_unity
+    returns: bool
+    description: Returns `true` when doing a unity build(Unity-builds.md) (multiple sources are combined before compilation to reduce build time) and `false` otherwise.
+
+  - name: project_version
+    returns: str
+    description: Returns the version string specified in project function call.
+
+  - name: project_license
+    returns: liststr
+    since: 0.45.0
+    description: Returns the array of licenses specified in project function call.
+
+  - name: project_name
+    returns: str
+    description: Returns the project name specified in the project function call.
+
+  - name: version
+    returns: str
+    description: Return a string with the version of Meson.
+
+  - name: add_devenv
+    returns: void
+    since: 0.58.0
+    description: |
+      add an @env object (returned by environment)
+      to the list of environments that will be applied when using `meson devenv`(Commands.md#devenv)
+      command line.
+
+      This is useful for developers who wish to use the project without
+      installing it, it is often needed to set for example the path to plugins
+      directory, etc. Alternatively, a list or dictionary can be passed as first
+      argument.
+
+      ``` meson
+      devenv = environment()
+      devenv.set('PLUGINS_PATH', meson.current_build_dir())
+      ...
+      meson.add_devenv(devenv)
+      ```
+
+      After configuring and compiling that project, a terminal can be opened with
+      the environment set:
+
+      ```sh
+      $ meson devenv -C <builddir>
+      $ echo $PLUGINS_PATH
+      /path/to/source/subdir
+      ```
+
+      See `meson devenv`(Commands.md#devenv) command documentation for a list of
+      environment variables that are set by default by Meson.
+
+    posargs:
+      env:
+        type: env | str | liststr | dictstr | dictliststr
+        description: |
+          The @env object to add.
+          Since *0.62.0* list of strings is allowed in dictionary values. In that
+          case values are joined using the separator.
+    kwargs:
+      separator:
+        type: str
+        since: 0.62.0
+        description: |
+          The separator to use for the initial values defined in
+          the first positional argument. If not explicitly specified, the default
+          path separator for the host operating system will be used, i.e. ';' for
+          Windows and ':' for UNIX/POSIX systems.
+      method:
+        type: str
+        since: 0.62.0
+        description: |
+          Must be one of 'set', 'prepend', or 'append'
+          (defaults to 'set'). Controls if initial values defined in the first
+          positional argument are prepended, appended or replace the current value
+          of the environment variable.

_service:tar_scm:meson-1.0.1.tar.gz/docs/yaml/builtins/target_machine.yaml Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/yaml/elementary Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/yaml/elementary/any.yaml Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/yaml/elementary/bool.yml Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/yaml/elementary/dict.yml Added

@@ -0,0 +1,47 @@
+name: dict
+long_name: Dict
+since: 0.47.0
+is_container: true
+description: |
+  Stores a mapping of strings to other objects. See dictionaries(Syntax.md#dictionaries).
+
+  You can also iterate over dictionaries with the `foreach`
+  statement(Syntax.md#foreach-statements).
+
+  *(since 0.48.0)* Dictionaries can be added (e.g. `d1 = d2 + d3` and `d1 += d2`).
+  Values from the second dictionary overrides values from the first.
+
+
+methods:
+- name: has_key
+  returns: bool
+  description: Returns `true` if the dictionary contains the key given as argument, `false` otherwise.
+
+  posargs:
+    key:
+      type: str
+      description: The key to query.
+
+- name: get
+  returns: any
+  description: |
+    returns the value for the key given as first
+    argument if it is present in the dictionary, or the optional
+    fallback value given as the second argument. If a single argument
+    was given and the key was not found, causes a fatal error
+
+  arg_flattening: false
+
+  posargs:
+    key:
+      type: str
+      description: The key to query.
+
+  optargs:
+    fallback:
+      type: any
+      description: Fallback value that is returned if the key is not in the @dict.
+
+- name: keys
+  returns: liststr
+  description: Returns an array of keys in the dictionary.

_service:tar_scm:meson-1.0.1.tar.gz/docs/yaml/elementary/int.yml Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/yaml/elementary/list.yml Added

@@ -0,0 +1,42 @@
+name: list
+long_name: List
+description: An array of elements. See arrays(Syntax.md#arrays).
+is_container: true
+
+methods:
+- name: contains
+  returns: bool
+  description: |
+    Returns `true` if the array contains the object
+    given as argument, `false` otherwise
+
+  arg_flattening: false
+
+  posargs:
+    item:
+      type: any
+      description: The item to check
+
+- name: get
+  returns: any
+  description: |
+    returns the object at the given index,
+    negative indices count from the back of the array, indexing out of
+    bounds returns the `fallback` value *(since 0.38.0)* or, if it is
+    not specified, causes a fatal error
+
+  arg_flattening: false
+
+  posargs:
+    index:
+      type: int
+      description: Index of the list position to query. Negative values start at the end of the list
+
+  optargs:
+    fallback:
+      type: any
+      description: Fallback value that is returned if the index is out of range.
+
+- name: length
+  returns: int
+  description: Returns the current size of the array / list.

_service:tar_scm:meson-1.0.1.tar.gz/docs/yaml/elementary/str.yml Added

@@ -0,0 +1,271 @@
+name: str
+long_name: String
+description: |
+  All strings(Syntax.md#strings) have the following methods. Strings
+  are immutable, all operations return their results as a new string.
+
+methods:
+
+# str.format(fmt, value...)
+- name: format
+  returns: str
+  description: |
+    Strings can be built using the string formatting functionality.
+
+    See the Meson syntax entry(Syntax.md#string-formatting) for more
+    information.
+  example: |
+    ```meson
+    template = 'string: @0@, number: @1@, bool: @2@'
+    res = template.format('text', 1, true)
+    # res now has value 'string: text, number: 1, bool: true'
+    ```
+
+  arg_flattening: false
+
+  posargs:
+    fmt:
+      description: |
+        The string to format.
+
+        The formatting works by replacing placeholders of type `@number@` with
+        the corresponding varargs.
+      type: str
+
+  varargs:
+    name: value
+    description: The values to replace the @number@ placeholders in the format string.
+    type: int | bool | str
+
+# str.replace(old, new)
+- name: replace
+  description: Search all occurrences of `old` and and replace it with `new`
+  returns: str
+  since: 0.58.0
+  example: |
+    ```meson
+    # Replaces all instances of one substring with another
+    s = 'semicolons;as;separators'
+    s = s.replace('as', 'are')
+    # 's' now has the value of 'semicolons;are;separators'
+    ```
+
+  posargs:
+    old:
+      description: The substring to search
+      type: str
+
+    new:
+      description: The replacement string
+      type: str
+
+# str.strip()
+- name: strip
+  description: Removes leading/ending spaces and newlines from the string.
+  returns: str
+  example: |
+    ```meson
+    # Similar to the Python str.strip(). Removes leading/ending spaces and newlines
+    define = ' -Dsomedefine '
+    stripped_define = define.strip()
+    # 'stripped_define' now has the value '-Dsomedefine'
+    ```
+
+  optargs:
+    strip_chars:
+      type: str
+      since: 0.43.0
+      description: All characters in this string will be stripped.
+
+# str.to_lower()
+- name: to_lower
+  description: Converts all characters to lower case
+  returns: str
+  example: |
+    ```meson
+    target = 'x86_FreeBSD'
+    lower = target.to_lower() # t now has the value 'x86_freebsd'
+    ```
+
+# str.to_upper()
+- name: to_upper
+  description: Converts all characters to upper case
+  returns: str
+  example: |
+    ```meson
+    target = 'x86_FreeBSD'
+    upper = target.to_upper() # t now has the value 'X86_FREEBSD'
+    ```
+
+# str.to_int()
+- name: to_int
+  description: Converts the string to an int and throws an error if it can't be
+  returns: int
+  example: |
+    ```meson
+    version = '1'
+    # Converts the string to an int and throws an error if it can't be
+    ver_int = version.to_int()
+    ```
+
+# str.contains()
+- name: contains
+  returns: bool
+  description: Returns `true` if string contains the string specified as the argument.
+  example: |
+    ```meson
+    target = 'x86_FreeBSD'
+    is_fbsd = target.to_lower().contains('freebsd')
+    # is_fbsd now has the boolean value 'true'
+    ```
+
+  posargs:
+    fragment:
+      type: str
+      description: The string fragment to check
+
+# str.startswith()
+- name: startswith
+  returns: bool
+  description: Returns true if string starts with the string specified as the argument.
+  posargs_inherit: str.contains
+  example: |
+    ```meson
+    target = 'x86_FreeBSD'
+    is_x86 = target.startswith('x86') # boolean value 'true'
+    ```
+
+# str.endswith()
+- name: endswith
+  returns: bool
+  description: Returns true if string ends with the string specified as the argument.
+  posargs_inherit: str.contains
+  example: |
+    ```meson
+    target = 'x86_FreeBSD'
+    is_bsd = target.to_lower().endswith('bsd') # boolean value 'true'
+    ```
+
+# str.substring()
+- name: substring
+  returns: str
+  since: 0.56.0
+  description: |
+    Returns a substring specified from `start` to `end`.
+    Both `start` and `end` arguments are optional, so, for example, `'foobar'.substring()` will return `'foobar'`.
+
+    The method accepts negative values where negative `start` is relative to the end of
+    string `len(string) - start` as well as negative `end`.
+
+  example: |
+    ```meson
+    # Similar to the Python strstart:end syntax
+    target = 'x86_FreeBSD'
+    platform = target.substring(0, 3) # prefix string value 'x86'
+    system = target.substring(4) # suffix string value 'FreeBSD'
+    ```
+
+    Example with negative values:
+
+    ```meson
+    string = 'foobar'
+    string.substring(-5, -3) # => 'oo'
+    string.substring(1, -1) # => 'ooba'
+    ```
+
+  optargs:
+    start:
+      type: int
+      description: The start position
+
+    end:
+      type: int
+      description: The end position
+
+# str.split
+- name: split
+  returns: liststr
+  description: |
+    Splits the string at the specified character
+    (or whitespace if not set) and returns the parts in an
+    array.
+
+  example: |
+    ```meson
+    # Similar to the Python str.split()
+    components = 'a b   c d '.split()
+    # components now has the value 'a', 'b', 'c', 'd'
+    components = 'a b   c d '.split(' ')
+    # components now has the value 'a', 'b', '', '', 'c', 'd', ''
+    ```
+
+  optargs:
+    split_string:
+      type: str
+      description: Specifies the character / substring where to split the string.
+
+# str.join()
+- name: join
+  returns: str
+  description: |
+    The opposite of split,
+    for example `'.'.join('a', 'b', 'c'` yields `'a.b.c'`.
+
+  example: |
+    ```meson
+    # Similar to the Python str.join()
+    output = ' '.join('foo', 'bar')
+    # Output value is 'foo bar'
+    pathsep = ':'
+    path = pathsep.join('/usr/bin', '/bin', '/usr/local/bin')
+    # path now has the value '/usr/bin:/bin:/usr/local/bin'
+    ```
+
+  varargs:
+      name: strings
+      type: str
+      since: 0.60.0
+      description: |
+        The strings to join with the current string.
+
+        Before Meson *0.60.0* this function only accepts a single positional
+        argument of the type liststr.
+
+# str.underscorify
+- name: underscorify
+  returns: str
+  description: Creates a string where every non-alphabetical non-number character is replaced with `_`.
+  example: |
+    ```meson
+    name = 'Meson Docs.txt#Reference-manual'
+    # Replaces all characters other than `a-zA-Z0-9` with `_` (underscore)
+    # Useful for substituting into #defines, filenames, etc.
+    underscored = name.underscorify()
+    # underscored now has the value 'Meson_Docs_txt_Reference_manual'
+    ```
+
+# str.version_compare
+- name: version_compare
+  returns: bool
+  description: Does semantic version comparison.
+  example: |
+    ```meson
+    version = '1.2.3'
+    # Compare version numbers semantically
+    is_new = version.version_compare('>=2.0')
+    # is_new now has the boolean value false
+    # Supports the following operators: '>', '<', '>=', '<=', '!=', '==', '='
+    ```
+
+    Meson version comparison conventions include:
+
+    ```meson
+    '3.6'.version_compare('>=3.6.0') == false
+    ```
+
+    It is best to be unambiguous and specify the full revision level to compare.
+
+  posargs:
+    compare_string:
+      type: str
+      description: The string to compare to.

_service:tar_scm:meson-1.0.1.tar.gz/docs/yaml/elementary/void.yml Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/yaml/functions Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/yaml/functions/_build_target_base.yaml Added

@@ -0,0 +1,301 @@
+name: _build_target_base
+returns: void
+description: PRIVATE
+
+posargs:
+  target_name:
+    description: The *unique* name of the build target
+    type: str
+
+varargs:
+  name: source
+  type: str | file | custom_tgt | custom_idx | generated_list
+  description: |
+    Input source to compile. The following types are supported:
+
+    - Strings relative to the current source directory
+    - @file objects defined in any preceding build file
+    - The return value of configure-time generators such as configure_file
+    - The return value of build-time generators such as
+      custom_target or generator.process
+
+    These input files can be sources, objects, libraries, or any other
+    file. Meson will automatically categorize them based on the extension
+    and use them accordingly. For instance, sources (`.c`, `.cpp`,
+    `.vala`, `.rs`, etc) will be compiled and objects (`.o`, `.obj`) and
+    libraries (`.so`, `.dll`, etc) will be linked.
+
+    With the Ninja backend, Meson will create a build-time order-only
+    dependency(https://ninja-build.org/manual.html#ref_dependencies) on
+    all generated input files, including unknown files. This is needed to
+    bootstrap the generation of the real dependencies in the
+    depfile(https://ninja-build.org/manual.html#ref_headers) generated
+    by your compiler to determine when to rebuild sources. Ninja relies on
+    this dependency file for all input files, generated and non-generated.
+    The behavior is similar for other backends.
+
+warnings:
+  - The `link_language` kwarg was broken until 0.55.0
+
+kwargs:
+  <lang>_pch:
+    type: str
+    description: precompiled header file to use for the given language
+
+  <lang>_args:
+    type: liststr
+    description: |
+      compiler flags to use for the given language;
+      eg: `cpp_args` for C++
+
+  sources:
+    type: str | file | custom_tgt | custom_idx | generated_list | structured_src
+    description: Additional source files. Same as the source varargs.
+
+  build_by_default:
+    type: bool
+    default: true
+    since: 0.38.0
+    description: |
+      Causes, when set to `true`, to have this target be built by default.
+      This means it will be built when `meson compile` is called without any
+      arguments. The default value is `true` for all built target types.
+
+  build_rpath:
+    type: str
+    since: 0.42.0
+    description: |
+      A string to add to target's rpath definition in the build dir,
+      but which will be removed on install
+
+  dependencies:
+    type: listdep
+    description: |
+      one or more dependency objects
+      created with
+      dependency or compiler.find_library
+      (for external deps) or declare_dependency
+      (for deps built by the project)
+
+  extra_files:
+    type: str | file | custom_tgt | custom_idx
+    description: |
+      Not used for the build itself but are shown as source files in IDEs
+      that group files by targets (such as Visual Studio)
+
+  gui_app:
+    type: bool
+    deprecated: 0.56.0
+    default: false
+    description: |
+      When set to true flags this target as a GUI application
+      on platforms where this makes a differerence, **deprecated** since
+      0.56.0, use `win_subsystem` instead.
+
+  link_args:
+    type: liststr
+    description: |
+      Flags to use during linking. You can use UNIX-style
+      flags here for all platforms.
+
+  link_depends:
+    type: str | file | custom_tgt | custom_idx
+    description: |
+      Strings, files, or custom targets the link step depends on
+      such as a symbol visibility map. The purpose is to
+      automatically trigger a re-link (but not a re-compile) of the target
+      when this file changes.
+
+  link_language:
+    type: str
+    since: 0.51.0
+    description: |
+      Makes the linker for this target be for the specified language.
+      It is generally unnecessary to set
+      this, as Meson will detect the right linker to use in most cases. There are
+      only two cases where this is needed. One, your main function in an
+      executable is not in the language Meson picked, or second you want to force
+      a library to use only one ABI.
+
+      *(broken until 0.55.0)*
+
+  link_whole:
+    type: listlib | custom_tgt | custom_idx
+    since: 0.40.0
+    description: |
+      Links all contents of the given static libraries
+      whether they are used by not, equivalent to the `-Wl,--whole-archive` argument flag of GCC.
+
+      *(since 0.41.0)* If passed a list that list will be flattened.
+
+      *(since 0.51.0)* This argument also accepts outputs produced by
+      custom targets. The user must ensure that the output is a library in
+      the correct format.
+
+  link_with:
+    type: listlib | custom_tgt | custom_idx
+    description: |
+      One or more shared or static libraries
+      (built by this project) that this target should be linked with. *(since 0.41.0)* If passed a
+      list this list will be flattened. *(since 0.51.0)* The arguments can also be custom targets.
+      In this case Meson will assume that merely adding the output file in the linker command
+      line is sufficient to make linking work. If this is not sufficient,
+      then the build system writer must write all other steps manually.
+
+  implicit_include_directories:
+    type: bool
+    since: 0.42.0
+    default: true
+    description: Controls whether Meson adds the current source and build directories to the include path
+
+  include_directories:
+    type: listinc | str
+    description: |
+      one or more objects created with the include_directories function,
+      or *(since 0.50.0)* strings, which will be transparently expanded to include directory objects
+
+  install:
+    type: bool
+    default: false
+    description: When set to true, this executable should be installed.
+
+  install_dir:
+    type: str
+    description: |
+      override install directory for this file. If the value is a relative path,
+      it will be considered relative the `prefix` option.
+      For example, if you want to install plugins into a subdir, you'd use
+      something like this: `install_dir : get_option('libdir') / 'projectname-1.0'`.
+
+  install_mode:
+    type: liststr | int
+    since: 0.47.0
+    description: |
+      Specify the file mode in symbolic format
+      and optionally the owner/uid and group/gid for the installed files.
+
+      See the `install_mode` kwarg of install_data for more information.
+
+  install_tag:
+    type: str
+    since: 0.60.0
+    description: |
+      A string used by the `meson install --tags` command
+      to install only a subset of the files. By default all build targets have the
+      tag `runtime` except for static libraries that have the `devel` tag.
+
+  install_rpath:
+    type: str
+    description: |
+      A string to set the target's rpath to after install
+      (but *not* before that). On Windows, this argument has no effect.
+
+  objects:
+    type: listextracted_obj | file | str
+    description: |
+      List of object files that should be linked in this target.
+      These can include third party products you don't have source to,
+      or object files produced by other build targets.
+
+  name_prefix:
+    type: str | listvoid
+    description: |
+      The string that will be used as the prefix for the
+      target output filename by overriding the default (only used for
+      libraries). By default this is `lib` on all platforms and compilers,
+      except for MSVC shared libraries where it is omitted to follow
+      convention, and Cygwin shared libraries where it is `cyg`.
+
+      Set this to ``, or omit the keyword argument for the default behaviour.
+
+  name_suffix:
+    type: str | listvoid
+    description: |
+      The string that will be used as the extension for the
+      target by overriding the default. By default on Windows this is
+      `exe` for executables and on other platforms it is omitted.
+
+      For shared libraries, the default value
+      is `dylib` on macOS, `dll` on Windows, and `so` everywhere else.
+      For static libraries, it is `a` everywhere. By convention MSVC
+      static libraries use the `lib` suffix, but we use `a` to avoid a
+      potential name clash with shared libraries which also generate
+      import libraries with a `lib` suffix.
+
+      Set this to ``, or omit the keyword argument for the default behaviour.
+
+  override_options:
+    type: liststr
+    since: 0.40.0
+    description: |
+      takes an array of strings in the same format as `project`'s `default_options`
+      overriding the values of these options
+      for this target only.
+
+  gnu_symbol_visibility:
+    type: str
+    since: 0.48.0
+    description: |
+      Specifies how symbols should be exported, see
+      e.g the GCC Wiki(https://gcc.gnu.org/wiki/Visibility) for more
+      information. This value can either be an empty string or one of
+      `default`, `internal`, `hidden`, `protected` or `inlineshidden`, which
+      is the same as `hidden` but also includes things like C++ implicit
+      constructors as specified in the GCC manual. Ignored on compilers that
+      do not support GNU visibility arguments.
+
+  d_import_dirs:
+    type: liststr
+    description: List of directories to look in for string imports used in the D programming language.
+
+  d_unittest:
+    type: bool
+    default: false
+    description: When set to true, the D modules are compiled in debug mode.
+
+  d_module_versions:
+    type: liststr | int
+    description: List of module version identifiers set when compiling D sources.
+
+  d_debug:
+    type: liststr
+    description: |
+      The D version identifiers(https://dlang.org/spec/version.html#version) to add
+      during the compilation of D source files.
+
+  native:
+    type: bool
+    default: false
+    description: Controls whether the target is compiled for the build or host machines.
+
+  win_subsystem:
+    type: str
+    default: "'console'"
+    since: 0.56.0
+    description: |
+      Specifies the subsystem type to use
+      on the Windows platform. Typical values include `console` for text
+      mode programs and `windows` for gui apps. The value can also contain
+      version specification such as `windows,6.0`. See MSDN
+      documentation(https://docs.microsoft.com/en-us/cpp/build/reference/subsystem-specify-subsystem)
+      for the full list.
+
+  rust_crate_type:
+    type: str
+    since: 0.42.0
+    description: |
+      Set the specific type of rust crate to compile (when compiling rust).
+
+      If the target is an executable this defaults to "bin", the only
+      allowed value.
+
+      If it is a static_library it defaults to "lib", and may be "lib",
+      "staticlib", or "rlib". If "lib" then Rustc will pick a default, "staticlib"
+      means a C ABI library, "rlib" means a Rust ABI.
+
+      If it is a shared_library it defaults to "lib", and may be "lib",
+      "dylib", "cdylib", or "proc-macro". If "lib" then Rustc will pick a
+      default, "cdylib" means a C ABI library, "dylib" means a Rust ABI, and
+      "proc-macro" is a special rust proceedural macro crate.
+
+      "proc-macro" is new in 0.62.0.

_service:tar_scm:meson-1.0.1.tar.gz/docs/yaml/functions/add_global_arguments.yaml Added

@@ -0,0 +1,38 @@
+name: add_global_arguments
+returns: void
+description: Adds global arguments to the compiler command line.
+
+notes:
+  - Usually you should use add_project_arguments instead,
+    because that works even when you project is used as a subproject.
+  - You must pass always arguments individually `arg1, arg2, ...`
+    rather than as a string `'arg1 arg2', ...`
+
+varargs:
+  type: str
+  name: Compiler argument
+  description: The compiler arguments to add
+
+kwargs:
+  language:
+    type: liststr
+    required: true
+    description: |
+      Specifies the language(s) that the arguments should be
+      applied to. If a list of languages is given, the arguments are added
+      to each of the corresponding compiler command lines. Note that there
+      is no way to remove an argument set in this way. If you have an
+      argument that is only used in a subset of targets, you have to specify
+      it in per-target flags.
+
+  native:
+    type: bool
+    default: false
+    since: 0.48.0
+    description: |
+      A boolean specifying whether the arguments should be
+      applied to the native or cross compilation. If `true` the arguments
+      will only be used for native compilations. If `false` the arguments
+      will only be used in cross compilations. If omitted, the flags are
+      added to native compilations if compiling natively and cross
+      compilations (only) when cross compiling.

_service:tar_scm:meson-1.0.1.tar.gz/docs/yaml/functions/add_global_link_arguments.yaml Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/yaml/functions/add_languages.yaml Added

@@ -0,0 +1,51 @@
+name: add_languages
+returns: bool
+description: |
+  Add programming languages used by the project.
+
+  This is equivalent to having
+  them in the `project` declaration. This function is usually used to
+  add languages that are only used under some conditions.
+
+  Returns `true` if all languages specified were found and `false` otherwise.
+
+  If `native` is omitted, the languages may be used for either build or host
+  machine, but are never required for the build machine.  (i.e. it is equivalent
+  to `add_languages(*langs*, native: false, required: *required*) and
+  add_languages(*langs*, native: true, required: false)`. This default behaviour
+  may change to `native: false` in a future Meson version.
+
+example: |
+  ```meson
+  project('foobar', 'c')
+
+  if compiling_for_osx
+    add_languages('objc')
+  endif
+  if add_languages('cpp', required : false)
+    executable('cpp-app', 'main.cpp')
+  endif
+
+  # More code...
+  ```
+
+varargs:
+  type: str
+  name: Language
+  description: The languages to add
+
+kwargs:
+  required:
+    type: bool
+    default: true
+    description: |
+      If set to `true`, Meson will halt if any of the languages
+      specified are not found. *(since 0.47.0)* The value of a
+      `feature`(Build-options.md#features) option can also be passed.
+  native:
+    type: bool
+    since: 0.54.0
+    description: |
+      If set to `true`, the language will be used to compile for the build
+      machine, if `false`, for the host machine.
+

_service:tar_scm:meson-1.0.1.tar.gz/docs/yaml/functions/add_project_arguments.yaml Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/yaml/functions/add_project_dependencies.yaml Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/yaml/functions/add_project_link_arguments.yaml Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/yaml/functions/add_test_setup.yaml Added

@@ -0,0 +1,60 @@
+name: add_test_setup
+returns: void
+description: |
+  Add a custom test setup. This setup can be used to run the tests with a
+  custom setup, for example under Valgrind.
+
+  To use the test setup, run `meson test --setup=*name*` inside the
+  build dir.
+
+  Note that all these options are also available while running the
+  `meson test` script for running tests instead of `ninja test` or
+  `msbuild RUN_TESTS.vcxproj`, etc depending on the backend.
+
+posargs:
+  name:
+    type: str
+    description: The name of the test setup
+
+kwargs:
+  env:
+    type: env | liststr | dictstr
+    description: |
+      environment variables to set
+      , such as `'NAME1=value1', 'NAME2=value2'`,
+      or an @env object which allows more sophisticated
+      environment juggling. *(Since 0.52.0)* A dictionary is also accepted.
+
+  exe_wrapper:
+    type: liststr | external_program
+    description: The command or script followed by the arguments to it
+
+  gdb:
+    type: bool
+    default: false
+    description: If `true`, the tests are also run under `gdb`
+
+  timeout_multiplier:
+    type: int
+    default: 1
+    description: |
+      A number to multiply the test timeout with.
+      *Since 0.57* if timeout_multiplier is `<= 0` the test has infinite duration,
+      in previous versions of Meson the test would fail with a timeout immediately.
+
+  is_default:
+    type: bool
+    since: 0.49.0
+    default: false
+    description: |
+      Set whether this is the default test setup.
+      If `true`, the setup will be used whenever `meson test` is run
+      without the `--setup` option.
+
+  exclude_suites:
+    type: liststr
+    since: 0.57.0
+    description:
+      A list of test suites that should be excluded when using this setup.
+      Suites specified in the `--suite` option
+      to `meson test` will always run, overriding `add_test_setup` if necessary.
\ No newline at end of file

_service:tar_scm:meson-1.0.1.tar.gz/docs/yaml/functions/alias_target.yaml Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/yaml/functions/assert.yaml Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/yaml/functions/benchmark.yaml Added

@@ -0,0 +1,114 @@
+name: benchmark
+returns: void
+description: |
+  Creates a benchmark item that will be run when the benchmark target is
+  run. The behavior of this function is identical to test
+  except for:
+
+  * benchmark() has no `is_parallel` keyword because benchmarks are not run in parallel
+  * benchmark() does not automatically add the `MALLOC_PERTURB_` environment variable
+
+  Defined tests can be run in a backend-agnostic way by calling
+  `meson test` inside the build dir, or by using backend-specific
+  commands, such as `ninja test` or `msbuild RUN_TESTS.vcxproj`.
+
+notes:
+  - Prior to 0.52.0 benchmark would warn that `depends` and
+    `priority` were unsupported, this is incorrect.
+
+posargs:
+  name:
+    type: str
+    description: The *unique* test id
+
+  executable:
+    type: exe | jar | external_program | file
+    description: The program to execute
+
+kwargs:
+  args:
+    type: liststr | file | tgt
+    description: Arguments to pass to the executable
+
+  env:
+    type: env | liststr | dictstr
+    description: |
+      environment variables to set, such as `'NAME1=value1',
+      'NAME2=value2'`, or an @env object which allows more sophisticated
+      environment juggling. *(Since 0.52.0)* A dictionary is also accepted.
+
+  should_fail:
+    type: bool
+    default: false
+    description: |
+      when true the test is considered passed if the
+      executable returns a non-zero return value (i.e. reports an error)
+
+  suite:
+    type: str | liststr
+    description: |
+      `'label'` (or list of labels `'label1', 'label2'`)
+      attached to this test. The suite name is qualified by a (sub)project
+      name resulting in `(sub)project_name:label`. In the case of a list
+      of strings, the suite names will be `(sub)project_name:label1`,
+      `(sub)project_name:label2`, etc.
+
+  timeout:
+    type: int
+    default: 30
+    description: |
+      the amount of seconds the test is allowed to run, a test
+      that exceeds its time limit is always considered failed, defaults to
+      30 seconds. *Since 0.57* if timeout is `<= 0` the test has infinite duration,
+      in previous versions of Meson the test would fail with a timeout immediately.
+
+  workdir:
+    type: str
+    description: |
+      absolute path that will be used as the working directory
+      for the test
+
+  depends:
+    type: listbuild_tgt | custom_tgt
+    since: 0.46.0
+    description: |
+      specifies that this test depends on the specified
+      target(s), even though it does not take any of them as a command
+      line argument. This is meant for cases where test finds those
+      targets internally, e.g. plugins or globbing. Those targets are built
+      before test is executed even if they have `build_by_default : false`.
+
+  protocol:
+    type: str
+    since: 0.50.0
+    default: "'exitcode'"
+    description: |
+      specifies how the test results are parsed and can
+      be one of `exitcode`, `tap`, or `gtest`. For more information about test
+      harness protocol read Unit Tests(Unit-tests.md). The following values are
+      accepted:
+
+      - `exitcode`: the executable's exit code is used by the test harness
+        to record the outcome of the test).
+      - `tap`: Test Anything Protocol(https://www.testanything.org/).
+      - `gtest` *(since 0.55.0)*: for Google Tests.
+      - `rust` *(since 0.56.0)*: for native rust tests
+
+  priority:
+    type: int
+    since: 0.52.0
+    default: 0
+    description: |
+      specifies the priority of a test. Tests with a
+      higher priority are *started* before tests with a lower priority.
+      The starting order of tests with identical priorities is
+      implementation-defined. The default priority is 0, negative numbers are
+      permitted.
+
+  verbose:
+    type: bool
+    since: 0.62.0
+    default: false
+    description: |
+      if true, forces the test results to be logged as if `--verbose` was passed
+      to `meson test`.

_service:tar_scm:meson-1.0.1.tar.gz/docs/yaml/functions/both_libraries.yaml Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/yaml/functions/build_target.yaml Added

@@ -0,0 +1,45 @@
+name: build_target
+returns: build_tgt
+description: |
+  Creates a build target whose type can be set dynamically with the
+  `target_type` keyword argument.
+
+  `target_type` may be set to one of:
+
+  - `executable` (see executable)
+  - `shared_library` (see shared_library)
+  - `shared_module` (see shared_module)
+  - `static_library` (see static_library)
+  - `both_libraries` (see both_libraries)
+  - `library` (see library)
+  - `jar` (see jar)
+
+  This declaration:
+
+  ```meson
+  executable(<arguments and keyword arguments>)
+  ```
+
+  is equivalent to this:
+
+  ```meson
+  build_target(<arguments and keyword arguments>, target_type : 'executable')
+  ```
+
+  The lists for the kwargs (such as `sources`, `objects`, and `dependencies`) are
+  always flattened, which means you can freely nest and add lists while
+  creating the final list.
+
+  The returned object also has methods that are documented in @build_tgt.
+
+posargs_inherit: _build_target_base
+varargs_inherit: _build_target_base
+kwargs_inherit:
+  - executable
+  - library
+  - jar
+
+kwargs:
+  target_type:
+    type: str
+    description: The actual target to build

_service:tar_scm:meson-1.0.1.tar.gz/docs/yaml/functions/configuration_data.yaml Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/yaml/functions/configure_file.yaml Added

@@ -0,0 +1,143 @@
+name: configure_file
+returns: file
+description: |
+  This function can run in three modes depending on the keyword arguments
+  passed to it.
+
+  When a @cfg_data object is passed
+  to the `configuration:` keyword argument, it takes a template file as
+  the `input:` (optional) and produces the `output:` (required) by
+  substituting values from the configuration data as detailed in the
+  configuration file documentation(Configuration.md). *(since 0.49.0)*
+  A dictionary can be passed instead of a
+  @cfg_data object.
+
+  When a list of strings is passed to the `command:` keyword argument,
+  it takes any source or configured file as the `input:` and assumes
+  that the `output:` is produced when the specified command is run.
+
+  *(since 0.47.0)* When the `copy:` keyword argument is set to `true`,
+  this function will copy the file provided in `input:` to a file in the
+  build directory with the name `output:` in the current directory.
+
+kwargs:
+  capture:
+    type: bool
+    since: 0.41.0
+    default: false
+    description: |
+      When this argument is set to true,
+      Meson captures `stdout` of the `command` and writes it to the target
+      file specified as `output`.
+
+  command:
+    type: liststr | file
+    description: |
+      As explained above, if specified, Meson does not create
+      the file itself but rather runs the specified command, which allows
+      you to do fully custom file generation. *(since 0.52.0)* The command can contain
+      file objects and more than one file can be passed to the `input` keyword
+      argument, see custom_target for details about string
+      substitutions.
+
+  configuration:
+    type: "cfg_data | dictstr | int | bool"
+    description: |
+      As explained above, when passed this will provide the replacement
+      data for the input file (if provided) or key value pairs to be
+      written to the output.
+
+  copy:
+    type: bool
+    default: false
+    since: 0.47.0
+    description: |
+      As explained above, if specified Meson only
+      copies the file from input to output.
+
+  depfile:
+    type: str
+    since: 0.52.0
+    description: |
+      A dependency file that the command can write listing
+      all the additional files this target depends on. A change
+      in any one of these files triggers a reconfiguration.
+
+  format:
+    type: str
+    since: 0.46.0
+    default: "'meson'"
+    description: |
+      The format of defines. It defaults to `'meson'`, and so substitutes
+      `#mesondefine` statements and variables surrounded by `@` characters, you can also use `'cmake'`
+      to replace `#cmakedefine` statements and variables with the `${variable}` syntax. Finally you can use
+      `'cmake@'` in which case substitutions will apply on `#cmakedefine` statements and variables with
+      the `@variable@` syntax.
+
+  input:
+    type: str | file
+    description: |
+      The input file name. If it's not specified in configuration
+      mode, all the variables in the `configuration:` object (see above)
+      are written to the `output:` file.
+
+  install:
+    type: bool
+    default: false
+    since: 0.50.0
+    description: |
+      When true, this generated file is installed during
+      the install step, and `install_dir` must be set and not empty. When false, this
+      generated file is not installed regardless of the value of `install_dir`.
+      When omitted it defaults to true when `install_dir` is set and not empty,
+      false otherwise.
+
+  install_dir:
+    type: str
+    description: |
+      The subdirectory to install the generated file to
+      (e.g. `share/myproject`), if omitted or given the value of empty
+      string, the file is not installed.
+
+  install_mode:
+    type: liststr | int
+    since: 0.47.0
+    description: |
+      Specify the file mode in symbolic format
+      and optionally the owner/uid and group/gid for the installed files.
+
+      See the `install_mode` kwarg of install_data for more information.
+
+  install_tag:
+    type: str
+    since: 0.60.0
+    description: |
+      A string used by the `meson install --tags` command
+      to install only a subset of the files. By default the file has no install
+      tag which means it is not being installed when `--tags` argument is specified.
+
+  output:
+    type: str
+    description: |
+      The output file name. *(since 0.41.0)* may contain
+      `@PLAINNAME@` or `@BASENAME@` substitutions. In configuration mode,
+      the permissions of the input file (if it is specified) are copied to
+      the output file.
+
+  output_format:
+    type: str
+    since: 0.47.0
+    description: |
+      The format of the output to generate when no input
+      was specified. It defaults to `c`, in which case preprocessor directives
+      will be prefixed with `#`, you can also use `nasm`, in which case the
+      prefix will be `%`.
+
+  encoding:
+    type: str
+    default: "'utf-8'"
+    since: 0.47.0
+    description: |
+      Set the file encoding for the input and output file.
+      The supported encodings are those of python3, see
+      standard-encodings(https://docs.python.org/3/library/codecs.html#standard-encodings).

_service:tar_scm:meson-1.0.1.tar.gz/docs/yaml/functions/custom_target.yaml Added

@@ -0,0 +1,231 @@
+name: custom_target
+returns: custom_tgt
+description: |
+  Create a custom top level build target. The only positional argument
+  is the name of this target and cannot contain path separators (`/` or `\`).
+  The name of custom target might not be used by every backends, for instance with
+  the Ninja backend, `subdir/meson.build` containing the example below,
+  `ninja -C builddir foo` or `ninja -C builddir subdir/foo` won't work,
+  it is instead `ninja -C builddir subdir/file.txt`. However, `meson compile subdir/foo`
+  is accepted.
+  ```meson
+  custom_target('foo', output: 'file.txt', ...)
+  ```
+
+  *Since 0.60.0* the name argument is optional and defaults to the basename of the first
+  output (`file.txt` in the example above).
+
+  The list of strings passed to the `command` keyword argument accept
+  the following special string substitutions:
+
+  - `@INPUT@`: the full path to the input passed to `input`. If more than
+    one input is specified, all of them will be substituted as separate
+    arguments only if the command uses `'@INPUT@'` as a
+    standalone-argument. For instance, this would not work: `command :
+    'cp', './@INPUT@'`, but this would: `command : 'cp', '@INPUT@'`.
+  - `@OUTPUT@`: the full path to the output passed to `output`. If more
+    than one outputs are specified, the behavior is the same as
+    `@INPUT@`.
+  - `@INPUT0@` `@INPUT1@` `...`: the full path to the input with the specified array index in `input`
+  - `@OUTPUT0@` `@OUTPUT1@` `...`: the full path to the output with the specified array index in `output`
+  - `@OUTDIR@`: the full path to the directory where the output(s) must be written
+  - `@DEPFILE@`: the full path to the dependency file passed to `depfile`
+  - `@PLAINNAME@`: the input filename, without a path
+  - `@BASENAME@`: the input filename, with extension removed
+  - `@PRIVATE_DIR@` *(since 0.50.1)*: path to a directory where the custom target must store all its intermediate files.
+  - `@SOURCE_ROOT@`: the path to the root of the source tree. Depending on the backend,
+    this may be an absolute or a relative to current workdir path.
+  - `@BUILD_ROOT@`: the path to the root of the build tree. Depending on the backend,
+    this may be an absolute or a relative to current workdir path.
+  - `@CURRENT_SOURCE_DIR@`: this is the directory where the currently
+    processed meson.build is located in.  Depending on the backend,
+    this may be an absolute or a relative to current workdir path.
+
+  *(since 0.47.0)* The `depfile` keyword argument also accepts the
+  `@BASENAME@` and `@PLAINNAME@` substitutions.
+
+  The returned object also has methods that are documented in @custom_tgt.
+
+notes:
+  - |
+    Assuming that `command:` is executed by a POSIX `sh` shell
+    is not portable, notably to Windows. Instead, consider using a
+    `native: true` executable, or a python script.
+
+optargs:
+  name:
+    type: str
+    description: |
+      The *unique* id of the custom target
+
+      This posarg is optional *since 0.60.0*. It defaults to the basename
+      of the first output.
+
+kwargs:
+  build_by_default:
+    type: bool
+    since: 0.38.0
+    description: |
+      Causes, when set to true, to
+      have this target be built by default. This means it will be built when
+      `meson compile` is called without any arguments. The default value is `false`.
+
+      *(since 0.50.0)* If `build_by_default` is explicitly set to false, `install`
+      will no longer override it. If `build_by_default` is not set, `install` will
+      still determine its default.
+
+  build_always:
+    type: bool
+    deprecated: 0.47.0
+    description: |
+      If `true` this target is always considered out of
+      date and is rebuilt every time.  Equivalent to setting both
+      `build_always_stale` and `build_by_default` to true.
+
+  build_always_stale:
+    type: bool
+    since: 0.47.0
+    default: false
+    description: |
+      If `true` the target is always considered out of date.
+      Useful for things such as build timestamps or revision control tags.
+      The associated command is run even if the outputs are up to date.
+
+  capture:
+    type: bool
+    default: false
+    description: |
+      There are some compilers that can't be told to write
+      their output to a file but instead write it to standard output. When
+      this argument is set to true, Meson captures `stdout` and writes it
+      to the target file. Note that your command argument list may not
+      contain `@OUTPUT@` when capture mode is active.
+
+  console:
+    type: bool
+    since: 0.48.0
+    description: |
+      Keyword argument conflicts with `capture`, and is meant
+      for commands that are resource-intensive and take a long time to
+      finish. With the Ninja backend, setting this will add this target
+      to Ninja's `console` pool(https://ninja-build.org/manual.html#_the_literal_console_literal_pool),
+      which has special properties such as not buffering stdout and
+      serializing all targets in this pool.
+
+  command:
+    type: liststr | file | exe | external_program
+    description: |
+      Command to run to create outputs from inputs. The command
+      may be strings or the return value of functions that return file-like
+      objects such as find_program,
+      executable, configure_file,
+      files, custom_target, etc.
+      Meson will automatically insert the appropriate dependencies on
+      targets and files listed in this keyword argument.
+      Note: always specify commands in array form `'commandname',
+      '-arg1', '-arg2'` rather than as a string `'commandname -arg1
+      -arg2'` as the latter will *not* work.
+
+  depend_files:
+    type: liststr | file
+    description: |
+      files (@str,
+      @file, or the return value of configure_file that
+      this target depends on but are not listed in the `command` keyword
+      argument. Useful for adding regen dependencies.
+
+  depends:
+    type: listbuild_tgt | custom_tgt
+    description: |
+      Specifies that this target depends on the specified
+      target(s), even though it does not take any of them as a command
+      line argument. This is meant for cases where you have a tool that
+      e.g. does globbing internally. Usually you should just put the
+      generated sources as inputs and Meson will set up all dependencies
+      automatically.
+
+  depfile:
+    type: str
+    description: |
+      A dependency file that the command can write listing
+      all the additional files this target depends on, for example a C
+      compiler would list all the header files it included, and a change
+      in any one of these files triggers a recompilation.
+
+      *(since 0.47.0)* the `@BASENAME@` and `@PLAINNAME@` substitutions
+      are also accepted.
+
+  input:
+    type: liststr | file
+    description: List of source files. *(since 0.41.0)* the list is flattened.
+
+  install:
+    type: bool
+    description: When true, one or more files of this target are installed during
+      the install step (see `install_dir` for details).
+
+  install_dir:
+    type: str | liststr | bool
+    description: |
+      If only one install_dir is provided, all outputs are installed there.
+      *Since 0.40.0* Allows you to specify the installation directory for each
+      corresponding output. For example:
+      ```meson
+      custom_target('different-install-dirs',
+        output : 'first.file', 'second.file',
+        install : true,
+        install_dir : 'somedir', 'otherdir')
+      ```
+      This would install `first.file` to `somedir` and `second.file` to `otherdir`.
+
+      To only install some outputs, pass `false` for the outputs that you
+      don't want installed. For example:
+      ```meson
+          custom_target('only-install-second',
+            output : 'first.file', 'second.file',
+            install : true,
+            install_dir : false, 'otherdir')
+      ```
+      This would install `second.file` to `otherdir` and not install `first.file`.
+
+  install_mode:
+    type: liststr | int
+    since: 0.47.0
+    description: |
+      The file mode and optionally the owner/uid and group/gid.
+      See the `install_mode` kwarg of install_data for more information.
+
+  install_tag:
+    type: liststr
+    since: 0.60.0
+    description: |
+      A list of strings, one per output, used by the `meson install --tags` command
+      to install only a subset of the files.
+
+      By default all outputs have no install tag which means they are not being
+      installed when `--tags` argument is specified. If only one tag is specified,
+      it is assumed that all outputs have the same tag. `false` can be used for
+      outputs that have no tag or are not installed.
+
+  output:
+    type: liststr
+    description: List of output files.
+
+  env:
+    since: 0.57.0
+    type: env | liststr | dictstr
+    description: |
+      environment variables to set, such as
+      `{'NAME1': 'value1', 'NAME2': 'value2'}` or `'NAME1=value1', 'NAME2=value2'`,
+      or an @env object which allows more
+      sophisticated environment juggling.
+
+  feed:
+    type: bool
+    since: 0.59.0
+    default: false
+    description: |
+      There are some compilers that can't be told to read
+      their input from a file and instead read it from standard input. When this
+      argument is set to `true`, Meson feeds the input file to `stdin`. Note that
+      your argument list may not contain `@INPUT@` when feed mode is active.

_service:tar_scm:meson-1.0.1.tar.gz/docs/yaml/functions/debug.yaml Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/yaml/functions/declare_dependency.yaml Added

@@ -0,0 +1,73 @@
+name: declare_dependency
+returns: dep
+description: |
+  This function returns a @dep object that
+  behaves like the return value of dependency but is
+  internal to the current build. The main use case for this is in
+  subprojects. This allows a subproject to easily specify how it should
+  be used. This makes it interchangeable with the same dependency that
+  is provided externally by the system.
+
+kwargs:
+  compile_args:
+    type: liststr
+    description: Compile arguments to use.
+
+  dependencies:
+    type: listdep
+    description: Other dependencies needed to use this dependency.
+
+  include_directories:
+    type: listinc | str
+    description: |
+      the directories to add to header search path,
+      must be @inc objects or *(since 0.50.0)* plain strings.
+
+  link_args:
+    type: liststr
+    description: Link arguments to use.
+
+  link_with:
+    type: listlib
+    description: Libraries to link against.
+
+  link_whole:
+    type: listlib
+    since: 0.46.0
+    description: Libraries to link fully, same as executable.
+
+  sources:
+    type: liststr | file | custom_tgt | custom_idx | generated_list
+    description: |
+      sources to add to targets
+      (or generated header files
+      that should be built before sources including them are built)
+
+  version:
+    type: str
+    description: |
+      the version of this dependency,
+      such as `1.2.3`. Defaults to the project version.
+
+  variables:
+    type: dictstr | liststr
+    since: 0.54.0
+    description: |
+      a dictionary of arbitrary strings,
+      this is meant to be used
+      in subprojects where special variables would be provided via cmake or
+      pkg-config. *since 0.56.0* it can also be a list of `'key=value'` strings.
+
+  d_module_versions:
+    type: str | int | liststr | int
+    since: 0.62.0
+    description: |
+      The D version identifiers(https://dlang.org/spec/version.html#version) to add
+      during the compilation of D source files.
+
+  d_import_dirs:
+    type: listinc | str
+    since: 0.62.0
+    description: |
+      the directories to add to the string search path (i.e. `-J` switch for DMD).
+      Must be @inc objects or plain strings.

_service:tar_scm:meson-1.0.1.tar.gz/docs/yaml/functions/dependency.yaml Added

@@ -0,0 +1,210 @@
+name: dependency
+returns: dep
+description: |
+  Finds an external dependency (usually a library installed on your
+  system) with the given name with `pkg-config` and with
+  CMake(Dependencies.md#cmake) if `pkg-config` fails. Additionally,
+  frameworks (OSX only) and library-specific fallback detection
+  logic(Dependencies.md#dependencies-with-custom-lookup-functionality)
+  are also supported.
+
+  *Since 0.60.0* more than one name can be provided, they will be tried in order
+  and the first name to be found will be used. The fallback subproject will be
+  used only if none of the names are found on the system. Once one of the name has
+  been found, all other names are added into the cache so subsequent calls for any
+  of those name will return the same value. This is useful in case a dependency
+  could have different names, such as `png` and `libpng`.
+
+  * Since *0.64.0* a dependency fallback can be provided by WrapDB. Simply download
+  the database locally using `meson wrap update-db` command and Meson will
+  automatically fallback to subprojects provided by WrapDB if the dependency is
+  not found on the system and the project does not ship their own `.wrap` file.
+
+  Dependencies can also be resolved in two other ways:
+
+  * if the same name was used in a `meson.override_dependency` prior to
+    the call to `dependency`, the overriding dependency will be returned
+    unconditionally; that is, the overriding dependency will be used
+    independent of whether an external dependency is installed in the system.
+    Typically, `meson.override_dependency` will have been used by a
+    subproject.
+
+  * by a fallback subproject which, if needed, will be brought into the current
+    build specification as if `subproject()`(#subproject) had been called.
+    The subproject can be specified with the `fallback` argument.  Alternatively,
+    if the `fallback` argument is absent, *since 0.55.0* Meson can
+    automatically identify a subproject as a fallback if a wrap file
+    provides(Wrap-dependency-system-manual.md#provide-section) the
+    dependency, or if a subproject has the same name as the dependency.
+    In the latter case, the subproject must use `meson.override_dependency` to
+    specify the replacement, or Meson will report a hard error.  See the
+    Wrap documentation(Wrap-dependency-system-manual.md#provide-section)
+    for more details.  This automatic search can be controlled using the
+    `allow_fallback` keyword argument.
+
+  If `dependency_name` is `''`, the dependency is always not found. So
+  with `required: false`, this always returns a dependency object for
+  which the `found()` method returns `false`, and which can be passed
+  like any other dependency to the `dependencies:` keyword argument of a
+  `build_target`. This can be used to implement a dependency which is
+  sometimes not required e.g. in some branches of a conditional, or with
+  a `fallback:` kwarg, can be used to declare an optional dependency
+  that only looks in the specified subproject, and only if that's
+  allowed by `--wrap-mode`.
+
+  The returned object @dep also has additional methods.
+
+notes:
+  - This function supports additional library-specific(Dependencies.md#dependencies-with-custom-lookup-functionality)
+    keyword arguments that may also be accepted (e.g. `modules` specifies submodules to use for
+    dependencies such as Qt5 or Boost. `components` allows the user to manually
+    add CMake `COMPONENTS` for the `find_package` lookup)
+
+varargs:
+  name: names
+  type: str
+  since: 0.60.0
+  min_varargs: 1
+  description: |
+    The names of the dependency to look up. The dependencies are looked up in
+    the order they are provided here. The first found dependency will then be
+    used. The fallback subproject will be used only if none of the names are
+    found on the system. Once one of the name has been found, all other names
+    are added into the cache so subsequent calls for any of those name will
+    return the same value. This is useful in case a dependency could have
+    different names, such as `png` and `libpng`.
+
+    **NOTE:** Before *0.60.0* only a single dependency name was allowed.
+
+kwargs:
+  default_options:
+    type: liststr
+    since: 0.38.0
+    description: |
+      An array of default option values
+      that override those set in the subproject's `meson_options.txt`
+      (like `default_options` in project, they only have
+      effect when Meson is run for the first time, and command line
+      arguments override any default options in build files)
+
+  allow_fallback:
+    type: bool
+    since: 0.56.0
+    description: |
+      Specifies whether Meson should automatically pick a fallback subproject
+      in case the dependency
+      is not found in the system.  If `true` and the dependency is not found
+      on the system, Meson will fallback to a subproject that provides this
+      dependency. If `false`, Meson will not fallback even if a subproject
+      provides this dependency.  By default, Meson will do so if `required`
+      is `true` or  `enabled`(Build-options.md#features); see the Wrap
+      documentation(Wrap-dependency-system-manual.md#provide-section)
+      for more details.
+
+  fallback:
+    type: liststr | str
+    description: |
+      Manually specifies a subproject fallback
+      to use in case the dependency is not found in the system.
+      This is useful if the automatic search is not applicable or if you
+      want to support versions of Meson older than 0.55.0.  If the value is an
+      array `'subproj_name', 'subproj_dep'`, the first value is the name
+      of the subproject and the second is the variable name in that
+      subproject that contains a dependency object such as the return
+      value of declare_dependency or
+      dependency, etc. Note that this means the
+      fallback dependency may be a not-found dependency, in which
+      case the value of the `required:` kwarg will be obeyed.
+      *Since 0.54.0* the value can be a single string, the subproject name;
+      in this case the subproject must use
+      `meson.override_dependency('dependency_name', subproj_dep)`
+      to specify the dependency object used in the superproject.
+      If the value is an empty list, it has the same effect as
+      `allow_fallback: false`.
+
+  language:
+    type: str
+    since: 0.42.0
+    description: |
+      Defines what language-specific dependency to find
+      if it's available for multiple languages.
+
+  method:
+    type: str
+    since: 0.40.0
+    default: "'auto'"
+    description: |
+      Defines the way the dependency is detected, the default is
+      `auto` but can be overridden to be e.g. `qmake` for Qt development,
+      and different dependencies support different values(
+      Dependencies.md#dependencies-with-custom-lookup-functionality)
+      for this (though `auto` will work on all of them)
+
+  native:
+    type: bool
+    default: false
+    description: |
+      If set to `true`, causes Meson to find the dependency on
+      the build machine system rather than the host system (i.e. where the
+      cross compiled binary will run on), usually only needed if you build
+      a tool to be used during compilation.
+
+  not_found_message:
+    type: str
+    since: 0.50.0
+    description: An optional string that will be printed as a message if the dependency was not found.
+
+  required:
+    type: bool | feature
+    default: true
+    description: |
+      When set to `false`, Meson will proceed with the build
+      even if the dependency is not found.
+
+      When set to a `feature`(Build-options.md#features) option, the feature
+      will control if it is searched and whether to fail if not found.
+
+      *(since 0.47.0)* The value of a `feature` option can also be passed.
+
+  static:
+    type: bool
+    default: false
+    description: |
+      Tells the dependency provider to try to get static
+      libraries instead of dynamic ones (note that this is not supported
+      by all dependency backends)
+
+      *Since 0.60.0* it also sets `default_library` option accordingly on the fallback
+      subproject if it was not set explicitly in `default_options` keyword argument.
+
+  version:
+    type: str
+    since: 0.37.0
+    description: |
+      Specifies the required version,
+      a string containing a
+      comparison operator followed by the version string, examples include
+      `>1.0.0`, `<=2.3.5` or `3.1.4` for exact matching.
+      You can also specify multiple restrictions by passing a list to this
+      keyword argument, such as: `'>=3.14.0', '<=4.1.0'`.
+      These requirements are never met if the version is unknown.
+
+  include_type:
+    type: str
+    default: "'preserve'"
+    since: 0.52.0
+    description: |
+      An enum flag, marking how the dependency
+      flags should be converted. Supported values are `'preserve'`, `'system'` and
+      `'non-system'`. System dependencies may be handled differently on some
+      platforms, for instance, using `-isystem` instead of `-I`, where possible.
+      If `include_type` is set to `'preserve'`, no additional conversion will be
+      performed.
+
+  disabler:
+    type: bool
+    default: false
+    since: 0.49.0
+    description: |
+      Returns a disabler object instead of a not-found dependency
+      if this kwarg is set to `true` and the dependency couldn't be found.

_service:tar_scm:meson-1.0.1.tar.gz/docs/yaml/functions/disabler.yaml Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/yaml/functions/environment.yaml Added

@@ -0,0 +1,35 @@
+name: environment
+returns: env
+since: 0.35.0
+description: Returns an empty @env object.
+
+arg_flattening: false
+
+optargs:
+  env:
+    type: str | liststr | dictstr | dictliststr
+    since: 0.52.0
+    description: |
+      If provided, each key/value pair is added into the @env object
+      as if env.set method was called for each of them.
+      Since *0.62.0* list of strings is allowed in dictionary values. In that
+      case values are joined using the separator.
+
+kwargs:
+  separator:
+    type: str
+    since: 0.62.0
+    description: |
+      The separator to use for the initial values defined in
+      the first positional argument. If not explicitly specified, the default
+      path separator for the host operating system will be used, i.e. ';' for
+      Windows and ':' for UNIX/POSIX systems.
+
+  method:
+    type: str
+    since: 0.62.0
+    description: |
+      Must be one of 'set', 'prepend', or 'append'
+      (defaults to 'set'). Controls if initial values defined in the first
+      positional argument are prepended, appended or replace the current value
+      of the environment variable.

_service:tar_scm:meson-1.0.1.tar.gz/docs/yaml/functions/error.yaml Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/yaml/functions/executable.yaml Added

@@ -0,0 +1,46 @@
+name: executable
+returns: exe
+description: |
+  Creates a new executable. The first argument specifies its name and
+  the remaining positional arguments define the input files to use.
+
+  The lists for the kwargs (such as `sources`, `objects`, and `dependencies`) are
+  always flattened, which means you can freely nest and add lists while
+  creating the final list.
+
+  The returned object also has methods that are documented in @exe.
+
+warnings:
+  - The `link_language` kwarg was broken until 0.55.0
+
+posargs_inherit: _build_target_base
+varargs_inherit: _build_target_base
+kwargs_inherit: _build_target_base
+
+kwargs:
+  export_dynamic:
+    type: bool
+    since: 0.45.0
+    description: |
+       when set to true causes the target's symbols to be
+        dynamically exported, allowing modules built using the
+        shared_module function to refer to functions,
+        variables and other symbols defined in the executable itself. Implies
+        the `implib` argument.
+
+  implib:
+    type: bool | str
+    since: 0.42.0
+    description: |
+      When set to true, an import library is generated for the
+      executable (the name of the import library is based on *exe_name*).
+      Alternatively, when set to a string, that gives the base name for
+      the import library.  The import library is used when the returned
+      build target object appears in `link_with:` elsewhere.  Only has any
+      effect on platforms where that is meaningful (e.g. Windows). Implies
+      the `export_dynamic` argument.
+
+  pie:
+    type: bool
+    since: 0.49.0
+    description: Build a position-independent executable.

_service:tar_scm:meson-1.0.1.tar.gz/docs/yaml/functions/files.yaml Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/yaml/functions/find_program.yaml Added

@@ -0,0 +1,112 @@
+name: find_program
+returns: external_program
+description: |
+  `program_name` here is a string that can be an executable or script
+  to be searched for in `PATH` or other places inside the project.
+  The search order is:
+
+  1. Program overrides set via meson.override_find_program
+  1. `provide` sections(Wrap-dependency-system-manual.md#provide-section)
+    in subproject wrap files, if `wrap_mode`(Builtin-options.md#core-options) is
+    set to `forcefallback`
+  1. `binaries` section(Machine-files.md#binaries) in your machine files
+  1. Directories provided using the `dirs:` kwarg (see below)
+  1. Project's source tree relative to the current subdir
+     - If you use the return value of configure_file, the
+       current subdir inside the build tree is used instead
+  1. `PATH` environment variable
+  1. `provide` sections(Wrap-dependency-system-manual.md#provide-section) in
+    subproject wrap files, if `wrap_mode`(Builtin-options.md#core-options) is
+    set to anything other than `nofallback`
+
+  Meson will also autodetect scripts with a shebang line and run them
+  with the executable/interpreter specified in it both on Windows
+  (because the command invocator will reject the command otherwise) and
+  Unixes (if the script file does not have the executable bit set).
+  Hence, you *must not* manually add the interpreter while using this
+  script as part of a list of commands. Since *0.50.0* if the "python3"
+  program is requested and it is not found in the system, Meson will return
+  its current interpreter.
+
+  If you need to check for a program in a non-standard location, you can
+  just pass an absolute path to `find_program`, e.g.
+
+  ```meson
+  setcap = find_program('setcap', '/usr/sbin/setcap', '/sbin/setcap', required : false)
+  ```
+
+  It is also possible to pass an array to `find_program` in case you
+  need to construct the set of paths to search on the fly:
+
+  ```meson
+  setcap = find_program('setcap', '/usr/sbin/setcap', '/sbin/setcap', required : false)
+  ```
+
+  The returned @external_program object also has documented methods.
+
+posargs:
+  program_name:
+    type: str | file
+    description: |
+      The name of the program to search, or a @file object to be used
+      without searching.
+
+varargs:
+  name: fallback
+  type: str | file
+  since: 0.37.0
+  description: |
+    These parameters are used as fallback names to search for.
+    This is meant to be used for cases where the
+    program may have many alternative names, such as `foo` and
+    `foo.py`. The function will check for the arguments one by one and the
+    first one that is found is returned.
+
+kwargs:
+  required:
+    type: bool | feature
+    default: true
+    description: |
+      When `true`, Meson will abort if no program can be found.
+      If `required` is set to `false`,
+      Meson continue even if none of the programs can be found. You can
+      then use the `.found()` method on the returned @external_program to check
+      whether it was found or not. *(since 0.47.0)* The value of a
+      `feature`(Build-options.md#features) option can also be passed to the
+      `required` keyword argument.
+
+  native:
+    type: bool
+    default: false
+    since: 0.43.0
+    description: |
+      Defines how this executable should be searched. By default
+      it is set to `false`, which causes Meson to first look for the
+      executable in the cross file (when cross building) and if it is not
+      defined there, then from the system. If set to `true`, the cross
+      file is ignored and the program is only searched from the system.
+
+  disabler:
+    type: bool
+    since: 0.49.0
+    default: false
+    description: |
+      If `true` and the program couldn't be found, return a @disabler object
+      instead of a not-found object.
+
+  version:
+    type: str
+    since: 0.52.0
+    description: |
+      specifies the required version, see
+      dependency for argument format. The version of the program
+      is determined by running `program_name --version` command. If stdout is empty
+      it fallbacks to stderr. If the output contains more text than simply a version
+      number, only the first occurrence of numbers separated by dots is kept.
+      If the output is more complicated than that, the version checking will have to
+      be done manually using run_command.
+
+  dirs:
+    type: liststr
+    since: 0.53.0
+    description: extra list of absolute paths where to look for program names.

_service:tar_scm:meson-1.0.1.tar.gz/docs/yaml/functions/generator.yaml Added

@@ -0,0 +1,83 @@
+name: generator
+returns: generator
+description: |
+  See also: custom_target
+
+  This function creates a @generator object that can
+  be used to run custom compilation commands. The only positional
+  argument is the executable to use. It can either be a self-built
+  executable or one returned by find_program.
+
+  The template strings passed to all the keyword arguments accept
+  the following special substitutions:
+
+  - `@PLAINNAME@`: the complete input file name, e.g: `foo.c` becomes `foo.c` (unchanged)
+  - `@BASENAME@`: the base of the input filename, e.g.: `foo.c.y` becomes `foo.c` (extension is removed)
+
+  Each string passed to the `output` keyword argument *must* be
+  constructed using one or both of these two substitutions.
+
+  In addition to the above substitutions, the `arguments` keyword
+  argument also accepts the following:
+
+  - `@OUTPUT@`: the full path to the output file
+  - `@INPUT@`: the full path to the input file
+  - `@DEPFILE@`: the full path to the depfile
+  - `@SOURCE_DIR@`: the full path to the root of the source tree
+  - `@CURRENT_SOURCE_DIR@`: this is the directory where the currently processed meson.build is located in
+  - `@BUILD_DIR@`: the full path to the root of the build dir where the output will be placed
+
+  NOTE: Generators should only be used for outputs that will ***only***
+  be used as inputs for a build_target or a custom_target.
+  When you use the processed output of a
+  generator in multiple targets, the generator will be run multiple
+  times to create outputs for each target. Each output will be created
+  in a target-private directory `@BUILD_DIR@`.
+
+  If you want to generate files for general purposes such as for
+  generating headers to be used by several sources, or data that will be
+  installed, and so on, use a custom_target instead.
+
+posargs:
+  exe:
+    type: exe | external_program
+    description: Executable for the command to run
+
+kwargs:
+  arguments:
+    type: liststr
+    description: A list of template strings that will be the command line arguments passed to the executable.
+
+  depends:
+    # Not sure why this is not just `target`
+    type: listbuild_tgt | custom_tgt
+    since: 0.51.0
+    description: |
+      An array of build targets that must be built before
+      this generator can be run. This is used if you have a generator that calls
+      a second executable that is built in this project.
+
+  depfile:
+    type: str
+    description: |
+      A template string pointing to a dependency file that a
+      generator can write listing all the additional files this target
+      depends on, for example a C compiler would list all the header files
+      it included, and a change in any one of these files triggers a
+      recompilation,
+
+  output:
+    type: liststr
+    description: |
+      Template string (or list of template strings) defining
+      how an output file name is (or multiple output names are) generated
+      from a single source file name.
+
+  capture:
+    type: bool
+    default: false
+    since: 0.43.0
+    description: |
+      When this argument is set to true, Meson captures `stdout`
+      of the `executable` and writes it to the target file
+      specified as `output`.

_service:tar_scm:meson-1.0.1.tar.gz/docs/yaml/functions/get_option.yaml Added

@@ -0,0 +1,26 @@
+name: get_option
+returns: str | int | bool | feature | liststr | int | bool
+description: |
+  Obtains the value of the project build option(Build-options.md)
+  specified in the positional argument.
+
+  Note that the value returned for built-in options that end in `dir`
+  such as `bindir` and `libdir` is usually a path relative to (and
+  inside) the `prefix` but you should not rely on that, as it can also
+  be an absolute path in some cases(Builtin-options.md#universal-options).
+  `install_dir` arguments(Installing.md) handle that as expected
+  but if you need an absolute path, e.g. to use in a define etc.,
+  you should use the path concatenation operator like this:
+  `get_option('prefix') / get_option('localstatedir')`.
+  Never manually join paths as if they were strings.
+
+  For options of type `feature` a
+  @feature option object
+  is returned instead of a string.
+  See `feature` options(Build-options.md#features)
+  documentation for more details.
+
+posargs:
+  option_name:
+    type: str
+    description: Name of the option to query

_service:tar_scm:meson-1.0.1.tar.gz/docs/yaml/functions/get_variable.yaml Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/yaml/functions/import.yaml Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/yaml/functions/include_directories.yaml Added

@@ -0,0 +1,72 @@
+name: include_directories
+returns: inc
+description: |
+  Returns an opaque object which contains the directories (relative to
+  the current directory) given in the positional arguments. The result
+  can then be passed to the `include_directories:` keyword argument when
+  building executables or libraries. You can use the returned object in
+  any subdirectory you want, Meson will make the paths work
+  automatically.
+
+  Note that this function call itself does not add the directories into
+  the search path, since there is no global search path. For something
+  like that, see `add_project_arguments()`(#add_project_arguments).
+
+  See also `implicit_include_directories` parameter of
+  executable, which adds current source and build
+  directories to include path.
+
+  Each directory given is converted to two include paths: one that is
+  relative to the source root and one relative to the build root.
+
+example: |
+  For example, with the following source tree layout in
+  `/home/user/project.git`:
+
+  `meson.build`:
+  ```meson
+  project(...)
+
+  subdir('include')
+  subdir('src')
+
+  ...
+  ```
+
+  `include/meson.build`:
+  ```meson
+  inc = include_directories('.')
+
+  ...
+  ```
+
+  `src/meson.build`:
+  ```meson
+  sources = ...
+
+  executable('some-tool', sources,
+    include_directories : inc,
+    ...)
+
+  ...
+  ```
+
+  If the build tree is `/tmp/build-tree`, the following include paths
+  will be added to the `executable()` call: `-I/tmp/build-tree/include
+  -I/home/user/project.git/include`.
+
+varargs:
+  name: includes
+  type: str
+  description: Include paths to add.
+
+kwargs:
+  is_system:
+    type: bool
+    default: false
+    description: |
+      If set to `true`, flags the specified directories as system directories.
+      This means that
+      they will be used with the `-isystem` compiler argument rather than
+      `-I` on compilers that support this flag (in practice everything
+      except Visual Studio).

_service:tar_scm:meson-1.0.1.tar.gz/docs/yaml/functions/install_data.yaml Added

@@ -0,0 +1,66 @@
+name: install_data
+returns: void
+description: |
+  Installs files from the source tree that are listed as positional arguments.
+
+  See Installing(Installing.md) for more examples.
+
+varargs:
+  name: file
+  type: file | str
+  description: Files to install.
+
+kwargs:
+  install_dir:
+    type: str
+    description: |
+      The absolute or relative path to the installation directory.
+      If this is a relative path, it is assumed to be relative to the prefix.
+
+      If omitted, the directory defaults to `{datadir}/{projectname}` *(since 0.45.0)*.
+
+  install_mode:
+    type: liststr | int
+    since: 0.38.0
+    description: |
+      specify the file mode in symbolic format and
+      optionally the owner/uid and group/gid for the installed files. For
+      example:
+
+      `install_mode: 'rw-r--r--'` for just the file mode
+
+      `install_mode: 'rw-r--r--', 'nobody', 'nogroup'` for the file mode and the user/group
+
+      `install_mode: 'rw-r-----', 0, 0` for the file mode and uid/gid
+
+      To leave any of these three as the default, specify `false`.
+
+  install_tag:
+    type: str
+    since: 0.60.0
+    description: |
+      A string used by the `meson install --tags` command
+      to install only a subset of the files. By default these files have no install
+      tag which means they are not being installed when `--tags` argument is specified.
+
+  preserve_path:
+    type: bool
+    since: 0.64.0
+    default: false
+    description: |
+      Disable stripping child-directories from data files when installing.
+
+      This is equivalent to GNU Automake's `nobase` option.
+
+  rename:
+    type: liststr
+    since: 0.46.0
+    description: |
+      If specified renames each source file into corresponding file from `rename` list.
+      Nested paths are allowed and they are
+      joined with `install_dir`. Length of `rename` list must be equal to
+      the number of sources.
+
+  sources:
+    type: listfile | str
+    description: Additional files to install.

_service:tar_scm:meson-1.0.1.tar.gz/docs/yaml/functions/install_emptydir.yaml Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/yaml/functions/install_headers.yaml Added

@@ -0,0 +1,72 @@
+name: install_headers
+returns: void
+description: |
+  Installs the specified header files from the source tree into the
+  system header directory (usually `/{prefix}/include`) during the
+  install step. This directory can be overridden by specifying it with
+  the `install_dir` keyword argument. If you just want to install into a
+  subdirectory of the system header directory, then use the `subdir`
+  argument. As an example if this has the value `myproj` then the
+  headers would be installed to `/{prefix}/include/myproj`.
+
+example: |
+  For example, this will install `common.h` and `kola.h` into
+  `/{prefix}/include`:
+
+  ```meson
+  install_headers('common.h', 'proj/kola.h')
+  ```
+
+  This will install `common.h` and `kola.h` into `/{prefix}/include/myproj`:
+
+  ```meson
+  install_headers('common.h', 'proj/kola.h', subdir : 'myproj')
+  ```
+
+  This will install `common.h` and `kola.h` into `/{prefix}/cust/myproj`:
+
+  ```meson
+  install_headers('common.h', 'proj/kola.h', install_dir : 'cust', subdir : 'myproj')
+  ```
+
+  This will install `common.h` into `/{prefix}/include` and `kola.h`
+  into `/{prefix}/include/proj/`:
+
+  ```meson
+  install_headers('common.h, 'proj/kola.h', preserve_path : true)
+  ```
+
+varargs:
+  name: file
+  type: file | str
+  description: Header files to install.
+
+kwargs:
+  install_dir:
+    type: str
+    description: Where to install to.
+
+  subdir:
+    type: str
+    description: |
+      Install to the `subdir` subdirectory of the default includedir.
+
+      Incompatible with the `install_dir` kwarg.
+
+  install_mode:
+    type: liststr | int
+    since: 0.47.0
+    description: |
+      Specify the file mode in symbolic format
+      and optionally the owner/uid and group/gid for the installed files.
+
+      See the `install_mode` kwarg of install_data for more information.
+
+  preserve_path:
+    type: bool
+    since: 0.63.0
+    default: false
+    description: |
+      Disable stripping child-direcories from header files when installing.
+
+      This is equivalent to GNU Automake's `nobase` option.

_service:tar_scm:meson-1.0.1.tar.gz/docs/yaml/functions/install_man.yaml Added

@@ -0,0 +1,40 @@
+name: install_man
+returns: void
+description: |
+  Installs the specified man files from the source tree into system's man directory
+  during the install step. This directory can be
+  overridden by specifying it with the `install_dir` keyword argument.
+
+  *(since 0.49.0)* manpages are no longer compressed implicitlyinstall_man_49.
+
+  install_man_49:
+  https://mesonbuild.com/Release-notes-for-0-49-0.html#manpages-are-no-longer-compressed-implicitly
+
+varargs:
+  name: file
+  type: file | str
+  description: Man pages to install.
+
+kwargs:
+  install_mode:
+    type: liststr | int
+    since: 0.47.0
+    description: |
+      Specify the file mode in symbolic format
+      and optionally the owner/uid and group/gid for the installed files.
+
+      See the `install_mode` kwarg of install_data for more information.
+
+  install_dir:
+    type: str
+    description: Where to install to.
+
+  locale:
+    type: str
+    since: 0.58.0
+    description: |
+      Can be used to specify the locale
+      into which the
+      man page will be installed within the manual page directory tree.
+      An example manual might be `foo.fr.1` with a locale of `fr`, such
+      that `{mandir}/{locale}/man{num}/foo.1` becomes the installed file.

_service:tar_scm:meson-1.0.1.tar.gz/docs/yaml/functions/install_subdir.yaml Added

@@ -0,0 +1,105 @@
+name: install_subdir
+returns: void
+description: |
+  Installs the entire given subdirectory and its contents from the
+  source tree to the location specified by the keyword argument
+  `install_dir`.
+
+  *(since 0.45.0, deprecated since 0.60.0)* If the subdirectory does not exist
+  in the source tree, an empty directory is created in the specified location.
+  A newly created subdirectory may only be created in the keyword argument
+  `install_dir`. There are a number of flaws with this method, and it was never
+  intentionally designed to work this way, please use install_emptydir
+  instead.
+
+example: |
+  For a given directory `foo`:
+  ```text
+  foo/
+    bar/
+      file1
+    file2
+  ```
+  `install_subdir('foo', install_dir : 'share', strip_directory : false)` creates
+  ```text
+  share/
+    foo/
+      bar/
+        file1
+      file2
+  ```
+
+  `install_subdir('foo', install_dir : 'share', strip_directory : true)` creates
+  ```text
+  share/
+    bar/
+      file1
+    file2
+  ```
+
+  `install_subdir('foo/bar', install_dir : 'share', strip_directory : false)` creates
+  ```text
+  share/
+    bar/
+      file1
+  ```
+
+  `install_subdir('foo/bar', install_dir : 'share', strip_directory : true)` creates
+  ```text
+  share/
+    file1
+  ```
+
+  `install_subdir('new_directory', install_dir : 'share')` creates
+  ```text
+  share/
+    new_directory/
+  ```
+
+posargs:
+  subdir_name:
+    type: str
+    description: The sub-directory to install
+
+kwargs:
+  install_mode:
+    type: liststr | int
+    since: 0.47.0
+    description: |
+      Specify the file mode in symbolic format
+      and optionally the owner/uid and group/gid for the installed files.
+
+      See the `install_mode` kwarg of install_data for more information.
+
+  install_tag:
+    type: str
+    since: 0.60.0
+    description: |
+      A string used by the `meson install --tags` command
+      to install only a subset of the files. By default these files have no install
+      tag which means they are not being installed when `--tags` argument is specified.
+
+  exclude_files:
+    type: liststr
+    description: |
+      A list of file names that should not be installed.
+      Names are interpreted as paths relative to the `subdir_name` location.
+
+  exclude_directories:
+    type: liststr
+    since: 0.47.0
+    description: |
+      A list of directory names that should not be installed.
+      Names are interpreted as paths relative to the `subdir_name` location.
+
+  install_dir:
+    type: str
+    description: Where to install to.
+
+  strip_directory:
+    type: bool
+    since: 0.45.0
+    default: false
+    description: |
+      Install directory contents.
+      If `strip_directory=true` only the last component of the source path is used.

_service:tar_scm:meson-1.0.1.tar.gz/docs/yaml/functions/install_symlink.yaml Added

@@ -0,0 +1,34 @@
+name: install_symlink
+returns: void
+since: 0.61.0
+description: |
+  Installs a symbolic link to `pointing_to` target under install_dir.
+
+posargs:
+  link_name:
+    type: str
+    description: |
+      Name of the created link under `install_dir`.
+      It cannot contain path separators. Those should go in `install_dir`.
+
+kwargs:
+  pointing_to:
+    type: str
+    required: true
+    description: |
+      Target to point the link to.
+      Can be absolute or relative and that will be respected when creating the link.
+
+  install_dir:
+    type: str
+    required: true
+    description: |
+      The absolute or relative path to the installation directory for the links.
+      If this is a relative path, it is assumed to be relative to the prefix.
+
+  install_tag:
+    type: str
+    description: |
+      A string used by the `meson install --tags` command
+      to install only a subset of the files. By default these files have no install
+      tag which means they are not being installed when `--tags` argument is specified.

_service:tar_scm:meson-1.0.1.tar.gz/docs/yaml/functions/is_disabler.yaml Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/yaml/functions/is_variable.yaml Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/yaml/functions/jar.yaml Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/yaml/functions/join_paths.yaml Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/yaml/functions/library.yaml Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/yaml/functions/message.yaml Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/yaml/functions/project.yaml Added

@@ -0,0 +1,98 @@
+name: project
+returns: void
+description: |
+  The first function called in each project, to initialize Meson.
+
+  The first argument to this function must be a string defining the name
+  of this project.
+
+  The project name can be any string you want, it's not used for
+  anything except descriptive purposes. However since it is written to
+  e.g. the dependency manifest is usually makes sense to have it be the
+  same as the project tarball or pkg-config name. So for example you
+  would probably want to use the name _libfoobar_ instead of _The Foobar
+  Library_.
+
+  It may be followed by the list of programming languages that the project uses.
+
+  *(since 0.40.0)* The list of languages is optional.
+
+  These languages may be used both for `native: false` (the default)
+  (host machine) targets and for `native: true` (build machine) targets.
+  *(since 0.56.0)* The build machine compilers for the specified
+  languages are not required.
+
+  Supported values for languages are `c`, `cpp` (for `C++`), `cuda`, `d`,
+  `objc`, `objcpp`, `fortran`, `java`, `cs` (for `C#`), `vala` and `rust`.
+
+posargs:
+  project_name:
+    type: str
+    description: The name of the project.
+
+varargs:
+  name: language
+  type: str
+  description: The languages that Meson should initialize.
+
+kwargs:
+  default_options:
+    type: liststr
+    description: |
+      Accecpts strings in the form `key=value`
+      which have the same format as options to `meson configure`.
+      For example to set the default project type you would
+      set this: `default_options : 'buildtype=debugoptimized'`. Note
+      that these settings are only used when running Meson for the first
+      time. Global options such as `buildtype` can only be specified in
+      the master project, settings in subprojects are ignored. Project
+      specific options are used normally even in subprojects.
+
+  version:
+    type: str | file
+    description: |
+      A free form string describing the version of this project.
+      You can access the value in your Meson build files
+      with meson.project_version. *(Since 0.57.0)* this can also be a
+      @file object pointing to a file that contains exactly one line of
+      text.
+
+  meson_version:
+    type: str
+    description: |
+      Takes a string describing which Meson version the project requires.
+      Usually something like `>=0.28.0`.
+
+  license:
+    type: str | liststr
+    description: |
+      Takes a string or array of strings describing the license(s) the code is under.
+
+      This *should* be an SPDX license expression(https://spdx.dev/ids/),
+      using the standardized license identifier from the SPDX license
+      list(https://spdx.org/licenses/).  Usually this would be something like
+      `license : 'GPL-2.0-or-later'`. If there are multiple licenses you can use the
+      `AND` and `OR` operators to join them: `license : 'Apache-2.0 OR GPL-2.0'`.
+
+      For backwards compatibility reasons you can also pass an array of
+      licenses here. This is not recommended, as it is ambiguous: `license :
+      'Apache-2.0', 'GPL-2.0-only'` instead use an SPDX espression: `license
+      : 'Apache-2.0 OR GPL-2.0-only'`, which makes it clear that the license
+      mean OR, not AND.
+
+      Note that the text is informal and is only written to the dependency
+      manifest. Meson does not do any license validation, you are responsible
+      for verifying that you abide by all licensing terms. You can access the
+      value in your Meson build files with `meson.project_license()`.
+
+  subproject_dir:
+    type: str
+    default: "'subprojects'"
+    description: |
+      Specifies the top level directory name that holds Meson subprojects.
+      This is only meant as a compatibility option
+      for existing code bases that house their embedded source code in a
+      custom directory. All new projects should not set this but instead
+      use the default value. It should be noted that this keyword
+      argument is ignored inside subprojects. There can be only one
+      subproject dir and it is set in the top level Meson file.

_service:tar_scm:meson-1.0.1.tar.gz/docs/yaml/functions/range.yaml Added

@@ -0,0 +1,44 @@
+name: range
+returns: range
+since: 0.58.0
+description: |
+  Return an opaque object that can be only be used in `foreach` statements.
+
+  <pre><code class="language-meson">@range range(@int <b>stop</b>)
+  @range range(@int <b>start</b>, @int <b>stop</b>, @int <b>step</b>)</code></pre>
+
+  - `start` must be integer greater or equal to 0. Defaults to 0.
+  - `stop` must be integer greater or equal to `start`.
+  - `step` must be integer greater or equal to 1. Defaults to 1.
+
+  It cause the `foreach` loop to be called with the value from `start` included
+  to `stop` excluded with an increment of `step` after each loop.
+
+example: |
+  ```meson
+  # Loop 15 times with i from 0 to 14 included.
+  foreach i : range(15)
+    ...
+  endforeach
+  ```
+
+  The range object can also be assigned to a variable and indexed.
+  ```meson
+  r = range(5, 10, 2)
+  assert(r2 == 9)
+  ```
+
+optargs:
+  start:
+    type: int
+    default: 0
+    description: The start of the range
+
+  stop:
+    type: int
+    description: The end of the range
+
+  step:
+    type: int
+    default: 1
+    description: The loop increment

_service:tar_scm:meson-1.0.1.tar.gz/docs/yaml/functions/run_command.yaml Added

@@ -0,0 +1,49 @@
+name: run_command
+returns: runresult
+description: |
+  Runs the command specified in positional arguments. `command` can be a
+  string, or the output of find_program,
+  files or configure_file, or a
+  compiler object(#compiler-object).
+
+  Returns a @runresult object containing the result
+  of the invocation. The command is run from an *unspecified* directory,
+  and Meson will set three environment variables `MESON_SOURCE_ROOT`,
+  `MESON_BUILD_ROOT` and `MESON_SUBDIR` that specify the source
+  directory, build directory and subdirectory the target was defined in,
+  respectively.
+
+  See also External commands(External-commands.md).
+
+varargs:
+  name: command
+  type: str | file | external_program
+  description: The command to execute during the setup process.
+
+kwargs:
+  check:
+    type: bool
+    since: 0.47.0
+    default: false
+    description: |
+      If `true`, the exit status code of the command will be checked,
+      and the configuration will fail if it is non-zero. Note that
+      the default value will be `true` in future releases.
+
+  capture:
+    type: bool
+    since: 0.47.0
+    default: true
+    description: |
+      If `true`, any output generated on stdout will be captured and returned by
+      the `.stdout()` method. If it is false, then `.stdout()` will return an
+      empty string.
+
+  env:
+    type: env | liststr | dictstr
+    since: 0.50.0
+    description: |
+      environment variables to set,
+      such as `'NAME1=value1', 'NAME2=value2'`,
+      or an @env object which allows more sophisticated
+      environment juggling. *(Since 0.52.0)* A dictionary is also accepted.

_service:tar_scm:meson-1.0.1.tar.gz/docs/yaml/functions/run_target.yaml Added

@@ -0,0 +1,55 @@
+name: run_target
+returns: run_tgt
+description: |
+  This function creates a new top-level target that runs a specified
+  command with the specified arguments. Like all top-level targets, this
+  integrates with the selected backend. For instance, you can run it as
+  `meson compile target_name`. Note that a run target produces no output
+  as far as Meson is concerned. It is only meant for tasks such as
+  running a code formatter or flashing an external device's firmware
+  with a built file.
+
+  The command is run from an *unspecified* directory, and Meson will set
+  three environment variables `MESON_SOURCE_ROOT`, `MESON_BUILD_ROOT`
+  and `MESON_SUBDIR` that specify the source directory, build directory
+  and subdirectory the target was defined in, respectively.
+
+  *Since 0.57.0* The template strings passed to `command` keyword arguments accept
+  the following special substitutions:
+  - `@SOURCE_ROOT@`: the path to the root of the source tree. Depending on the backend,
+    this may be an absolute or a relative to current workdir path.
+  - `@BUILD_ROOT@`: the path to the root of the build tree. Depending on the backend,
+    this may be an absolute or a relative to current workdir path.
+  - `@CURRENT_SOURCE_DIR@` *Since 0.57.1*: this is the directory where the currently
+    processed meson.build is located in. Depending on the backend,
+    this may be an absolute or a relative to current workdir path.
+
+posargs:
+  target_name:
+    type: str
+    description: The name of the run target
+
+kwargs:
+  command:
+    type: listexe| external_program | custom_tgt | file | str
+    description: |
+      A list containing the command to run and the arguments
+      to pass to it. Each list item may be a string or a target. For
+      instance, passing the return value of executable
+      as the first item will run that executable, or passing a string as
+      the first item will find that command in `PATH` and run it.
+
+  depends:
+    type: listbuild_tgt | custom_tgt
+    description: |
+      A list of targets that this target depends on but which
+      are not listed in the command array (because, for example, the
+      script does file globbing internally)
+
+  env:
+    since: 0.57.0
+    type: env | liststr | dictstr
+    description: |
+      environment variables to set, such as
+      `{'NAME1': 'value1', 'NAME2': 'value2'}` or `'NAME1=value1', 'NAME2=value2'`,
+      or an @env object which allows more sophisticated environment juggling.

_service:tar_scm:meson-1.0.1.tar.gz/docs/yaml/functions/set_variable.yaml Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/yaml/functions/shared_library.yaml Added

@@ -0,0 +1,46 @@
+name: shared_library
+returns: lib
+description: Builds a shared library with the given sources.
+
+posargs_inherit: _build_target_base
+varargs_inherit: _build_target_base
+kwargs_inherit: _build_target_base
+
+kwargs:
+  version:
+    type: str
+    description: |
+      A string specifying the version of this shared library,
+      such as `1.1.0`. On Linux and OS X, this is used to set the shared
+      library version in the filename, such as `libfoo.so.1.1.0` and
+      `libfoo.1.1.0.dylib`. If this is not specified, `soversion` is used
+      instead (see above).
+
+  soversion:
+    type: str | int
+    description: |
+      A string or integer specifying the soversion of this shared library,
+      such as `0`. On Linux and Windows this is used to set the
+      soversion (or equivalent) in the filename. For example, if
+      `soversion` is `4`, a Windows DLL will be called `foo-4.dll` and one
+      of the aliases of the Linux shared library would be
+      `libfoo.so.4`. If this is not specified, the first part of `version`
+      is used instead (see below). For example, if `version` is `3.6.0` and
+      `soversion` is not defined, it is set to `3`.
+
+  darwin_versions:
+    type: str | int | liststr
+    since: 0.48.0
+    description: |
+      Defines the `compatibility version` and `current version` for the dylib on macOS.
+      If a list is specified, it must be
+      either zero, one, or two elements. If only one element is specified
+      or if it's not a list, the specified value will be used for setting
+      both compatibility version and current version. If unspecified, the
+      `soversion` will be used as per the aforementioned rules.
+
+  vs_module_defs:
+    type: str | file | custom_tgt | custom_idx
+    description: |
+      Specify a Microsoft module definition file for controlling symbol exports,
+      etc., on platforms where that is possible (e.g. Windows).

_service:tar_scm:meson-1.0.1.tar.gz/docs/yaml/functions/shared_module.yaml Added

@@ -0,0 +1,41 @@
+name: shared_module
+returns: build_tgt
+since: 0.37.0
+description: |
+  Builds a shared module with the given sources.
+
+  This is useful for building modules that will be `dlopen()`ed and
+  hence may contain undefined symbols that will be provided by the
+  library that is loading it.
+
+  If you want the shared module to be able to refer to functions and
+  variables defined in the executable it is loaded by,
+  you will need to set the `export_dynamic` argument of the executable to
+  `true`.
+
+notes:
+ - |
+   *Linking to a shared module on platforms other than Android is deprecated, and will be an error
+   in the future*.
+   It was previously allowed because it was the only way to have a shared-library-like target that
+   contained references to undefined symbols. However, since 0.40.0, the `override_options:`
+   build_target keyword argument can be used to create such a shared_library by passing
+   `override_options: 'b_lundef=false'`. Shared modules have other characteristics that make
+   them incompatible with linking, such as a lack of SONAME.
+   On macOS and iOS, linking to shared modules is disallowed by the linker, so we disallow it at
+   configure time.
+   On Android, if a shared module `foo` uses symbols from another shared module `bar`, `foo` must
+   also be linked to `bar`. Hence, linking one shared module to another will always be allowed when
+   building for Android.
+
+posargs_inherit: _build_target_base
+varargs_inherit: _build_target_base
+kwargs_inherit: _build_target_base
+
+kwargs:
+  vs_module_defs:
+    type: str | file | custom_tgt | custom_idx
+    since: 0.52.0
+    description: |
+      Specify a Microsoft module definition file for controlling symbol exports,
+      etc., on platforms where that is possible (e.g. Windows).

_service:tar_scm:meson-1.0.1.tar.gz/docs/yaml/functions/static_library.yaml Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/yaml/functions/structured_sources.yaml Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/yaml/functions/subdir.yaml Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/yaml/functions/subdir_done.yaml Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/yaml/functions/subproject.yaml Added

@@ -0,0 +1,65 @@
+name: subproject
+returns: subproject
+description: |
+  Takes the project specified in the positional argument and brings that
+  in the current build specification by returning a @subproject object.
+  Subprojects must always be placed inside
+  the `subprojects` directory at the top source directory. So for
+  example a subproject called `foo` must be located in
+  `${MESON_SOURCE_ROOT}/subprojects/foo`.
+
+  - `default_options` *(since 0.37.0)*: an array of default option values
+    that override those set in the subproject's `meson_options.txt`
+    (like `default_options` in `project`, they only have effect when
+    Meson is run for the first time, and command line arguments override
+    any default options in build files). *(since 0.54.0)*: `default_library`
+    built-in option can also be overridden.
+  - `version`: works just like the same as in `dependency`.
+    It specifies what version the subproject should be, as an example `>=1.0.1`
+  - `required` *(since 0.48.0)*: By default, `required` is `true` and
+    Meson will abort if the subproject could not be setup. You can set
+    this to `false` and then use the `.found()` method on the @subproject
+    object. You may also pass the value of a
+    `feature`(Build-options.md#features) option, same as
+    dependency.
+
+  Note that you can use the returned @subproject object
+  to access any variable in the
+  subproject. However, if you want to use a dependency object from
+  inside a subproject, an easier way is to use the `fallback:` keyword
+  argument to dependency.
+
+  See additional documentation(Subprojects.md).
+
+posargs:
+  subproject_name:
+    type: str
+    description: |
+      Name of the subproject. The subproject must exist in the `subprojects`
+      directory (or the directory specified in the `subproject_dir` of
+      project) as a directory or wrap file.
+
+kwargs:
+  default_options:
+    type: liststr
+    since: 0.37.0
+    description: |
+      An array of default option values
+      that override those set in the subproject's `meson_options.txt`
+      (like `default_options` in project, they only have effect when
+      Meson is run for the first time, and command line arguments override
+      any default options in build files). *(since 0.54.0)*: `default_library`
+      built-in option can also be overridden.
+
+  version:
+    type: str
+    description: |
+      Works just like the same as in dependency.
+      It specifies what version the subproject should be, as an example `>=1.0.1`.
+
+  required:
+    type: bool | feature
+    since: 0.48.0
+    default: true
+    description: |
+      Works just the same as in dependency.

_service:tar_scm:meson-1.0.1.tar.gz/docs/yaml/functions/summary.yaml Added

@@ -0,0 +1,96 @@
+name: summary
+returns: void
+since: 0.53.0
+description: |
+  This function is used to summarize build configuration at the end of the build
+  process. This function provides a way for projects (and subprojects) to report
+  this information in a clear way.
+
+  The content is a series of key/value pairs grouped into sections. If
+  the section keyword argument is omitted, those key/value pairs are
+  implicitly grouped into a section with no title. key/value pairs can
+  optionally be grouped into a dictionary, but keep in mind that
+  dictionaries do not guarantee ordering. `key` must be string,
+  `value` can be:
+
+  - an integer, boolean or string
+  - *since 0.57.0* an external program or a dependency
+  - *since 0.58.0* a feature option
+  - a list of those.
+
+  Instead of calling summary as `summary(key, value)`, it is also possible to
+  directly pass a dictionary to the summary function, as seen in the example
+  below.
+
+  `summary()` can be called multiple times as long as the same
+  section/key pair doesn't appear twice. All sections will be collected
+  and printed at the end of the configuration in the same order as they
+  have been called.
+
+example: |
+  Example `meson.build`:
+  ```meson
+  project('My Project', version : '1.0')
+  summary({'bindir': get_option('bindir'),
+          'libdir': get_option('libdir'),
+          'datadir': get_option('datadir'),
+          }, section: 'Directories')
+  summary({'Some boolean': false,
+          'Another boolean': true,
+          'Some string': 'Hello World',
+          'A list': 'string', 1, true,
+          }, section: 'Configuration')
+  ```
+
+  Output:
+  ```
+  My Project 1.0
+
+    Directories
+      prefix         : /opt/gnome
+      bindir         : bin
+      libdir         : lib/x86_64-linux-gnu
+      datadir        : share
+
+    Configuration
+      Some boolean   : False
+      Another boolean: True
+      Some string    : Hello World
+      A list         : string
+                       1
+                       True
+  ```
+
+arg_flattening: false
+
+posargs:
+  key_or_dict:
+    type: str | dictstr | bool | int | dep | external_program | liststr | bool | int | dep | external_program
+    description: |
+      The name of the new entry, or a dict containing multiple entries.  If a
+      dict is passed it is equivalent to calling summary() once for each
+      key-value pair.  Keep in mind that dictionaries do not guarantee
+      ordering.
+
+optargs:
+  value:
+    type: str | bool | int | dep | external_program | liststr | bool | int | dep | external_program
+    description: |
+      The value to print for the `key`.  Only valid if `key_or_dict` is a str.
+
+kwargs:
+  bool_yn:
+    type: bool
+    default: false
+    description: Convert bool values to yes and no
+  section:
+    type: str
+    description: The section to put this summary information under.  If the
+      section keyword argument is omitted, key/value pairs are implicitly
+      grouped into a section with no title.
+  list_sep:
+    type: str
+    since: 0.54.0
+    description: |
+      The separator to use when printing list values in this summary.  If no
+      separator is given, each list item will be printed on its own line.

_service:tar_scm:meson-1.0.1.tar.gz/docs/yaml/functions/test.yaml Added

@@ -0,0 +1,56 @@
+name: test
+returns: void
+description: |
+  Defines a test to run with the test harness. Takes two positional
+  arguments, the first is the name of the test and the second is the
+  executable to run. The executable can be an @exe object returned by
+  executable or an @external_program object returned by
+  find_program.
+
+  *(since 0.55.0)* When cross compiling, if an exe_wrapper is needed and
+  defined the environment variable `MESON_EXE_WRAPPER` will be set to
+  the string value of that wrapper (implementation detail: using
+  `mesonlib.join_args`). Test scripts may use this to run cross built
+  binaries. If your test needs `MESON_EXE_WRAPPER` in cross build
+  situations it is your responsibility to return code 77 to tell the
+  harness to report "skip".
+
+  By default, environment variable
+  `MALLOC_PERTURB_`(http://man7.org/linux/man-pages/man3/mallopt.3.html)
+  is automatically set by `meson test` to a random value between 1..255.
+  This can help find memory leaks on configurations using glibc,
+  including with non-GCC compilers. However, this can have a performance
+  impact, and may fail a test due to external libraries whose internals
+  are out of the user's control. To check if this feature is causing an
+  expected runtime crash, disable the feature by temporarily setting
+  environment variable `MALLOC_PERTURB_=0`. While it's preferable to
+  only temporarily disable this check, if a project requires permanent
+  disabling of this check in meson.build do like:
+
+  ```meson
+  nomalloc = environment({'MALLOC_PERTURB_': '0'})
+
+  test(..., env: nomalloc, ...)
+  ```
+
+  In addition to running individual executables as test cases, `test()`
+  can also be used to invoke an external test harness.  In this case,
+  it is best to use `verbose: true` *(since 0.62.0)* and, if supported
+  by the external harness, `protocol: 'tap'` *(since 0.50.0)*.  This will
+  ensure that Meson logs each subtest as it runs, instead of including
+  the whole log at the end of the run.
+
+  Defined tests can be run in a backend-agnostic way by calling
+  `meson test` inside the build dir, or by using backend-specific
+  commands, such as `ninja test` or `msbuild RUN_TESTS.vcxproj`.
+
+posargs_inherit: benchmark
+kwargs_inherit: benchmark
+
+kwargs:
+  is_parallel:
+    type: bool
+    default: true
+    description: |
+      when false, specifies that no other test must be
+      running at the same time as this test

_service:tar_scm:meson-1.0.1.tar.gz/docs/yaml/functions/unset_variable.yaml Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/yaml/functions/vcs_tag.yaml Added

@@ -0,0 +1,57 @@
+name: vcs_tag
+returns: custom_tgt
+description: |
+  This command detects revision control commit information at build time
+  and places it in the specified output file. This file is guaranteed to
+  be up to date on every build. Keywords are similar to custom_target.
+
+  Meson will read the contents of `input`, substitute the
+  `replace_string` with the detected revision number, and write the
+  result to `output`. This method returns a
+  @custom_tgt object that (as usual) should be
+  used to signal dependencies if other targets use the file outputted
+  by this.
+
+  For example, if you generate a header with this and want to use that
+  in a build target, you must add the return value to the sources of
+  that build target. Without that, Meson will not know the order in
+  which to build the targets.
+
+  If you desire more specific behavior than what this command provides,
+  you should use custom_target.
+
+kwargs:
+  command:
+    type: listexe | external_program | custom_tgt | file | str
+    description: |
+      The command to execute, see custom_target for details
+      on how this command must be specified.
+
+      This parameter is optional. If it is absent, Meson will try
+      its best to find a suitable default command.
+
+      *(since 0.62.0)* @file is accepted.
+
+      *(since 0.63.0)* @custom_tgt, @exe, and @external_program are accepted.
+
+  input:
+    type: str
+    required: true
+    description: File to modify (e.g. `version.c.in`).
+
+  output:
+    type: str
+    required: true
+    description: File to write the results to (e.g. `version.c`).
+
+  fallback:
+    type: str
+    default: "meson.project_version"
+    description: |
+      Version number to use when no revision control information is present,
+      such as when building from a release tarball.
+
+  replace_string:
+    type: str
+    default: "'@VCS_TAG@'"
+    description: String in the input file to substitute with the commit information.

_service:tar_scm:meson-1.0.1.tar.gz/docs/yaml/functions/warning.yaml Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/yaml/modules Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/yaml/modules/cmake Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/yaml/modules/cmake/module.yaml Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/yaml/modules/cmake/options.yaml Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/yaml/objects Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/yaml/objects/alias_tgt.yaml Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/yaml/objects/both_libs.yaml Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/yaml/objects/build_tgt.yaml Added

@@ -0,0 +1,79 @@
+name: build_tgt
+long_name: Build target
+extends: tgt
+description: |
+  A build target is either an executable, shared library, static library,
+  both shared and static library or shared module.
+
+methods:
+- name: extract_objects
+  returns: extracted_obj
+  description: |
+    Returns an opaque value representing the object files generated for those
+    source files. This is typically used to take single object files and link
+    them to unit tests or to compile some source files with custom flags. To
+    use the object file(s) in another build target, use the
+    `objects:` keyword argument to a build_target or include them in the command
+    line of a custom_target.
+  varargs:
+    name: source
+    type: str | file
+    description: |
+      Source filenames for which the built objects should be extracted.
+    min_varargs: 1
+
+- name: extract_all_objects
+  returns: extracted_obj
+  description: |
+    Acts the same as `extract_objects`, but returns all object files generated
+    by this target.
+
+    By default only objects built for this target are returned to maintain
+    backward compatibility with previous versions.  The default value for the
+    `recursive` kwarg will eventually be changed to `true` in a future version.
+  kwargs:
+    recursive:
+      type: bool
+      description: |
+        Also return objects passed to the `objects` argument of this target.
+      since: 0.46.0
+      default: true
+
+- name: full_path
+  returns: str
+  description: |
+    Returns a full path pointing to the result target file.
+    **NOTE:** In most cases using the object itself will do the same job
+    as this and will also allow Meson to setup inter-target dependencies
+    correctly. Please file a bug if that doesn't work for you.
+
+- name: path
+  returns: str
+  since: 0.59.0
+  deprecated: 0.59.0
+  description: |
+    Does the exact same as build_tgt.full_path. **NOTE**: This
+    function is solely kept for compatebility with @external_program objects.
+    It will be removed once the, also deprecated, corresponding `path()`
+    function in the @external_program object is removed.
+
+- name: private_dir_include
+  returns: inc
+  description: |
+    Returns a value that works like include_directories, but points to the
+    private directory of this target. Usually only needed if an another target
+    needs to access some generated internal headers of this target.
+
+- name: name
+  returns: str
+  since: 0.54.0
+  description: Returns the name of the target.
+
+- name: found
+  returns: bool
+  since: 0.59.0
+  description: |
+    Always returns `true`. This function is meant to make executables
+    objects feature compatible with @external_program objects. This
+    simplifies use-cases where an executable is used instead of
+    an @external_program.

_service:tar_scm:meson-1.0.1.tar.gz/docs/yaml/objects/cfg_data.yaml Added

@@ -0,0 +1,137 @@
+name: cfg_data
+long_name: Configuration data object
+description: |
+  This object encapsulates
+  configuration values to be used for generating configuration files. A
+  more in-depth description can be found in the the configuration wiki
+  page(Configuration.md).
+
+methods:
+- name: set
+  returns: void
+  description: Sets a variable to a given value
+
+  posargs:
+    varname:
+      type: str
+      description: The name of the variable to set
+    value:
+      type: str | int | bool
+      description: The value to set
+
+  kwargs:
+    description:
+      type: str
+      description: |
+        Message / Comment that will be written in the
+        result file. The replacement assumes a file with C syntax. If your
+        generated file is source code in some other language, you probably
+        don't want to add a description field because it most likely will
+        cause a syntax error.
+
+- name: set10
+  returns: void
+  description: |
+    Is the same as cfg_data.set but the value
+    is either `true` or `false` and will be written as 1 or 0,
+    respectively
+
+  posargs:
+    varname:
+      type: str
+      description: The name of the variable to set
+    value:
+      type: bool | int
+      description: |
+        The value to set as either `1` or `0`
+
+        Passing numbers was never intended to work, and since 0.62 it has been
+        deprecated. It will be removed in a future version of Meson. If you
+        need to pass numbers use the `.set` method.
+  warnings:
+  - numeric values < 0 have the surprising behavior of being converted to
+    `true`, values > 1 have the more expected but unintentional behavior of
+    being interpreted as `true`.
+
+  kwargs_inherit: cfg_data.set
+
+- name: set_quoted
+  returns: void
+  description: Is same as cfg_data.set but quotes the value in double quotes (`"`)
+
+  posargs:
+    varname:
+      type: str
+      description: The name of the variable to set
+    value:
+      type: str | int | bool
+      description: The value to set
+
+  kwargs_inherit: cfg_data.set
+
+- name: get
+  returns: str | int | bool
+  since: 0.38.0
+  description: |
+    Returns the value of `varname`, if the
+    value has not been set returns `default_value` if it is defined
+    *(since 0.38.0)* and errors out if not
+
+  posargs:
+    varname:
+      type: str
+      description: The name of the variable to query
+
+  optargs:
+    default_value:
+      type: str | int | bool
+      description: The default value to return when `varname` does not exist
+
+- name: get_unquoted
+  returns: str | int | bool
+  since: 0.44.0
+  description: |
+    Returns the value
+    of `varname` but without surrounding double quotes (`"`). If the value has
+    not been set returns `default_value` if it is defined and errors out if not.
+
+  posargs:
+    varname:
+      type: str
+      description: The name of the variable to query
+
+  optargs:
+    default_value:
+      type: str | int | bool
+      description: The default value to return when `varname` does not exist
+
+- name: has
+  returns: bool
+  description: returns `true` if the specified variable is set
+  posargs:
+    varname:
+      type: str
+      description: The name of the variable to query
+
+- name: keys
+  returns: liststr
+  since: 0.57.0
+  description: |
+    Returns an array of keys of
+    the configuration data object.
+
+    You can iterate over this array with the `foreach`
+    statement(Syntax.md#foreach-statements).
+
+- name: merge_from
+  returns: void
+  since: 0.42.0
+  description: |
+    Takes as argument a different
+    configuration data object and copies all entries from that object to
+    the current.
+
+  posargs:
+    other:
+      type: cfg_data
+      description: The other @cfg_data object to merge into this one.

_service:tar_scm:meson-1.0.1.tar.gz/docs/yaml/objects/compiler.yaml Added

@@ -0,0 +1,619 @@
+name: compiler
+long_name: Compiler object
+description: |
+  This object is returned by meson.get_compiler.
+  It represents a compiler for a given language and allows you to query its properties.
+
+notes:
+- |
+  These compiler checks do not use compiler arguments added
+  with `add_*_arguments()`, via `-Dlang_args` on the command-line, or
+  through `CFLAGS`/`LDFLAGS`, etc in the environment. Hence, you can
+  trust that the tests will be fully self-contained, and won't fail
+  because of custom flags added by other parts of the build file or by
+  users.
+
+- |
+  Note that if you have a single prefix with all your dependencies, you
+  might find it easier to append to the environment variables
+  `C_INCLUDE_PATH` with GCC/Clang and `INCLUDE` with MSVC to expand the
+  default include path, and `LIBRARY_PATH` with GCC/Clang and `LIB` with
+  MSVC to expand the default library search path.
+
+  However, with GCC, these variables will be ignored when
+  cross-compiling. In that case you need to use a specs file. See:
+  http://www.mingw.org/wiki/SpecsFileHOWTO
+
+methods:
+
+# Helper methods to pre-define common posargs
+- name: _code
+  returns: void
+  description: You have found a bug if you can see this!
+  posargs:
+    code:
+      type: str | file
+      description: |
+        The source code to check.
+
+        If a string is passed, the code is used directly. If a @file object
+        is passed, its content is used for the compiler check.
+
+# Helper methods to pre-define common kwargs
+- name: _args
+  returns: void
+  description: You have found a bug if you can see this!
+  kwargs:
+    args:
+      type: liststr
+      description: |
+        Used to pass a list of compiler arguments.
+        Defining include paths for headers not in the default include path
+        via `-Isome/path/to/header` is generally supported, however, usually not
+        recommended.
+
+        This is because include directories can also be specified via the
+        `include_directories` or the `dependency` kwarg (if present).
+        The same is also true for passing libraries to link with `-lfoo`.
+
+- name: _include_directories
+  returns: void
+  description: You have found a bug if you can see this!
+  kwargs:
+    include_directories:
+      type: inc | listinc
+      since: 0.38.0
+      description: Extra directories for header searches.
+
+- name: _dependencies
+  returns: void
+  description: You have found a bug if you can see this!
+  kwargs:
+    dependencies:
+      type: dep | listdep
+      description: Additionally dependencies required for compiling and / or linking.
+
+- name: _prefix
+  returns: void
+  description: You have found a bug if you can see this!
+  kwargs:
+    prefix:
+      type: str | liststr
+      description: |
+        Used to add `#include`s and other things that are required
+        for the symbol to be declared. Since 1.0.0 an array is accepted
+        too. When an array is passed, the items are concatenated together
+        separated by a newline.
+        System definitions should be passed via compiler args
+        (eg: `_GNU_SOURCE` is often required for some symbols to be exposed
+        on Linux, and it should be passed via `args` keyword argument).
+
+- name: _no_builtin_args
+  returns: void
+  description: You have found a bug if you can see this!
+  kwargs:
+    no_builtin_args:
+      type: bool
+      default: false
+      description: When set to `true`, the compiler arguments controlled by built-in configuration options are not added.
+
+- name: _name
+  returns: void
+  description: You have found a bug if you can see this!
+  kwargs:
+    name:
+      type: str
+      description: |
+        The name to use for printing a message about the compiler check.
+        If this keyword argument is not passed, no message will be printed about the check.
+
+# Even more convenient
+- name: _common
+  returns: void
+  description: You have found a bug if you can see this!
+  kwargs_inherit:
+    - compiler._args
+    - compiler._include_directories
+    - compiler._dependencies
+    - compiler._no_builtin_args
+    - compiler._prefix
+
+- name: _compiles
+  returns: void
+  description: You have found a bug if you can see this!
+  kwargs_inherit:
+    - compiler._args
+    - compiler._include_directories
+    - compiler._dependencies
+    - compiler._no_builtin_args
+    - compiler._name
+
+- name: _header
+  returns: void
+  description: You have found a bug if you can see this!
+  kwargs_inherit: compiler._common
+  kwargs:
+    required:
+      type: bool | feature
+      default: false
+      since: 0.50.0
+      description:
+        When set to `true`, Meson will halt if the header check fails.
+
+        When set to a `feature`(Build-options.md#features) option, the feature
+        will control if it is searched and whether to fail if not found.
+
+
+# Star of the actual functions
+- name: version
+  returns: str
+  description: Returns the compiler's version number as a string.
+
+- name: cmd_array
+  returns: liststr
+  description: Returns an array containing the command(s) for the compiler.
+
+
+- name: alignment
+  returns: int
+  description: Returns the alignment of the specified type.
+
+  posargs:
+    typename:
+      type: str
+      description: The name of the type to check.
+
+  kwargs_inherit:
+    - compiler._args
+    - compiler._prefix
+    - compiler._dependencies
+    # TODO: why not also allow passing `include_directories`?
+
+- name: run
+  returns: runresult
+  description: Attempts to compile and execute the given code fragment.
+  posargs_inherit: compiler._code
+  kwargs_inherit: compiler._compiles
+
+- name: get_id
+  returns: str
+  description: |
+    Returns a string identifying the compiler.
+    For example, `gcc`, `msvc`, and more(Reference-tables.md#compiler-ids).
+
+- name: get_linker_id
+  returns: str
+  since: 0.53.0
+  description: |
+    Returns a string identifying the linker.
+    For example, `ld.bfd`, `link`, and more(Reference-tables.md#linker-ids).
+
+- name: symbols_have_underscore_prefix
+  returns: bool
+  since: 0.37.0
+  description: Returns `true` if the C symbol mangling is one underscore (`_`) prefixed to the symbol.
+
+- name: has_member
+  returns: bool
+  description: Returns true if the type has the specified member.
+  kwargs_inherit: compiler._common
+  posargs:
+    typename:
+      type: str
+      description: The type to check.
+    membername:
+      type: str
+      description: The member to check.
+
+- name: has_members
+  returns: bool
+  description: Returns `true` if the type has *all* the specified members.
+  kwargs_inherit: compiler._common
+  posargs:
+    typename:
+      type: str
+      description: The type to check.
+  varargs:
+    name: member
+    type: str
+    min_varargs: 1
+    description: The members to check
+
+- name: has_function
+  returns: bool
+  description: |
+    Returns true if the given function is provided
+    by the standard library or a library passed in with the `args` keyword.
+
+  kwargs_inherit: compiler._common
+  posargs:
+    funcname:
+      type: str
+      description: The function to check.
+
+- name: has_type
+  returns: bool
+  description: Returns `true` if the specified token is a type.
+  kwargs_inherit: compiler._common
+  posargs:
+    typename:
+      type: str
+      description: The type to check.
+
+- name: compute_int
+  returns: int
+  since: 0.40.0
+  kwargs_inherit: compiler._common
+  description: |
+    Computes the value of the given expression
+    (as an example `1 + 2`). When cross compiling this is evaluated with
+    an iterative algorithm, you can specify keyword arguments `low`
+    (defaults to -1024), `high` (defaults to 1024) and `guess` to
+    specify max and min values for the search and the value to try
+    first.
+
+  posargs:
+    expr:
+      type: str
+      description: The expression to compute.
+
+  kwargs:
+    low:
+      type: int
+      default: -1024
+      description: The min value.
+    high:
+      type: int
+      default: 1024
+      description: The max value.
+    guess:
+      type: int
+      description: The value to try first.
+
+- name: sizeof
+  returns: int
+  description: returns the size of the given type (e.g. `'int'`) or -1 if the type is unknown.
+  kwargs_inherit: compiler._common
+  posargs:
+    typename:
+      type: str
+      description: The type to compute.
+
+- name: get_define
+  returns: str
+  since: 0.40.0
+  description: |
+    Returns the given preprocessor symbol's value
+    as a string or empty string if it is not defined.
+
+    *(since 0.47.0)* This method will concatenate string literals as
+    the compiler would. E.g. `"a" "b"` will become `"ab"`.
+
+  kwargs_inherit: compiler._common
+  posargs:
+    definename:
+      type: str
+      description: The define to check.
+
+- name: compiles
+  returns: bool
+  description: Returns true if the code compiles.
+  posargs_inherit: compiler._code
+  kwargs_inherit: compiler._compiles
+
+- name: links
+  returns: bool
+  description: |
+    Returns true if the code compiles and links.
+
+    *Since 0.60.0*, if the `file` object's
+    suffix does not match the compiler object's language, the compiler
+    corresponding to the suffix is used to compile the source, while the
+    target of the `links` method is used to link the resulting object file.
+  posargs_inherit: compiler._code
+  kwargs_inherit: compiler._compiles
+
+- name: check_header
+  returns: bool
+  since: 0.47.0
+  description: |
+    Returns true if the specified header is *usable*
+    with the specified prefix, dependencies, and arguments.
+
+  kwargs_inherit: compiler._header
+  posargs:
+    header_name:
+      type: str
+      description: The header to check.
+
+- name: has_header
+  returns: bool
+  description: |
+    Returns true if the specified header is *exists*
+    with the specified prefix, dependencies, and arguments.
+
+    This method is faster than compiler.check_header since it only does a
+    pre-processor check.
+
+  kwargs_inherit: compiler._header
+  posargs_inherit: compiler.check_header
+
+- name: has_header_symbol
+  returns: bool
+  description: |
+    Detects whether a particular symbol is declared in the specified header.
+
+    Symbols here include function, variable, `#define`, type definition, etc.
+
+  kwargs_inherit: compiler._header
+  posargs:
+    header:
+      type: str
+      description: The header to check.
+    symbol:
+      type: str
+      description: The symbol to check.
+
+- name: find_library
+  returns: dep
+  description: Tries to find the library specified in the positional argument.
+
+  posargs:
+    libname:
+      type: str
+      description: The library to find.
+  kwargs:
+    required:
+      type: bool | feature
+      default: true
+      description: |
+        If set `true`, Meson will abort with an error if the library could not
+        be found. Otherwise, Meson will continue and the found method of the
+        returned object will return `false`.
+
+        When set to a `feature`(Build-options.md#features) option, the feature
+        will control if it is searched and whether to fail if not found.
+
+        *(since 0.47.0)* The value of a `feature` option can also be passed here.
+
+    has_headers:
+      type: liststr
+      since: 0.50.0
+      description: |
+        List of headers that must be found as well.
+        This check is equivalent to checking each header with a
+        compiler.has_header call.
+
+        When used, kwargs that compiler.has_header would accept can be
+        passed here prefixed with `header_`, and will have the same effect on
+        the header check.
+
+    static:
+      type: bool
+      default: false
+      since: 0.51.0
+      description: |
+        If `true`, the search is limited to static libraries only.
+        Setting this value to `false` (the default) will search for both shared
+        *and* static libraries.
+
+    disabler:
+      type: bool
+      default: false
+      since: 0.49.0
+      description: If `true`, this method will return a @disabler on a failed check.
+
+    dirs:
+      type: liststr
+      description: |
+        Additional directories to search in.
+
+        By default the library is searched for in the system library directory
+        (e.g. /usr/lib). Specifying more directories here, causes Meson to search
+        in those directories as well as the system directories.
+# does not work, since all _common kwargs need to be prefixed `header_` here
+# kwargs_inherit: compiler._common
+    header_args:
+      type: liststr
+      since: 0.51.0
+      description: |
+        When the `has_headers` kwarg is also used, this argument is passed to
+        compiler.has_header as `args`.
+    header_include_directories:
+      type: inc | listinc
+      since: 0.51.0
+      description: |
+        When the `has_headers` kwarg is also used, this argument is passed to
+        compiler.has_header as `include_directories`.
+    header_dependencies:
+      type: dep | listdep
+      since: 0.51.0
+      description: |
+        When the `has_headers` kwarg is also used, this argument is passed to
+        compiler.has_header as `dependencies`.
+    header_no_builtin_args:
+      type: bool
+      default: false
+      since: 0.51.0
+      description: |
+        When the `has_headers` kwarg is also used, this argument is passed to
+        compiler.has_header as `no_builtin_args`.
+    header_prefix:
+      type: str
+      since: 0.51.0
+      description: |
+        When the `has_headers` kwarg is also used, this argument is passed to
+        compiler.has_header as `prefix`.
+
+# Compiler arguments
+- name: has_argument
+  returns: bool
+  description: |
+    Returns `true` if the compiler accepts the specified command line argument,
+    that is, can compile code without erroring out or printing a warning about
+    an unknown flag.
+
+  posargs:
+    argument:
+      type: str
+      description: The argument to check.
+
+- name: has_multi_arguments
+  since: 0.37.0
+  returns: bool
+  description: |
+    the same as compiler.has_argument but takes multiple arguments
+    and uses them all in a single compiler invocation.
+
+  varargs:
+    name: arg
+    type: str
+    description: The arguments to check.
+
+- name: get_supported_arguments
+  returns: liststr
+  since: 0.43.0
+  varargs_inherit: compiler.has_multi_arguments
+  description: |
+    Returns an array containing only the arguments supported by the compiler,
+    as if compiler.has_argument were called on them individually.
+
+  kwargs:
+    checked:
+      type: str
+      since: 0.59.0
+      default: "'off'"
+      description: |
+        Supported values:
+          - `'off'`: Quietely ignore unsupported arguments
+          - `'warn'`: Print a warning for unsupported arguments
+          - `'require'`: Abort if at least one argument is not supported
+
+- name: first_supported_argument
+  returns: liststr
+  since: 0.43.0
+  varargs_inherit: compiler.has_multi_arguments
+  description: |
+    Given a list of strings, returns a single-element list containing the first
+    argument that passes the compiler.has_argument test or an empty array if
+    none pass.
+
+
+# Linker arguments
+- name: has_link_argument
+  since: 0.46.0
+  returns: bool
+  description: |
+    Returns `true` if the linker accepts the specified command line argument,
+    that is, can
+    compile and link code without erroring out or printing a warning
+    about an unknown flag. Link arguments will be passed to the
+    compiler, so should usually have the `-Wl,` prefix. On VisualStudio
+    a `/link` argument will be prepended.
+
+  posargs:
+    argument:
+      type: str
+      description: The argument to check.
+
+- name: has_multi_link_arguments
+  since: 0.46.0
+  returns: bool
+  description: |
+    the same as compiler.has_link_argument but takes multiple arguments
+    and uses them all in a single compiler invocation.
+
+  varargs:
+    name: arg
+    type: str
+    description: The link arguments to check.
+
+- name: get_supported_link_arguments
+  returns: liststr
+  since: 0.46.0
+  varargs_inherit: compiler.has_multi_link_arguments
+  description: |
+    Returns an array containing only the arguments supported by the compiler,
+    as if compiler.has_link_argument were called on them individually.
+
+  # TODO: why is this not present here?
+  # kwargs:
+  #   checked:
+  #     type: str
+  #     sinec: 0.59.0
+  #     default: "'off'"
+  #     description: |
+  #       Supported values:
+  #         - `'off'`: Quietely ignore unsupported arguments
+  #         - `'warn'`: Print a warning for unsupported arguments
+  #         - `'require'`: Abort if at least one argument is not supported
+
+- name: first_supported_link_argument
+  returns: liststr
+  since: 0.46.0
+  varargs_inherit: compiler.has_multi_link_arguments
+  description: |
+    Given a list of strings, returns the first argument that passes the
+    compiler.has_link_argument test or an empty array if none pass.
+
+
+
+
+
+- name: has_function_attribute
+  returns: bool
+  since: 0.48.0
+  description: |
+    Returns `true` if the compiler supports the GNU style (`__attribute__(...)`) `name`.
+    This is preferable to manual compile checks as it may be optimized for compilers that
+    do not support such attributes.
+    This table(Reference-tables.md#gcc-__attribute__) lists all of the supported attributes.
+
+  posargs:
+    name:
+      type: str
+      description: The attribute name to check.
+
+- name: get_supported_function_attributes
+  returns: liststr
+  since: 0.48.0
+  description: |
+    Returns an array containing any names that are supported GCC style attributes.
+    Equivalent to compiler.has_function_attribute was called on each of
+    them individually.
+
+  # TODO: Again why doesn't this function have the checked kwarg?
+
+- name: get_argument_syntax
+  returns: str
+  since: 0.49.0
+  description: |
+    returns a string identifying the type of arguments the compiler takes.
+    Can be one of `gcc`, `msvc`, or an undefined
+    string value. This method is useful for identifying compilers that are not
+    gcc or msvc, but use the same argument syntax as one of those two compilers
+    such as clang or icc, especially when they use different syntax on different
+    operating systems.
+
+- name: preprocess
+  returns: listcustom_idx
+  since: 0.64.0
+  description: |
+    Preprocess a list of source files but do not compile them. The preprocessor
+    will receive the same arguments (include directories, defines, etc) as with
+    normal compilation. That includes for example args added with
+    `add_project_arguments()`, or on the command line with `-Dc_args=-DFOO`.
+  varargs_inherit: _build_target_base
+  kwargs_inherit:
+    - compiler._include_directories
+  kwargs:
+    output:
+      type: str
+      description: |
+        Template for name of preprocessed files: `@PLAINNAME@` is replaced by
+        the source filename and `@BASENAME@` is replaced by the source filename
+        without its extension.
+    compile_args:
+      type: liststr
+      description: |
+        Extra flags to pass to the preprocessor

_service:tar_scm:meson-1.0.1.tar.gz/docs/yaml/objects/custom_idx.yaml Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/yaml/objects/custom_tgt.yaml Added

@@ -0,0 +1,33 @@
+name: custom_tgt
+long_name: Custom target
+extends: tgt
+description: |
+  This object is returned by custom_target and contains a target with the following methods:
+
+methods:
+  - name: full_path
+    returns: str
+    description: |
+      Returns a full path pointing to the result target file
+      NOTE: In most cases using the object itself will do the same job as
+      this and will also allow Meson to setup inter-target dependencies
+      correctly. Please file a bug if that doesn't work for you.
+      *(since 0.54.0)* It can be also called on indexes objects:
+      `custom_targetsi.full_path()`.
+
+  - name: "index"
+    returns: custom_idx
+    description: |
+      Returns an opaque object that references this target, and
+      can be used as a source in other targets. When it is used as such it
+      will make that target depend on this custom target, but the only
+      source added will be the one that corresponds to the index of the
+      custom target's output argument.
+
+  - name: to_list
+    returns: listcustom_idx
+    since: 0.54.0
+    description: |
+        Returns a list of opaque objects that references this target,
+        and can be used as a source in other targets. This can be used to
+        iterate outputs with `foreach` loop.

_service:tar_scm:meson-1.0.1.tar.gz/docs/yaml/objects/dep.yaml Added

@@ -0,0 +1,212 @@
+name: dep
+long_name: Dependency object
+description: Abstract representation of a dependency
+
+methods:
+  - name: found
+    returns: bool
+    description: Returns whether the dependency was found.
+
+  - name: name
+    since: 0.48.0
+    returns: str
+    description: |
+      Returns the name of the dependency that was searched.
+      Returns `'internal'` for dependencies created with
+      declare_dependency.
+
+  - name: get_pkgconfig_variable
+    since: 0.36.0
+    deprecated: 0.56.0
+    returns: str
+    description: |
+      Gets the pkg-config variable specified,
+      or, if invoked on a non pkg-config
+      dependency, error out.
+
+    posargs:
+      var_name:
+        type: str
+        description: Name of the variable to query
+
+    kwargs:
+      define_variable:
+        type: liststr
+        since: 0.44.0
+        description: |
+          You can also redefine a
+          variable by passing a list to this kwarg
+          that can affect the retrieved variable: `'prefix', '/')`.
+
+      default:
+        type: str
+        since: 0.45.0
+        description: |
+          The value to return if the variable was not found.
+          A warning is issued if the variable is not defined and this kwarg is not set.
+
+  - name: get_configtool_variable
+    since: 0.44.0
+    deprecated: 0.56.0
+    returns: str
+    description: |
+      Gets the command line argument from the config tool (with `--` prepended), or,
+      if invoked on a non config-tool dependency, error out.
+
+    posargs:
+      var_name:
+        type: str
+        description: Name of the variable to query
+
+  - name: type_name
+    returns: str
+    description: |
+      Returns a string describing the type of the
+      dependency, the most common values are `internal` for deps created
+      with declare_dependency and `pkgconfig` for system dependencies
+      obtained with Pkg-config.
+
+  - name: version
+    returns: str
+    description: |
+      the version number as a string,
+      for example `1.2.8`.
+      `unknown` if the dependency provider doesn't support determining the
+      version.
+
+  - name: include_type
+    returns: str
+    since: 0.52.0
+    description: Returns the value set by the `include_type` kwarg.
+
+  - name: as_system
+    returns: dep
+    since: 0.52.0
+    description: |
+      Returns a copy of the dependency object, which has changed the value of `include_type`
+      to `value`. The `value` argument is optional and
+      defaults to `'preserve'`.
+
+    optargs:
+      value:
+        type: str
+        description: The new value. See dependency for supported values.
+
+  - name: as_link_whole
+    returns: dep
+    since: 0.56.0
+    description: |
+      Only dependencies created with declare_dependency,
+      returns a copy of the dependency object with all
+      link_with arguments changed to link_whole. This is useful for example for
+      fallback dependency from a subproject built with `default_library=static`.
+      Note that all `link_with` objects must be static libraries otherwise an error
+      will be raised when trying to `link_whole` a shared library.
+
+  - name: partial_dependency
+    returns: dep
+    since: 0.46.0
+    description: |
+      Returns a new dependency object with the same name, version, found status,
+      type name, and methods as the object that called it. This new
+      object will only inherit other attributes from its parent as
+      controlled by keyword arguments.
+
+      If the parent has any dependencies, those will be applied to the new
+      partial dependency with the same rules. So, given:
+
+      ```meson
+      dep1 = declare_dependency(compile_args : '-Werror=foo', link_with : 'libfoo')
+      dep2 = declare_dependency(compile_args : '-Werror=bar', dependencies : dep1)
+      dep3 = dep2.partial_dependency(compile_args : true)
+      ```
+
+      dep3 will add `'-Werror=foo', '-Werror=bar'` to the compiler args
+      of any target it is added to, but libfoo will not be added to the
+      link_args.
+
+      The following arguments will add the following attributes:
+
+      - compile_args: any arguments passed to the compiler
+      - link_args: any arguments passed to the linker
+      - links: anything passed via link_with or link_whole
+      - includes: any include_directories
+      - sources: any compiled or static sources the dependency has
+
+    warnings:
+      - A bug present until 0.50.1 results in the above behavior
+        not working correctly.
+
+    kwargs:
+      compile_args:
+        type: bool
+        default: false
+        description: Whether to include compile_args
+
+      link_args:
+        type: bool
+        default: false
+        description: Whether to include link_args
+
+      links:
+        type: bool
+        default: false
+        description: Whether to include links
+
+      includes:
+        type: bool
+        default: false
+        description: Whether to include includes
+
+      sources:
+        type: bool
+        default: false
+        description: Whether to include sources
+
+  - name: get_variable
+    returns: str
+    since: 0.51.0
+    description: |
+      A generic variable getter method, which replaces the
+      `get_*type*_variable` methods. This allows one to get the variable
+      from a dependency without knowing specifically how that dependency
+      was found. If `default_value` is set and the value cannot be gotten
+      from the object then `default_value` is returned, if it is not set
+      then an error is raised.
+
+    optargs:
+      varname:
+        type: str
+        since: 0.58.0
+        description: |
+          This argument is used as a default value
+          for `cmake`, `pkgconfig`, `configtool` and `internal` keyword
+          arguments. It is useful in the common case where `pkgconfig` and `internal`
+          use the same variable name, in which case it's easier to write `dep.get_variable('foo')`
+          instead of `dep.get_variable(pkgconfig: 'foo', internal: 'foo')`.
+
+    kwargs:
+      cmake:
+        type: str
+        description: The CMake variable name
+
+      pkgconfig:
+        type: str
+        description: The pkgconfig variable name
+
+      configtool:
+        type: str
+        description: The configtool variable name
+
+      internal:
+        type: str
+        since: 0.54.0
+        description: The internal variable name
+
+      default_value:
+        type: str
+        description: The default value to return when the variable does not exist
+
+      pkgconfig_define:
+        type: liststr
+        description: See dep.get_pkgconfig_variable

_service:tar_scm:meson-1.0.1.tar.gz/docs/yaml/objects/disabler.yaml Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/yaml/objects/env.yaml Added

@@ -0,0 +1,85 @@
+name: env
+long_name: Environment
+description: |
+  This object is returned by environment and stores
+  detailed information about how environment variables should be set
+  during tests. It should be passed as the `env` keyword argument to
+  tests and other functions.
+
+  *Since 0.58.0* env.append and env.prepend can be called multiple times
+  on the same `varname`. Earlier Meson versions would warn and only the last
+  operation took effect.
+
+example: |
+  ```meson
+  env = environment()
+
+  # MY_PATH will be '0:1:2:3'
+  env.set('MY_PATH', '1')
+  env.append('MY_PATH', '2')
+  env.append('MY_PATH', '3')
+  env.prepend('MY_PATH', '0')
+  ```
+
+methods:
+- name: append
+  returns: void
+  description: |
+    appends the given values to
+    the old value of the environment variable, e.g.  `env.append('FOO',
+    'BAR', 'BAZ', separator : ';')` produces `BOB;BAR;BAZ` if `FOO` had
+    the value `BOB` and plain `BAR;BAZ` if the value was not defined.
+
+  posargs:
+    variable:
+      type: str
+      description: The variable to modify
+
+  varargs:
+    type: str
+    name: Value
+    description: The values to append
+
+  kwargs:
+    separator:
+      type: str
+      description: |
+        The separator to use. If not explicitly specified, the default path
+        separator for the host operating system will be used, i.e. ';' for
+        Windows and ':' for UNIX/POSIX systems.
+
+- name: prepend
+  returns: void
+  description: Same as `append` except that it writes to the beginning of the variable.
+
+  posargs:
+    variable:
+      type: str
+      description: The variable to modify
+
+  varargs:
+    type: str
+    name: Value
+    description: The values to prepend
+
+  kwargs_inherit: env.append
+
+- name: set
+  returns: void
+  description: |
+    Sets the environment variable
+    specified in the first argument to the values in the varargs
+    joined by the separator. For instance, `env.set('FOO', 'BAR'),` sets envvar
+    `FOO` to value `BAR`.
+
+  posargs:
+    variable:
+      type: str
+      description: The variable to modify
+
+  varargs:
+    type: str
+    name: Value
+    description: The values to set
+
+  kwargs_inherit: env.append

_service:tar_scm:meson-1.0.1.tar.gz/docs/yaml/objects/exe.yaml Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/yaml/objects/external_program.yaml Added

@@ -0,0 +1,56 @@
+name: external_program
+long_name: External program
+description: Opaque object representing an external program
+
+methods:
+- name: found
+  returns: bool
+  description: Returns whether the executable was found.
+
+- name: path
+  returns: str
+  deprecated: 0.55.0
+  description: |
+    *Deprecated:* Use external_program.full_path instead.
+
+    Returns a string pointing to the script or executable.
+
+    **NOTE:** You should not usually need to use this method. Passing the
+    object itself should work in most contexts where a program can appear,
+    and allows Meson to setup inter-target dependencies correctly (for
+    example in cases where a program might be overridden by a build_tgt).
+    Only use this if you specifically need a string, such as when embedding
+    a program path into a header file.
+
+    For example:
+
+    ```meson
+    run_command(find_program('foo'), 'arg1', 'arg2')
+    ```
+
+- name: version
+  returns: str
+  since: 0.62.0
+  description: |
+    The version number as a string, for example `1.2.8`.
+
+    `unknown` if the program cannot determine the version via a `--version` argument.
+
+- name: full_path
+  returns: str
+  since: 0.55.0
+  description: |
+    Returns a string pointing to the script or executable.
+
+    **NOTE:** You should not usually need to use this method. Passing the
+    object itself should work in most contexts where a program can appear,
+    and allows Meson to setup inter-target dependencies correctly (for
+    example in cases where a program might be overridden by a build_tgt).
+    Only use this if you specifically need a string, such as when embedding
+    a program path into a header file.
+
+    For example:
+
+    ```meson
+    run_command(find_program('foo'), 'arg1', 'arg2')
+    ```

_service:tar_scm:meson-1.0.1.tar.gz/docs/yaml/objects/extracted_obj.yaml Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/yaml/objects/feature.yaml Added

@@ -0,0 +1,70 @@
+name: feature
+long_name: Feature option object
+since: 0.47.0
+description: Meson object representing a `feature` options(Build-options.md#features)
+
+methods:
+- name: enabled
+  returns: bool
+  description: Returns whether the feature was set to `'enabled'`
+
+- name: disabled
+  returns: bool
+  description: Returns whether the feature was set to `'disabled'`
+
+- name: auto
+  returns: bool
+  description: Returns whether the feature was set to `'auto'`
+
+- name: allowed
+  since: 0.59.0
+  returns: bool
+  description: Returns whether the feature was set to `'enabled'` or `'auto'`
+
+- name: disable_auto_if
+  since: 0.59.0
+  returns: feature
+  description: |
+    Returns the feature, with `'auto'` converted to `'disabled'` if value is true.
+
+    | Feature / Condition | `value = true` | `value = false` |
+    | ------------------- | -------------- | --------------- |
+    | Enabled             | Enabled        | Enabled         |
+    | Disabled            | Disabled       | Disabled        |
+    | Auto                | Disabled       | Auto            |
+
+  posargs:
+    value:
+      type: bool
+      description: See the table above
+
+- name: require
+  returns: feature
+  since: 0.59.0
+  description: |
+    Returns the object itself if the value is true; an error if the object is
+    `'enabled'` and the value is false; a disabled feature if the object
+    is `'auto'` or `'disabled'` and the value is false.
+
+  example: |
+    `require` is useful to restrict the applicability of `'auto'` features,
+    for example based on other features or on properties of the host machine:
+
+    ```
+    if get_option('directx').require(host_machine.system() == 'windows',
+          error_message: 'DirectX only available on Windows').allowed() then
+      src += 'directx.c'
+      config.set10('HAVE_DIRECTX', true)
+    endif
+    ```
+
+  posargs:
+    value:
+      type: bool
+      description: The value to check
+
+  kwargs:
+    error_message:
+      type: str
+      default: "''"
+      description: The error Message to print if the check fails

_service:tar_scm:meson-1.0.1.tar.gz/docs/yaml/objects/file.yaml Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/yaml/objects/generated_list.yaml Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/yaml/objects/generator.yaml Added

@@ -0,0 +1,36 @@
+name: generator
+long_name: Generator object
+description: |
+  This object is returned by generator and contains a
+  generator that is used to transform files from one type to another by
+  an executable (e.g. `idl` files into source code and headers).
+
+methods:
+  - name: process
+    returns: generated_list
+    description: |
+      Takes a list of files, causes them to be processed and returns an object containing the result
+      which can then, for example, be passed into a build target definition.
+
+    varargs:
+      name: source
+      min_varargs: 1
+      type: str | file | custom_tgt | custom_idx | generated_list
+      description: List of sources to process.
+
+    kwargs:
+      extra_args:
+        type: liststr
+        description: |
+          If present, will be used to replace an entry `@EXTRA_ARGS@` in the argument list.
+
+      preserve_path_from:
+        type: str
+        since: 0.45.0
+        description: |
+          If given, specifies that the output files need to maintain their directory structure
+          inside the target temporary directory. The most common value for this is
+          `meson.current_source_dir()`. With this value when a file called
+          `subdir/one.input` is processed it generates a file `{target private
+          directory}/subdir/one.out` as opposed to `{target private
+          directory}/one.out`.

_service:tar_scm:meson-1.0.1.tar.gz/docs/yaml/objects/inc.yaml Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/yaml/objects/jar.yaml Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/yaml/objects/lib.yaml Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/yaml/objects/module.yaml Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/yaml/objects/range.yaml Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/yaml/objects/run_tgt.yaml Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/yaml/objects/runresult.yaml Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/yaml/objects/structured_src.yaml Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/yaml/objects/subproject.yaml Added

_service:tar_scm:meson-1.0.1.tar.gz/docs/yaml/objects/tgt.yaml Added

_service:tar_scm:meson-0.63.2.tar.gz/man/meson.1 -> _service:tar_scm:meson-1.0.1.tar.gz/man/meson.1 Changed

_service:tar_scm:meson-1.0.1.tar.gz/manual tests/13 builddir upgrade Added

_service:tar_scm:meson-1.0.1.tar.gz/manual tests/13 builddir upgrade/data Added

_service:tar_scm:meson-1.0.1.tar.gz/manual tests/13 builddir upgrade/data/foo.dat Added

_service:tar_scm:meson-1.0.1.tar.gz/manual tests/13 builddir upgrade/foo.1 Added

_service:tar_scm:meson-1.0.1.tar.gz/manual tests/13 builddir upgrade/foo.c Added

_service:tar_scm:meson-1.0.1.tar.gz/manual tests/13 builddir upgrade/lib.c Added

_service:tar_scm:meson-1.0.1.tar.gz/manual tests/13 builddir upgrade/meson.build Added

_service:tar_scm:meson-1.0.1.tar.gz/manual tests/13 builddir upgrade/mod.py Added

_service:tar_scm:meson-0.63.2.tar.gz/meson.py -> _service:tar_scm:meson-1.0.1.tar.gz/meson.py Changed

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/arglist.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/arglist.py Changed

@@ -12,6 +12,7 @@
 # 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.
+from __future__ import annotations
 
 from functools import lru_cache
 import collections
@@ -20,16 +21,12 @@
 import re
 import typing as T
 
-from . import mesonlib
-
 if T.TYPE_CHECKING:
     from .linkers import StaticLinker
     from .compilers import Compiler
 
-UNIXY_COMPILER_INTERNAL_LIBS = 'm', 'c', 'pthread', 'dl', 'rt'  # type: T.Liststr
-# execinfo is a compiler lib on FreeBSD and NetBSD
-if mesonlib.is_freebsd() or mesonlib.is_netbsd():
-    UNIXY_COMPILER_INTERNAL_LIBS.append('execinfo')
+# execinfo is a compiler lib on BSD
+UNIXY_COMPILER_INTERNAL_LIBS = 'm', 'c', 'pthread', 'dl', 'rt', 'execinfo'  # type: T.Liststr
 
 
 class Dedup(enum.Enum):
@@ -53,7 +50,7 @@
     OVERRIDDEN = 2
 
 
-class CompilerArgs(collections.abc.MutableSequence):
+class CompilerArgs(T.MutableSequencestr):
     '''
     List-like class that manages a list of compiler arguments. Should be used
     while constructing compiler arguments from various sources. Can be
@@ -119,7 +116,7 @@
     # This correctly deduplicates the entries after _can_dedup definition
     # Note: This function is designed to work without delete operations, as deletions are worsening the performance a lot.
     def flush_pre_post(self) -> None:
-        new = list()                      # type: T.Liststr
+        new =                           # type: T.Liststr
         pre_flush_set = set()             # type: T.Setstr
         post_flush = collections.deque()  # type: T.Dequestr
         post_flush_set = set()            # type: T.Setstr
@@ -324,10 +321,10 @@
         return NotImplemented
 
     def append(self, arg: str) -> None:
-        self.__iadd__(arg)
+        self += arg
 
     def extend(self, args: T.Iterablestr) -> None:
-        self.__iadd__(args)
+        self += args
 
     def __repr__(self) -> str:
         self.flush_pre_post()

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/ast/interpreter.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/ast/interpreter.py Changed

@@ -14,8 +14,12 @@
 
 # This class contains the basic functionality needed to run any interpreter
 # or an interpreter-based tool.
+from __future__ import annotations
+
+import os
+import sys
+import typing as T
 
-from .visitor import AstVisitor
 from .. import mparser, mesonlib
 from .. import environment
 
@@ -26,8 +30,6 @@
     BreakRequest,
     ContinueRequest,
     default_resolve_key,
-    TYPE_nvar,
-    TYPE_nkwargs,
 )
 
 from ..interpreter import (
@@ -39,32 +41,33 @@
 )
 
 from ..mparser import (
-    AndNode,
     ArgumentNode,
     ArithmeticNode,
     ArrayNode,
     AssignmentNode,
     BaseNode,
-    ComparisonNode,
     ElementaryNode,
     EmptyNode,
-    ForeachClauseNode,
     IdNode,
-    IfClauseNode,
-    IndexNode,
     MethodNode,
     NotNode,
-    OrNode,
     PlusAssignmentNode,
     TernaryNode,
-    UMinusNode,
 )
 
-import os, sys
-import typing as T
-
 if T.TYPE_CHECKING:
+    from .visitor import AstVisitor
     from ..interpreter import Interpreter
+    from ..interpreterbase import TYPE_nkwargs, TYPE_nvar
+    from ..mparser import (
+        AndNode,
+        ComparisonNode,
+        ForeachClauseNode,
+        IfClauseNode,
+        IndexNode,
+        OrNode,
+        UMinusNode,
+    )
 
 class DontCareObject(MesonInterpreterObject):
     pass
@@ -362,10 +365,10 @@
                 result = not result
 
         elif isinstance(node, ArrayNode):
-            result = x for x in node.args.arguments
+            result = node.args.arguments.copy()
 
         elif isinstance(node, ArgumentNode):
-            result = x for x in node.arguments
+            result = node.arguments.copy()
 
         elif isinstance(node, ArithmeticNode):
             if node.operation != 'add':

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/ast/introspection.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/ast/introspection.py Changed

@@ -141,8 +141,8 @@
         options = {k: v for k, v in self.environment.options.items() if k.is_backend()}
 
         self.coredata.set_options(options)
-        self._add_languages(proj_langs, MachineChoice.HOST)
-        self._add_languages(proj_langs, MachineChoice.BUILD)
+        self._add_languages(proj_langs, True, MachineChoice.HOST)
+        self._add_languages(proj_langs, True, MachineChoice.BUILD)
 
     def do_subproject(self, dirname: str) -> None:
         subproject_dir_abs = os.path.join(self.environment.get_source_dir(), self.subproject_dir)
@@ -157,14 +157,17 @@
 
     def func_add_languages(self, node: BaseNode, args: T.ListTYPE_nvar, kwargs: T.Dictstr, TYPE_nvar) -> None:
         kwargs = self.flatten_kwargs(kwargs)
+        required = kwargs.get('required', True)
+        if isinstance(required, cdata.UserFeatureOption):
+            required = required.is_enabled()
         if 'native' in kwargs:
             native = kwargs.get('native', False)
-            self._add_languages(args, MachineChoice.BUILD if native else MachineChoice.HOST)
+            self._add_languages(args, required, MachineChoice.BUILD if native else MachineChoice.HOST)
         else:
             for for_machine in MachineChoice.BUILD, MachineChoice.HOST:
-                self._add_languages(args, for_machine)
+                self._add_languages(args, required, for_machine)
 
-    def _add_languages(self, raw_langs: T.ListTYPE_nvar, for_machine: MachineChoice) -> None:
+    def _add_languages(self, raw_langs: T.ListTYPE_nvar, required: bool, for_machine: MachineChoice) -> None:
         langs =   # type: T.Liststr
         for l in self.flatten_args(raw_langs):
             if isinstance(l, str):
@@ -175,7 +178,14 @@
         for lang in sorted(langs, key=compilers.sort_clink):
             lang = lang.lower()
             if lang not in self.coredata.compilersfor_machine:
-                comp = detect_compiler_for(self.environment, lang, for_machine)
+                try:
+                    comp = detect_compiler_for(self.environment, lang, for_machine)
+                except mesonlib.MesonException:
+                    # do we even care about introspecting this language?
+                    if required:
+                        raise
+                    else:
+                        continue
                 if self.subproject:
                     options = {}
                     for k in comp.get_options():
@@ -261,7 +271,7 @@
         extraf_nodes = traverse_nodes(extra_queue)
 
         # Make sure nothing can crash when creating the build class
-        kwargs_reduced = {k: v for k, v in kwargs.items() if k in targetclass.known_kwargs and k in 'install', 'build_by_default', 'build_always'}
+        kwargs_reduced = {k: v for k, v in kwargs.items() if k in targetclass.known_kwargs and k in {'install', 'build_by_default', 'build_always'}}
         kwargs_reduced = {k: v.value if isinstance(v, ElementaryNode) else v for k, v in kwargs_reduced.items()}
         kwargs_reduced = {k: v for k, v in kwargs_reduced.items() if not isinstance(v, BaseNode)}
         for_machine = MachineChoice.HOST

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/ast/postprocess.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/ast/postprocess.py Changed

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/ast/printer.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/ast/printer.py Changed

@@ -14,6 +14,7 @@
 
 # This class contains the basic functionality needed to run any interpreter
 # or an interpreter-based tool
+from __future__ import annotations
 
 from .. import mparser
 from . import AstVisitor
@@ -72,9 +73,13 @@
         self.append(str(node.value), node)
         node.lineno = self.curr_line or node.lineno
 
+    def escape(self, val: str) -> str:
+        return val.translate(str.maketrans({'\'': '\\\'',
+                                            '\\': '\\\\'}))
+
     def visit_StringNode(self, node: mparser.StringNode) -> None:
         assert isinstance(node.value, str)
-        self.append("'" + node.value + "'", node)
+        self.append("'" + self.escape(node.value) + "'", node)
         node.lineno = self.curr_line or node.lineno
 
     def visit_FormatStringNode(self, node: mparser.FormatStringNode) -> None:
@@ -169,9 +174,8 @@
 
     def visit_ForeachClauseNode(self, node: mparser.ForeachClauseNode) -> None:
         node.lineno = self.curr_line or node.lineno
-        varnames = x for x in node.varnames
         self.append_padded('foreach', node)
-        self.append_padded(', '.join(varnames), node)
+        self.append_padded(', '.join(node.varnames), node)
         self.append_padded(':', node)
         node.items.accept(self)
         self.newline()

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/ast/visitor.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/ast/visitor.py Changed

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/backend/backends.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/backend/backends.py Changed

@@ -18,11 +18,13 @@
 from functools import lru_cache
 from itertools import chain
 from pathlib import Path
+import copy
 import enum
 import json
 import os
 import pickle
 import re
+import shutil
 import typing as T
 import hashlib
 
@@ -34,7 +36,8 @@
 from ..compilers import LANGUAGES_USING_LDFLAGS, detect
 from ..mesonlib import (
     File, MachineChoice, MesonException, OrderedSet,
-    classify_unity_sources, OptionKey, join_args
+    classify_unity_sources, OptionKey, join_args,
+    ExecutableSerialisation
 )
 
 if T.TYPE_CHECKING:
@@ -48,6 +51,8 @@
 
     from typing_extensions import TypedDict
 
+    _ALL_SOURCES_TYPE = T.ListT.UnionFile, build.CustomTarget, build.CustomTargetIndex, build.GeneratedList
+
     class TargetIntrospectionData(TypedDict):
 
         language: str
@@ -185,27 +190,6 @@
         super().__init__(path, install_path, install_path_name, install_mode, subproject, tag, data_type)
         self.exclude = exclude
 
-@dataclass(eq=False)
-class ExecutableSerialisation:
-
-    # XXX: should capture and feed default to False, instead of None?
-
-    cmd_args: T.Liststr
-    env: T.Optionalbuild.EnvironmentVariables = None
-    exe_wrapper: T.Optional'programs.ExternalProgram' = None
-    workdir: T.Optionalstr = None
-    extra_paths: T.OptionalT.List = None
-    capture: T.Optionalbool = None
-    feed: T.Optionalbool = None
-    tag: T.Optionalstr = None
-    verbose: bool = False
-
-    def __post_init__(self) -> None:
-        if self.exe_wrapper is not None:
-            assert isinstance(self.exe_wrapper, programs.ExternalProgram)
-        self.pickled = False
-        self.skip_if_destdir = False
-        self.subproject = ''
 
 @dataclass(eq=False)
 class TestSerialisation:
@@ -305,7 +289,7 @@
         elif isinstance(t, build.CustomTargetIndex):
             filename = t.get_outputs()0
         else:
-            assert isinstance(t, build.BuildTarget)
+            assert isinstance(t, build.BuildTarget), t
             filename = t.get_filename()
         return os.path.join(self.get_target_dir(t), filename)
 
@@ -452,18 +436,20 @@
         return os.path.relpath(os.path.join('dummyprefixdir', todir),
                                os.path.join('dummyprefixdir', fromdir))
 
-    def flatten_object_list(self, target: build.BuildTarget, proj_dir_to_build_root: str = '') -> T.Liststr:
-        obj_list = self._flatten_object_list(target, target.get_objects(), proj_dir_to_build_root)
-        return list(dict.fromkeys(obj_list))
+    def flatten_object_list(self, target: build.BuildTarget, proj_dir_to_build_root: str = ''
+                            ) -> T.TupleT.Liststr, T.Listbuild.BuildTargetTypes:
+        obj_list, deps = self._flatten_object_list(target, target.get_objects(), proj_dir_to_build_root)
+        return list(dict.fromkeys(obj_list)), deps
 
     def determine_ext_objs(self, objects: build.ExtractedObjects, proj_dir_to_build_root: str = '') -> T.Liststr:
-        obj_list = self._flatten_object_list(objects.target, objects, proj_dir_to_build_root)
+        obj_list, _ = self._flatten_object_list(objects.target, objects, proj_dir_to_build_root)
         return list(dict.fromkeys(obj_list))
 
     def _flatten_object_list(self, target: build.BuildTarget,
                              objects: T.SequenceT.Unionstr, 'File', build.ExtractedObjects,
-                             proj_dir_to_build_root: str) -> T.Liststr:
+                             proj_dir_to_build_root: str) -> T.TupleT.Liststr, T.Listbuild.BuildTargetTypes:
         obj_list: T.Liststr = 
+        deps: T.Listbuild.BuildTargetTypes = 
         for obj in objects:
             if isinstance(obj, str):
                 o = os.path.join(proj_dir_to_build_root,
@@ -480,11 +466,14 @@
                     obj_list.append(obj.rel_to_builddir(o))
             elif isinstance(obj, build.ExtractedObjects):
                 if obj.recursive:
-                    obj_list += self._flatten_object_list(obj.target, obj.objlist, proj_dir_to_build_root)
-                obj_list += self._determine_ext_objs(obj, proj_dir_to_build_root)
+                    objs, d = self._flatten_object_list(obj.target, obj.objlist, proj_dir_to_build_root)
+                    obj_list.extend(objs)
+                    deps.extend(d)
+                obj_list.extend(self._determine_ext_objs(obj, proj_dir_to_build_root))
+                deps.append(obj.target)
             else:
                 raise MesonException('Unknown data type in object list.')
-        return obj_list
+        return obj_list, deps
 
     @staticmethod
     def is_swift_target(target: build.BuildTarget) -> bool:
@@ -599,9 +588,19 @@
         if any('\n' in c for c in es.cmd_args):
             reasons.append('because command contains newlines')
 
-        if es.env and es.env.varnames:
+        if env and env.varnames:
             reasons.append('to set env')
 
+        # force_serialize passed to this function means that the VS backend has
+        # decided it absolutely cannot use real commands. This is "always",
+        # because it's not clear what will work (other than compilers) and so
+        # we don't bother to handle a variety of common cases that probably do
+        # work.
+        #
+        # It's also overridden for a few conditions that can't be handled
+        # inside a command line
+
+        can_use_env = not force_serialize
         force_serialize = force_serialize or bool(reasons)
 
         if capture:
@@ -609,6 +608,12 @@
         if feed:
             reasons.append('to feed input')
 
+        if can_use_env and reasons == 'to set env' and shutil.which('env'):
+            envlist = 
+            for k, v in env.get_env({}).items():
+                envlist.append(f'{k}={v}')
+            return 'env' + envlist + es.cmd_args, ', '.join(reasons)
+
         if not force_serialize:
             if not capture and not feed:
                 return es.cmd_args, ''
@@ -776,12 +781,22 @@
 
     @staticmethod
     def canonicalize_filename(fname: str) -> str:
+        parts = Path(fname).parts
+        hashed = ''
+        if len(parts) > 5:
+            temp = '/'.join(parts-5:)
+            # is it shorter to hash the beginning of the path?
+            if len(fname) > len(temp) + 41:
+                hashed = hashlib.sha1(fname.encode('utf-8')).hexdigest() + '_'
+                fname = temp
         for ch in ('/', '\\', ':'):
             fname = fname.replace(ch, '_')
-        return fname
+        return hashed + fname
 
     def object_filename_from_source(self, target: build.BuildTarget, source: 'FileOrString') -> str:
         assert isinstance(source, mesonlib.File)
+        if isinstance(target, build.CompileTarget):
+            return target.sources_mapsource
         build_dir = self.environment.get_build_dir()
         rel_src = source.rel_to_builddir(self.build_to_src)
 
@@ -826,7 +841,7 @@
         # Filter out headers and all non-source files
         sources: T.List'FileOrString' = 
         for s in raw_sources:
-            if self.environment.is_source(s) and not self.environment.is_header(s):
+            if self.environment.is_source(s):
                 sources.append(s)
             elif self.environment.is_object(s):
                 result.append(s.relative_name())
@@ -952,15 +967,15 @@
         # Add compile args added using add_global_arguments()
         # These override per-project arguments
         commands += self.build.get_global_args(compiler, target.for_machine)
-        # Using both /ZI and /Zi at the same times produces a compiler warning.
-        # We do not add /ZI by default. If it is being used it is because the user has explicitly enabled it.
-        # /ZI needs to be removed in that case to avoid cl's warning to that effect (D9025 : overriding '/ZI' with '/Zi')
-        if ('/ZI' in commands) and ('/Zi' in commands):
-            commands.remove('/Zi')
         # Compile args added from the env: CFLAGS/CXXFLAGS, etc, or the cross
         # file. We want these to override all the defaults, but not the
         # per-target compile args.
         commands += self.environment.coredata.get_external_args(target.for_machine, compiler.get_language())
+        # Using both /Z7 or /ZI and /Zi at the same times produces a compiler warning.
+        # We do not add /Z7 or /ZI by default. If it is being used it is because the user has explicitly enabled it.
+        # /Zi needs to be removed in that case to avoid cl's warning to that effect (D9025 : overriding '/Zi' with '/ZI')
+        if ('/Zi' in commands) and (('/ZI' in commands) or ('/Z7' in commands)):
+            commands.remove('/Zi')
         # Always set -fPIC for shared libraries
         if isinstance(target, build.SharedLibrary):
             commands += compiler.get_pic_args()
@@ -1093,10 +1108,7 @@
                         break
 
             is_cross = self.environment.is_cross_build(test_for_machine)
-            if is_cross and self.environment.need_exe_wrapper():
-                exe_wrapper = self.environment.get_exe_wrapper()
-            else:
-                exe_wrapper = None
+            exe_wrapper = self.environment.get_exe_wrapper()
             machine = self.environment.machinesexe.for_machine
             if machine.is_windows() or machine.is_cygwin():
                 extra_bdeps: T.ListT.Unionbuild.BuildTarget, build.CustomTarget = 
@@ -1127,9 +1139,21 @@
                     cmd_args.extend(self.construct_target_rel_paths(a, t.workdir))
                 else:
                     raise MesonException('Bad object in test command.')
+
+            t_env = copy.deepcopy(t.env)
+            if not machine.is_windows() and not machine.is_cygwin() and not machine.is_darwin():
+                ld_lib_path: T.Setstr = set()
+                for d in depends:
+                    if isinstance(d, build.BuildTarget):
+                        for l in d.get_all_link_deps():
+                            if isinstance(l, build.SharedLibrary):
+                                ld_lib_path.add(os.path.join(self.environment.get_build_dir(), l.get_subdir()))
+                if ld_lib_path:
+                    t_env.prepend('LD_LIBRARY_PATH', list(ld_lib_path), ':')
+
             ts = TestSerialisation(t.get_name(), t.project_name, t.suite, cmd, is_cross,
                                    exe_wrapper, self.environment.need_exe_wrapper(),
-                                   t.is_parallel, cmd_args, t.env,
+                                   t.is_parallel, cmd_args, t_env,
                                    t.should_fail, t.timeout, t.workdir,
                                    extra_paths, t.protocol, t.priority,
                                    isinstance(exe, build.Target),
@@ -1180,7 +1204,7 @@
         '''List of all files whose alteration means that the build
         definition needs to be regenerated.'''
         deps = OrderedSet(str(Path(self.build_to_src) / df)
-                for df in self.interpreter.get_build_def_files())
+                           for df in self.interpreter.get_build_def_files())
         if self.environment.is_cross_build():
             deps.update(self.environment.coredata.cross_files)
         deps.update(self.environment.coredata.config_files)
@@ -1527,6 +1551,10 @@
             return 'devel'
         elif localedir in dest_path.parents:
             return 'i18n'
+        elif 'installed-tests' in dest_path.parts:
+            return 'tests'
+        elif 'systemtap' in dest_path.parts:
+            return 'systemtap'
         mlog.debug('Failed to guess install tag for', dest_path)
         return None
 
@@ -1534,17 +1562,19 @@
         for t in self.build.get_targets().values():
             if not t.should_install():
                 continue
-            outdirs, default_install_dir_name, custom_install_dir = t.get_install_dir()
+            outdirs, install_dir_names, custom_install_dir = t.get_install_dir()
             # Sanity-check the outputs and install_dirs
             num_outdirs, num_out = len(outdirs), len(t.get_outputs())
-            if num_outdirs != 1 and num_outdirs != num_out:
+            if num_outdirs not in {1, num_out}:
                 m = 'Target {!r} has {} outputs: {!r}, but only {} "install_dir"s were found.\n' \
                     "Pass 'false' for outputs that should not be installed and 'true' for\n" \
                     'using the default installation directory for an output.'
                 raise MesonException(m.format(t.name, num_out, t.get_outputs(), num_outdirs))
             assert len(t.install_tag) == num_out
             install_mode = t.get_custom_install_mode()
-            first_outdir = outdirs0  # because mypy get's confused type narrowing in lists
+            # because mypy gets confused type narrowing in lists
+            first_outdir = outdirs0
+            first_outdir_name = install_dir_names0
 
             # Install the target output(s)
             if isinstance(t, build.BuildTarget):
@@ -1570,7 +1600,7 @@
                     tag = t.install_tag0 or ('devel' if isinstance(t, build.StaticLibrary) else 'runtime')
                     mappings = t.get_link_deps_mapping(d.prefix)
                     i = TargetInstallData(self.get_target_filename(t), first_outdir,
-                                          default_install_dir_name,
+                                          first_outdir_name,
                                           should_strip, mappings, t.rpath_dirs_to_remove,
                                           t.install_rpath, install_mode, t.subproject,
                                           tag=tag, can_strip=can_strip)
@@ -1595,7 +1625,7 @@
                                 implib_install_dir = self.environment.get_import_lib_dir()
                             # Install the import library; may not exist for shared modules
                             i = TargetInstallData(self.get_target_filename_for_linking(t),
-                                                  implib_install_dir, default_install_dir_name,
+                                                  implib_install_dir, first_outdir_name,
                                                   False, {}, set(), '', install_mode,
                                                   t.subproject, optional=isinstance(t, build.SharedModule),
                                                   tag='devel')
@@ -1604,19 +1634,19 @@
                         if not should_strip and t.get_debug_filename():
                             debug_file = os.path.join(self.get_target_dir(t), t.get_debug_filename())
                             i = TargetInstallData(debug_file, first_outdir,
-                                                  default_install_dir_name,
+                                                  first_outdir_name,
                                                   False, {}, set(), '',
                                                   install_mode, t.subproject,
                                                   optional=True, tag='devel')
                             d.targets.append(i)
                 # Install secondary outputs. Only used for Vala right now.
                 if num_outdirs > 1:
-                    for output, outdir, tag in zip(t.get_outputs()1:, outdirs1:, t.install_tag1:):
+                    for output, outdir, outdir_name, tag in zip(t.get_outputs()1:, outdirs1:, install_dir_names1:, t.install_tag1:):
                         # User requested that we not install this output
                         if outdir is False:
                             continue
                         f = os.path.join(self.get_target_dir(t), output)
-                        i = TargetInstallData(f, outdir, default_install_dir_name, False, {}, set(), None,
+                        i = TargetInstallData(f, outdir, outdir_name, False, {}, set(), None,
                                               install_mode, t.subproject,
                                               tag=tag)
                         d.targets.append(i)
@@ -1634,19 +1664,21 @@
                 if num_outdirs == 1 and num_out > 1:
                     if first_outdir is not False:
                         for output, tag in zip(t.get_outputs(), t.install_tag):
+                            tag = tag or self.guess_install_tag(output, first_outdir)
                             f = os.path.join(self.get_target_dir(t), output)
-                            i = TargetInstallData(f, first_outdir, default_install_dir_name,
+                            i = TargetInstallData(f, first_outdir, first_outdir_name,
                                                   False, {}, set(), None, install_mode,
                                                   t.subproject, optional=not t.build_by_default,
                                                   tag=tag)
                             d.targets.append(i)
                 else:
-                    for output, outdir, tag in zip(t.get_outputs(), outdirs, t.install_tag):
+                    for output, outdir, outdir_name, tag in zip(t.get_outputs(), outdirs, install_dir_names, t.install_tag):
                         # User requested that we not install this output
                         if outdir is False:
                             continue
+                        tag = tag or self.guess_install_tag(output, outdir)
                         f = os.path.join(self.get_target_dir(t), output)
-                        i = TargetInstallData(f, outdir, default_install_dir_name,
+                        i = TargetInstallData(f, outdir, outdir_name,
                                               False, {}, set(), None, install_mode,
                                               t.subproject, optional=not t.build_by_default,
                                               tag=tag)
@@ -1654,6 +1686,9 @@
 
     def generate_custom_install_script(self, d: InstallData) -> None:
         d.install_scripts = self.build.install_scripts
+        for i in d.install_scripts:
+            if not i.tag:
+                mlog.debug('Failed to guess install tag for install script:', ' '.join(i.cmd_args))
 
     def generate_header_install(self, d: InstallData) -> None:
         incroot = self.environment.get_includedir()
@@ -1703,7 +1738,8 @@
     def generate_emptydir_install(self, d: InstallData) -> None:
         emptydir: T.Listbuild.EmptyDir = self.build.get_emptydir()
         for e in emptydir:
-            i = InstallEmptyDir(e.path, e.install_mode, e.subproject, e.install_tag)
+            tag = e.install_tag or self.guess_install_tag(e.path)
+            i = InstallEmptyDir(e.path, e.install_mode, e.subproject, tag)
             d.emptydir.append(i)
 
     def generate_data_install(self, d: InstallData) -> None:
@@ -1732,7 +1768,8 @@
             assert isinstance(l, build.SymlinkData)
             install_dir = l.install_dir
             name_abs = os.path.join(install_dir, l.name)
-            s = InstallSymlinkData(l.target, name_abs, install_dir, l.subproject, l.install_tag)
+            tag = l.install_tag or self.guess_install_tag(name_abs)
+            s = InstallSymlinkData(l.target, name_abs, install_dir, l.subproject, tag)
             d.symlinks.append(s)
 
     def generate_subdir_install(self, d: InstallData) -> None:
@@ -1747,10 +1784,13 @@
             dst_dir = os.path.join(self.environment.get_prefix(),
                                    sd.install_dir)
             dst_name = os.path.join('{prefix}', sd.install_dir)
+            if sd.install_dir != sd.install_dir_name:
+                dst_name = sd.install_dir_name
             if not sd.strip_directory:
                 dst_dir = os.path.join(dst_dir, os.path.basename(src_dir))
-                dst_name = os.path.join(dst_dir, os.path.basename(src_dir))
-            i = SubdirInstallData(src_dir, dst_dir, dst_name, sd.install_mode, sd.exclude, sd.subproject, sd.install_tag)
+                dst_name = os.path.join(dst_name, os.path.basename(src_dir))
+            tag = sd.install_tag or self.guess_install_tag(os.path.join(sd.install_dir, 'dummy'))
+            i = SubdirInstallData(src_dir, dst_dir, dst_name, sd.install_mode, sd.exclude, sd.subproject, tag)
             d.install_subdirs.append(i)
 
     def get_introspection_data(self, target_id: str, target: build.Target) -> T.List'TargetIntrospectionData':
@@ -1778,7 +1818,7 @@
                     source_list += os.path.join(self.source_dir, j)
                 elif isinstance(j, (build.CustomTarget, build.BuildTarget)):
                     source_list += os.path.join(self.build_dir, j.get_subdir(), o) for o in j.get_outputs()
-            source_list = list(map(lambda x: os.path.normpath(x), source_list))
+            source_list = os.path.normpath(s) for s in source_list
 
             compiler: T.Liststr = 
             if isinstance(target, build.CustomTarget):
@@ -1807,14 +1847,12 @@
         env = build.EnvironmentVariables()
         extra_paths = set()
         library_paths = set()
+        build_machine = self.environment.machinesMachineChoice.BUILD
         host_machine = self.environment.machinesMachineChoice.HOST
-        need_exe_wrapper = self.environment.need_exe_wrapper()
-        need_wine = need_exe_wrapper and host_machine.is_windows()
+        need_wine = not build_machine.is_windows() and host_machine.is_windows()
         for t in self.build.get_targets().values():
-            cross_built = not self.environment.machines.matches_build_machine(t.for_machine)
-            can_run = not cross_built or not need_exe_wrapper or need_wine
             in_default_dir = t.should_install() and not t.get_install_dir()2
-            if not can_run or not in_default_dir:
+            if t.for_machine != MachineChoice.HOST or not in_default_dir:
                 continue
             tdir = os.path.join(self.environment.get_build_dir(), self.get_target_dir(t))
             if isinstance(t, build.Executable):
@@ -1831,16 +1869,46 @@
                 # LD_LIBRARY_PATH. This allows running system applications using
                 # that library.
                 library_paths.add(tdir)
+        if need_wine:
+            # Executable paths should be in both PATH and WINEPATH.
+            # - Having them in PATH makes bash completion find it,
+            #   and make running "foo.exe" find it when wine-binfmt is installed.
+            # - Having them in WINEPATH makes "wine foo.exe" find it.
+            library_paths.update(extra_paths)
         if library_paths:
-            if host_machine.is_windows() or host_machine.is_cygwin():
+            if need_wine:
+                env.prepend('WINEPATH', list(library_paths), separator=';')
+            elif host_machine.is_windows() or host_machine.is_cygwin():
                 extra_paths.update(library_paths)
             elif host_machine.is_darwin():
                 env.prepend('DYLD_LIBRARY_PATH', list(library_paths))
             else:
                 env.prepend('LD_LIBRARY_PATH', list(library_paths))
         if extra_paths:
-            if need_wine:
-                env.prepend('WINEPATH', list(extra_paths), separator=';')
-            else:
-                env.prepend('PATH', list(extra_paths))
+            env.prepend('PATH', list(extra_paths))
         return env
+
+    def compiler_to_generator(self, target: build.BuildTarget,
+                              compiler: 'Compiler',
+                              sources: _ALL_SOURCES_TYPE,
+                              output_templ: str) -> build.GeneratedList:
+        '''
+        Some backends don't support custom compilers. This is a convenience
+        method to convert a Compiler to a Generator.
+        '''
+        exelist = compiler.get_exelist()
+        exe = programs.ExternalProgram(exelist0)
+        args = exelist1:
+        # FIXME: There are many other args missing
+        commands = self.generate_basic_compiler_args(target, compiler)
+        commands += compiler.get_dependency_gen_args('@OUTPUT@', '@DEPFILE@')
+        commands += compiler.get_output_args('@OUTPUT@')
+        commands += compiler.get_compile_only_args() + '@INPUT@'
+        commands += self.get_source_dir_include_args(target, compiler)
+        commands += self.get_build_dir_include_args(target, compiler)
+        generator = build.Generator(exe, args + commands.to_native(), output_templ, depfile='@PLAINNAME@.d')
+        return generator.process_files(sources, self.interpreter)
+
+    def compile_target_to_generator(self, target: build.CompileTarget) -> build.GeneratedList:
+        all_sources = T.cast('_ALL_SOURCES_TYPE', target.sources) + T.cast('_ALL_SOURCES_TYPE', target.generated)
+        return self.compiler_to_generator(target, target.compiler, all_sources, target.output_templ)

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/backend/ninjabackend.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/backend/ninjabackend.py Changed

@@ -14,6 +14,7 @@
 from __future__ import annotations
 
 from collections import OrderedDict
+from dataclasses import dataclass
 from enum import Enum, unique
 from functools import lru_cache
 from pathlib import PurePath, Path
@@ -35,13 +36,7 @@
 from .. import mlog
 from .. import compilers
 from ..arglist import CompilerArgs
-from ..compilers import (
-    Compiler, CCompiler,
-    FortranCompiler,
-    mixins,
-    PGICCompiler,
-    VisualStudioLikeCompiler,
-)
+from ..compilers import Compiler
 from ..linkers import ArLinker, RSPFileSyntax
 from ..mesonlib import (
     File, LibType, MachineChoice, MesonException, OrderedSet, PerMachine,
@@ -52,11 +47,16 @@
 from ..build import GeneratedList, InvalidArguments
 
 if T.TYPE_CHECKING:
+    from typing_extensions import Literal
+
     from .._typing import ImmutableListProtocol
     from ..build import ExtractedObjects
     from ..interpreter import Interpreter
     from ..linkers import DynamicLinker, StaticLinker
     from ..compilers.cs import CsCompiler
+    from ..compilers.fortran import FortranCompiler
+
+    RUST_EDITIONS = Literal'2015', '2018', '2021'
 
 
 FORTRAN_INCLUDE_PAT = r"^\s*#?include\s*'\"(\w+\.\w+)'\""
@@ -209,8 +209,8 @@
             return NinjaCommandArg(c)
 
         self.name = rule
-        self.command = list(map(strToCommandArg, command))  # includes args which never go into a rspfile
-        self.args = list(map(strToCommandArg, args))  # args which will go into a rspfile, if used
+        self.command = strToCommandArg(c) for c in command  # includes args which never go into a rspfile
+        self.args = strToCommandArg(a) for a in args  # args which will go into a rspfile, if used
         self.description = description
         self.deps = deps  # depstyle 'gcc' or 'msvc'
         self.depfile = depfile
@@ -314,6 +314,7 @@
         self.orderdeps = OrderedSet()
         self.elems = 
         self.all_outputs = all_outputs
+        self.output_errors = ''
 
     def add_dep(self, dep):
         if isinstance(dep, list):
@@ -362,7 +363,8 @@
                 self.rule.refcount += 1
 
     def write(self, outfile):
-        self.check_outputs()
+        if self.output_errors:
+            raise MesonException(self.output_errors)
         ins = ' '.join(ninja_quote(i, True) for i in self.infilenames)
         outs = ' '.join(ninja_quote(i, True) for i in self.outfilenames)
         implicit_outs = ' '.join(ninja_quote(i, True) for i in self.implicit_outfilenames)
@@ -421,9 +423,59 @@
     def check_outputs(self):
         for n in self.outfilenames:
             if n in self.all_outputs:
-                raise MesonException(f'Multiple producers for Ninja target "{n}". Please rename your targets.')
+                self.output_errors = f'Multiple producers for Ninja target "{n}". Please rename your targets.'
             self.all_outputsn = True
 
+@dataclass
+class RustDep:
+
+    name: str
+
+    # equal to the order value of the `RustCrate`
+    crate: int
+
+    def to_json(self) -> T.Dictstr, object:
+        return {
+            "crate": self.crate,
+            "name": self.name,
+        }
+
+@dataclass
+class RustCrate:
+
+    # When the json file is written, the list of Crates will be sorted by this
+    # value
+    order: int
+
+    display_name: str
+    root_module: str
+    edition: RUST_EDITIONS
+    deps: T.ListRustDep
+    cfg: T.Liststr
+    is_proc_macro: bool
+
+    # This is set to True for members of this project, and False for all
+    # subprojects
+    is_workspace_member: bool
+    proc_macro_dylib_path: T.Optionalstr = None
+
+    def to_json(self) -> T.Dictstr, object:
+        ret: T.Dictstr, object = {
+            "display_name": self.display_name,
+            "root_module": self.root_module,
+            "edition": self.edition,
+            "cfg": self.cfg,
+            "is_proc_macro": self.is_proc_macro,
+            "deps": d.to_json() for d in self.deps,
+        }
+
+        if self.is_proc_macro:
+            assert self.proc_macro_dylib_path is not None, "This shouldn't happen"
+            ret"proc_macro_dylib_path" = self.proc_macro_dylib_path
+
+        return ret
+
+
 class NinjaBackend(backends.Backend):
 
     def __init__(self, build: T.Optionalbuild.Build, interpreter: T.OptionalInterpreter):
@@ -434,6 +486,7 @@
         self.all_outputs = {}
         self.introspection_data = {}
         self.created_llvm_ir_rule = PerMachine(False, False)
+        self.rust_crates: T.Dictstr, RustCrate = {}
 
     def create_phony_target(self, all_outputs, dummy_outfile, rulename, phony_infilename, implicit_outs=None):
         '''
@@ -459,19 +512,20 @@
         for compiler in self.environment.coredata.compilers.host.values():
             # Have to detect the dependency format
 
-            # IFort on windows is MSVC like, but doesn't have /showincludes
-            if isinstance(compiler, FortranCompiler):
+            # IFort / masm on windows is MSVC like, but doesn't have /showincludes
+            if compiler.language in {'fortran', 'masm'}:
                 continue
-            if isinstance(compiler, PGICCompiler) and mesonlib.is_windows():
+            if compiler.id == 'pgi' and mesonlib.is_windows():
                 # for the purpose of this function, PGI doesn't act enough like MSVC
                 return open(tempfilename, 'a', encoding='utf-8')
-            if isinstance(compiler, VisualStudioLikeCompiler):
+            if compiler.get_argument_syntax() == 'msvc':
                 break
         else:
             # None of our compilers are MSVC, we're done.
             return open(tempfilename, 'a', encoding='utf-8')
+        filebase = 'incdetect.' + compilers.lang_suffixescompiler.language0
         filename = os.path.join(self.environment.get_scratch_dir(),
-                                'incdetect.c')
+                                filebase)
         with open(filename, 'w', encoding='utf-8') as f:
             f.write(dedent('''\
                 #include<stdio.h>
@@ -483,7 +537,7 @@
         # Python strings leads to failure. We _must_ do this detection
         # in raw byte mode and write the result in raw bytes.
         pc = subprocess.Popen(compiler.get_exelist() +
-                              '/showIncludes', '/c', 'incdetect.c',
+                              '/showIncludes', '/c', filebase,
                               cwd=self.environment.get_scratch_dir(),
                               stdout=subprocess.PIPE, stderr=subprocess.PIPE)
         (stdout, stderr) = pc.communicate()
@@ -499,7 +553,7 @@
         # use backslashes, but without the leading drive name, so
         # allow the path to start with any path separator, i.e.
         # \MyDir\include\stdio.h.
-        matchre = re.compile(rb"^(.*\s)(a-zA-Z:\\|\\\/).*stdio.h$")
+        matchre = re.compile(rb"^(.*\s)(a-zA-Z:\\/|\\\/).*stdio.h$")
 
         def detect_prefix(out):
             for line in re.split(rb'\r?\n', out):
@@ -516,7 +570,7 @@
         if result:
             return result
 
-        raise MesonException('Could not determine vs dep dependency prefix string.')
+        raise MesonException(f'Could not determine vs dep dependency prefix string. output: {stderr} {stdout}')
 
     def generate(self):
         ninja = environment.detect_ninja_command_and_version(log=True)
@@ -593,6 +647,21 @@
             subprocess.call(self.ninja_command + '-t', 'restat')
             subprocess.call(self.ninja_command + '-t', 'cleandead')
         self.generate_compdb()
+        self.generate_rust_project_json()
+
+    def generate_rust_project_json(self) -> None:
+        """Generate a rust-analyzer compatible rust-project.json file."""
+        if not self.rust_crates:
+            return
+        with open(os.path.join(self.environment.get_build_dir(), 'rust-project.json'),
+                  'w', encoding='utf-8') as f:
+            json.dump(
+                {
+                    "sysroot_src": os.path.join(self.environment.coredata.compilers.host'rust'.get_sysroot(),
+                                                'lib/rustlib/src/rust/library/'),
+                    "crates": c.to_json() for c in self.rust_crates.values(),
+                },
+                f, indent=4)
 
     # http://clang.llvm.org/docs/JSONCompilationDatabase.html
     def generate_compdb(self):
@@ -600,10 +669,10 @@
         # TODO: Rather than an explicit list here, rules could be marked in the
         # rule store as being wanted in compdb
         for for_machine in MachineChoice:
-            for lang in self.environment.coredata.compilersfor_machine:
-                rules += f"{rule}{ext}" for rule in self.get_compiler_rule_name(lang, for_machine)
+            for compiler in self.environment.coredata.compilersfor_machine.values():
+                rules += f"{rule}{ext}" for rule in self.compiler_to_rule_name(compiler)
                           for ext in '', '_RSP'
-                rules += f"{rule}{ext}" for rule in self.get_pch_rule_name(lang, for_machine)
+                rules += f"{rule}{ext}" for rule in self.compiler_to_pch_rule_name(compiler)
                           for ext in '', '_RSP'
         compdb_options = '-x' if mesonlib.version_compare(self.ninja_version, '>=1.9') else 
         ninja_compdb = self.ninja_command + '-t', 'compdb' + compdb_options + rules
@@ -641,14 +710,14 @@
     def get_target_generated_sources(self, target: build.BuildTarget) -> T.MutableMappingstr, File:
         """
         Returns a dictionary with the keys being the path to the file
-        (relative to the build directory) of that type and the value
-        being the GeneratorList or CustomTarget that generated it.
+        (relative to the build directory) and the value being the File object
+        representing the same path.
         """
         srcs: T.MutableMappingstr, File = OrderedDict()
         for gensrc in target.get_generated_sources():
             for s in gensrc.get_outputs():
-                f = self.get_target_generated_dir(target, gensrc, s)
-                srcsf = s
+                rel_src = self.get_target_generated_dir(target, gensrc, s)
+                srcsrel_src = File.from_built_relative(rel_src)
         return srcs
 
     def get_target_sources(self, target: build.BuildTarget) -> T.MutableMappingstr, File:
@@ -815,9 +884,8 @@
         # same time, also deal with generated sources that need to be compiled.
         generated_source_files = 
         for rel_src in generated_sources.keys():
-            dirpart, fnamepart = os.path.split(rel_src)
-            raw_src = File(True, dirpart, fnamepart)
-            if self.environment.is_source(rel_src) and not self.environment.is_header(rel_src):
+            raw_src = File.from_built_relative(rel_src)
+            if self.environment.is_source(rel_src):
                 if is_unity and self.get_target_source_can_unity(target, rel_src):
                     unity_deps.append(raw_src)
                     abs_src = os.path.join(self.environment.get_build_dir(), rel_src)
@@ -859,6 +927,16 @@
         else:
             pch_objects = 
 
+        o, od = self.flatten_object_list(target)
+        obj_targets = t for t in od if t.uses_fortran()
+        obj_list.extend(o)
+
+        fortran_order_deps = self.get_target_filename(t) for t in obj_targets
+        fortran_inc_args: T.Liststr = 
+        if target.uses_fortran():
+            fortran_inc_args = mesonlib.listify(target.compilers'fortran'.get_include_args(
+                self.get_target_private_dir(t), is_system=False) for t in obj_targets)
+
         # Generate compilation targets for C sources generated from Vala
         # sources. This can be extended to other $LANG->C compilers later if
         # necessary. This needs to be separate for at least Vala
@@ -867,8 +945,7 @@
         # often contain duplicate symbols and will fail to compile properly
         vala_generated_source_files = 
         for src in transpiled_sources:
-            dirpart, fnamepart = os.path.split(src)
-            raw_src = File(True, dirpart, fnamepart)
+            raw_src = File.from_built_relative(src)
             # Generated targets are ordered deps because the must exist
             # before the sources compiling them are used. After the first
             # compile we get precise dependency info from dep files.
@@ -898,25 +975,30 @@
                                            src.rel_to_builddir(self.build_to_src))
                     unity_src.append(abs_src)
                 else:
-                    o, s = self.generate_single_compile(target, src, False, , header_deps + d_generated_deps)
+                    o, s = self.generate_single_compile(target, src, False, ,
+                                                        header_deps + d_generated_deps + fortran_order_deps,
+                                                        fortran_inc_args)
                     obj_list.append(o)
                     compiled_sources.append(s)
                     source2objects = o
 
-        obj_list += self.flatten_object_list(target)
         if is_unity:
             for src in self.generate_unity_files(target, unity_src):
-                o, s = self.generate_single_compile(target, src, True, unity_deps + header_deps + d_generated_deps)
+                o, s = self.generate_single_compile(target, src, True, unity_deps + header_deps + d_generated_deps,
+                                                    fortran_order_deps, fortran_inc_args)
                 obj_list.append(o)
                 compiled_sources.append(s)
                 source2objects = o
+        if isinstance(target, build.CompileTarget):
+            # Skip the link stage for this special type of target
+            return
         linker, stdlib_args = self.determine_linker_and_stdlib_args(target)
         if isinstance(target, build.StaticLibrary) and target.prelink:
             final_obj_list = self.generate_prelink(target, obj_list)
         else:
             final_obj_list = obj_list
         elem = self.generate_link(target, outname, final_obj_list, linker, pch_objects, stdlib_args=stdlib_args)
-        self.generate_dependency_scan_target(target, compiled_sources, source2object, generated_source_files)
+        self.generate_dependency_scan_target(target, compiled_sources, source2object, generated_source_files, fortran_order_deps)
         self.add_build(elem)
 
     def should_use_dyndeps_for_target(self, target: 'build.BuildTarget') -> bool:
@@ -941,7 +1023,8 @@
             return False
         return True
 
-    def generate_dependency_scan_target(self, target, compiled_sources, source2object, generated_source_files: T.Listmesonlib.File):
+    def generate_dependency_scan_target(self, target, compiled_sources, source2object, generated_source_files: T.Listmesonlib.File,
+                                        object_deps: T.Liststr) -> None:
         if not self.should_use_dyndeps_for_target(target):
             return
         depscan_file = self.get_dep_scan_file_for(target)
@@ -963,6 +1046,7 @@
         # that those sources are present
         for g in generated_source_files:
             elem.orderdeps.add(g.relative_name())
+        elem.orderdeps.update(object_deps)
         scaninfo = TargetDependencyScannerInfo(self.get_target_private_dir(target), source2object)
         with open(pickle_abs, 'wb') as p:
             pickle.dump(scaninfo, p)
@@ -1183,9 +1267,7 @@
             '--internal',
              'regenerate',
              self.environment.get_source_dir(),
-             self.environment.get_build_dir(),
-             '--backend',
-             'ninja'
+             self.environment.get_build_dir()
         self.add_rule(NinjaRule('REGENERATE_BUILD',
                                 c, ,
                                 'Regenerating build files.',
@@ -1204,6 +1286,7 @@
         self.ruledictrule.name = rule
 
     def add_build(self, build):
+        build.check_outputs()
         self.build_elements.append(build)
 
         if build.rulename != 'phony':
@@ -1249,8 +1332,7 @@
         generated_sources = self.get_target_generated_sources(target)
         gen_src_list = 
         for rel_src in generated_sources.keys():
-            dirpart, fnamepart = os.path.split(rel_src)
-            raw_src = File(True, dirpart, fnamepart)
+            raw_src = File.from_built_relative(rel_src)
             if rel_src.endswith('.java'):
                 gen_src_list.append(raw_src)
 
@@ -1351,7 +1433,7 @@
         commands += self.build.get_project_args(compiler, target.subproject, target.for_machine)
         commands += self.build.get_global_args(compiler, target.for_machine)
 
-        elem = NinjaBuildElement(self.all_outputs, outputs, self.get_compiler_rule_name('cs', target.for_machine), rel_srcs + generated_rel_srcs)
+        elem = NinjaBuildElement(self.all_outputs, outputs, self.compiler_to_rule_name(compiler), rel_srcs + generated_rel_srcs)
         elem.add_dep(deps)
         elem.add_item('ARGS', commands)
         self.add_build(elem)
@@ -1616,11 +1698,11 @@
 
         ext = target.get_option(OptionKey('language', machine=target.for_machine, lang='cython'))
 
+        pyx_sources =   # Keep track of sources we're adding to build
+
         for src in target.get_sources():
             if src.endswith('.pyx'):
                 output = os.path.join(self.get_target_private_dir(target), f'{src}.{ext}')
-                args = args.copy()
-                args += cython.get_output_args(output)
                 element = NinjaBuildElement(
                     self.all_outputs, output,
                     self.compiler_to_rule_name(cython),
@@ -1629,9 +1711,11 @@
                 self.add_build(element)
                 # TODO: introspection?
                 cython_sources.append(output)
+                pyx_sources.append(element)
             else:
                 static_sourcessrc.rel_to_builddir(self.build_to_src) = src
 
+        header_deps =   # Keep track of generated headers for those sources
         for gen in target.get_generated_sources():
             for ssrc in gen.get_outputs():
                 if isinstance(gen, GeneratedList):
@@ -1639,19 +1723,27 @@
                 else:
                     ssrc = os.path.join(gen.get_subdir(), ssrc)
                 if ssrc.endswith('.pyx'):
-                    args = args.copy()
                     output = os.path.join(self.get_target_private_dir(target), f'{ssrc}.{ext}')
-                    args += cython.get_output_args(output)
                     element = NinjaBuildElement(
                         self.all_outputs, output,
                         self.compiler_to_rule_name(cython),
                         ssrc)
                     element.add_item('ARGS', args)
                     self.add_build(element)
+                    pyx_sources.append(element)
                     # TODO: introspection?
                     cython_sources.append(output)
                 else:
                     generated_sourcesssrc = mesonlib.File.from_built_file(gen.get_subdir(), ssrc)
+                    # Following logic in L883-900 where we determine whether to add generated source
+                    # as a header(order-only) dep to the .so compilation rule
+                    if not self.environment.is_source(ssrc) and \
+                            not self.environment.is_object(ssrc) and \
+                            not self.environment.is_library(ssrc) and \
+                            not modules.is_module_library(ssrc):
+                        header_deps.append(ssrc)
+        for source in pyx_sources:
+            source.add_orderdep(header_deps)
 
         return static_sources, generated_sources, cython_sources
 
@@ -1685,6 +1777,34 @@
                             first_file = str(out)
         return orderdeps, first_file
 
+    def _add_rust_project_entry(self, name: str, main_rust_file: str, args: CompilerArgs,
+                                from_subproject: bool, is_proc_macro: bool,
+                                output: str, deps: T.ListRustDep) -> None:
+        raw_edition: T.Optionalstr = mesonlib.first(reversed(args), lambda x: x.startswith('--edition'))
+        edition: RUST_EDITIONS = '2015' if not raw_edition else raw_edition.split('=')-1
+
+        cfg: T.Liststr = 
+        arg_itr: T.Iteratorstr = iter(args)
+        for arg in arg_itr:
+            if arg == '--cfg':
+                cfg.append(next(arg_itr))
+            elif arg.startswith('--cfg'):
+                cfg.append(arglen('--cfg'):)
+
+        crate = RustCrate(
+            len(self.rust_crates),
+            name,
+            main_rust_file,
+            edition,
+            deps,
+            cfg,
+            is_workspace_member=not from_subproject,
+            is_proc_macro=is_proc_macro,
+            proc_macro_dylib_path=output if is_proc_macro else None,
+        )
+
+        self.rust_cratesname = crate
+
     def generate_rust_target(self, target: build.BuildTarget) -> None:
         rustc = target.compilers'rust'
         # Rust compiler takes only the main file as input and
@@ -1702,6 +1822,9 @@
             for t in itertools.chain(target.link_targets, target.link_whole_targets)
         
 
+        # Dependencies for rust-project.json
+        project_deps: T.ListRustDep = 
+
         orderdeps: T.Liststr = 
 
         main_rust_file = None
@@ -1769,21 +1892,24 @@
             args.extend(rustc.get_linker_always_args())
 
         args += self.generate_basic_compiler_args(target, rustc, False)
-        # This matches rustc's default behavior.
-        args += '--crate-name', target.name.replace('-', '_')
+        # Rustc replaces - with _. spaces are not allowed, so we replace them with underscores
+        args += '--crate-name', target.name.replace('-', '_').replace(' ', '_')
         depfile = os.path.join(target.subdir, target.name + '.d')
         args += '--emit', f'dep-info={depfile}', '--emit', 'link'
         args += target.get_extra_args('rust')
-        args += rustc.get_output_args(os.path.join(target.subdir, target.get_filename()))
+        output = rustc.get_output_args(os.path.join(target.subdir, target.get_filename()))
+        args += output
         linkdirs = mesonlib.OrderedSet()
         external_deps = target.external_deps.copy()
-        for d in itertools.chain(target.link_targets, target.link_whole_targets):
+        # TODO: we likely need to use verbatim to handle name_prefix and name_suffix
+        for d in target.link_targets:
             linkdirs.add(d.subdir)
             if d.uses_rust():
                 # specify `extern CRATE_NAME=OUTPUT_FILE` for each Rust
                 # dependency, so that collisions with libraries in rustc's
                 # sysroot don't cause ambiguity
                 args += '--extern', '{}={}'.format(d.name, os.path.join(d.subdir, d.filename))
+                project_deps.append(RustDep(d.name, self.rust_cratesd.name.order))
             elif d.typename == 'static library':
                 # Rustc doesn't follow Meson's convention that static libraries
                 # are called .a, and import libraries are .lib, so we have to
@@ -1797,6 +1923,55 @@
                 # Rust uses -l for non rust dependencies, but we still need to
                 # add dylib=foo
                 args += '-l', f'dylib={d.name}'
+
+        # Since 1.61.0 Rust has a special modifier for whole-archive linking,
+        # before that it would treat linking two static libraries as
+        # whole-archive linking. However, to make this work we have to disable
+        # bundling, which can't be done until 1.63.0… So for 1.61–1.62 we just
+        # have to hope that the default cases of +whole-archive are sufficent.
+        # See: https://github.com/rust-lang/rust/issues/99429
+        if mesonlib.version_compare(rustc.version, '>= 1.63.0'):
+            whole_archive = ':+whole-archive,-bundle'
+        else:
+            whole_archive = ''
+
+        if mesonlib.version_compare(rustc.version, '>= 1.67.0'):
+            verbatim = ',+verbatim'
+        else:
+            verbatim = ''
+
+        for d in target.link_whole_targets:
+            linkdirs.add(d.subdir)
+            if d.uses_rust():
+                # specify `extern CRATE_NAME=OUTPUT_FILE` for each Rust
+                # dependency, so that collisions with libraries in rustc's
+                # sysroot don't cause ambiguity
+                args += '--extern', '{}={}'.format(d.name, os.path.join(d.subdir, d.filename))
+                project_deps.append(RustDep(d.name, self.rust_cratesd.name.order))
+            else:
+                if rustc.linker.id in {'link', 'lld-link'}:
+                    if verbatim:
+                        # If we can use the verbatim modifier, then everything is great
+                        args += '-l', f'static{whole_archive}{verbatim}={d.get_outputs()0}'
+                    elif isinstance(target, build.StaticLibrary):
+                        # If we don't, for static libraries the only option is
+                        # to make a copy, since we can't pass objects in, or
+                        # directly affect the archiver. but we're not going to
+                        # do that given how quickly rustc versions go out of
+                        # support unless there's a compelling reason to do so.
+                        # This only affects 1.61–1.66
+                        mlog.warning('Due to limitations in Rustc versions 1.61–1.66 and meson library naming',
+                                     'whole-archive linking with MSVC may or may not work. Upgrade rustc to',
+                                     '>= 1.67. A best effort is being made, but likely won\'t work')
+                        args += '-l', f'static={d.name}'
+                    else:
+                        # When doing dynamic linking (binaries and cdylibs),
+                        # we can instead just proxy the correct arguments to the linker
+                        for link_whole_arg in rustc.linker.get_link_whole_for(self.get_target_filename_for_linking(d)):
+                            args += '-C', f'link-arg={link_whole_arg}'
+                else:
+                    args += '-l', f'static{whole_archive}={d.name}'
+                external_deps.extend(d.external_deps)
         for e in external_deps:
             for a in e.get_link_args():
                 if a.endswith(('.dll', '.so', '.dylib')):
@@ -1845,7 +2020,13 @@
             # installations
             for rpath_arg in rpath_args:
                 args += '-C', 'link-arg=' + rpath_arg + ':' + os.path.join(rustc.get_sysroot(), 'lib')
-        compiler_name = self.get_compiler_rule_name('rust', target.for_machine)
+
+        self._add_rust_project_entry(target.name, main_rust_file, args, bool(target.subproject),
+                                     #XXX: There is a fix for this pending
+                                     getattr(target, 'rust_crate_type', '') == 'procmacro',
+                                     output, project_deps)
+
+        compiler_name = self.compiler_to_rule_name(rustc)
         element = NinjaBuildElement(self.all_outputs, target_name, compiler_name, main_rust_file)
         if orderdeps:
             element.add_orderdep(orderdeps)
@@ -1864,20 +2045,16 @@
         return PerMachine('_FOR_BUILD', '')for_machine
 
     @classmethod
-    def get_compiler_rule_name(cls, lang: str, for_machine: MachineChoice) -> str:
-        return '{}_COMPILER{}'.format(lang, cls.get_rule_suffix(for_machine))
-
-    @classmethod
-    def get_pch_rule_name(cls, lang: str, for_machine: MachineChoice) -> str:
-        return '{}_PCH{}'.format(lang, cls.get_rule_suffix(for_machine))
+    def get_compiler_rule_name(cls, lang: str, for_machine: MachineChoice, mode: str = 'COMPILER') -> str:
+        return f'{lang}_{mode}{cls.get_rule_suffix(for_machine)}'
 
     @classmethod
     def compiler_to_rule_name(cls, compiler: Compiler) -> str:
-        return cls.get_compiler_rule_name(compiler.get_language(), compiler.for_machine)
+        return cls.get_compiler_rule_name(compiler.get_language(), compiler.for_machine, compiler.mode)
 
     @classmethod
     def compiler_to_pch_rule_name(cls, compiler: Compiler) -> str:
-        return cls.get_pch_rule_name(compiler.get_language(), compiler.for_machine)
+        return cls.get_compiler_rule_name(compiler.get_language(), compiler.for_machine, 'PCH')
 
     def swift_module_file_name(self, target):
         return os.path.join(self.get_target_private_dir(target),
@@ -1976,7 +2153,7 @@
             objects.append(oname)
             rel_objects.append(os.path.join(self.get_target_private_dir(target), oname))
 
-        rulename = self.get_compiler_rule_name('swift', target.for_machine)
+        rulename = self.compiler_to_rule_name(swiftc)
 
         # Swiftc does not seem to be able to emit objects and module files in one go.
         elem = NinjaBuildElement(self.all_outputs, rel_objects, rulename, abssrc)
@@ -1985,9 +2162,7 @@
         elem.add_item('ARGS', compile_args + header_imports + abs_generated + module_includes)
         elem.add_item('RUNDIR', rundir)
         self.add_build(elem)
-        elem = NinjaBuildElement(self.all_outputs, out_module_name,
-                                 self.get_compiler_rule_name('swift', target.for_machine),
-                                 abssrc)
+        elem = NinjaBuildElement(self.all_outputs, out_module_name, rulename, abssrc)
         elem.add_dep(in_module_files + rel_generated)
         elem.add_item('ARGS', compile_args + abs_generated + module_includes + swiftc.get_mod_gen_args())
         elem.add_item('RUNDIR', rundir)
@@ -2014,7 +2189,7 @@
         rsp_file_syntax() is only guaranteed to be implemented if
         can_linker_accept_rsp() returns True.
         """
-        options = dict(rspable=tool.can_linker_accept_rsp())
+        options = {'rspable': tool.can_linker_accept_rsp()}
         if options'rspable':
             options'rspfile_quote_style' = tool.rsp_file_syntax()
         return options
@@ -2106,9 +2281,18 @@
 
     def generate_cython_compile_rules(self, compiler: 'Compiler') -> None:
         rule = self.compiler_to_rule_name(compiler)
-        command = compiler.get_exelist() + '$ARGS', '$in'
         description = 'Compiling Cython source $in'
-        self.add_rule(NinjaRule(rule, command, , description, extra='restat = 1'))
+        command = compiler.get_exelist()
+
+        depargs = compiler.get_dependency_gen_args('$out', '$DEPFILE')
+        depfile = '$out.dep' if depargs else None
+
+        args = depargs + '$ARGS', '$in'
+        args += NinjaCommandArg.list(compiler.get_output_args('$out'), Quoting.none)
+        self.add_rule(NinjaRule(rule, command + args, ,
+                                description,
+                                depfile=depfile,
+                                extra='restat = 1'))
 
     def generate_rust_compile_rules(self, compiler):
         rule = self.compiler_to_rule_name(compiler)
@@ -2187,12 +2371,12 @@
         crstr = self.get_rule_suffix(compiler.for_machine)
         if langname == 'fortran':
             self.generate_fortran_dep_hack(crstr)
-        rule = self.get_compiler_rule_name(langname, compiler.for_machine)
+        rule = self.compiler_to_rule_name(compiler)
         depargs = NinjaCommandArg.list(compiler.get_dependency_gen_args('$out', '$DEPFILE'), Quoting.none)
         command = compiler.get_exelist()
         args = '$ARGS' + depargs + NinjaCommandArg.list(compiler.get_output_args('$out'), Quoting.none) + compiler.get_compile_only_args() + '$in'
         description = f'Compiling {compiler.get_display_language()} object $out'
-        if isinstance(compiler, VisualStudioLikeCompiler):
+        if compiler.get_argument_syntax() == 'msvc':
             deps = 'msvc'
             depfile = None
         else:
@@ -2203,18 +2387,18 @@
                                 deps=deps, depfile=depfile))
 
     def generate_pch_rule_for(self, langname, compiler):
-        if langname != 'c' and langname != 'cpp':
+        if langname not in {'c', 'cpp'}:
             return
         rule = self.compiler_to_pch_rule_name(compiler)
         depargs = compiler.get_dependency_gen_args('$out', '$DEPFILE')
 
-        if isinstance(compiler, VisualStudioLikeCompiler):
+        if compiler.get_argument_syntax() == 'msvc':
             output = 
         else:
             output = NinjaCommandArg.list(compiler.get_output_args('$out'), Quoting.none)
         command = compiler.get_exelist() + '$ARGS' + depargs + output + compiler.get_compile_only_args() + '$in'
         description = 'Precompiling header $in'
-        if isinstance(compiler, VisualStudioLikeCompiler):
+        if compiler.get_argument_syntax() == 'msvc':
             deps = 'msvc'
             depfile = None
         else:
@@ -2243,6 +2427,8 @@
                     self.generate_llvm_ir_compile_rule(compiler)
                 self.generate_compile_rule_for(langname, compiler)
                 self.generate_pch_rule_for(langname, compiler)
+                for mode in compiler.get_modes():
+                    self.generate_compile_rule_for(langname, mode)
 
     def generate_generator_list_rules(self, target):
         # CustomTargets have already written their rules and
@@ -2271,7 +2457,6 @@
         generator = genlist.get_generator()
         subdir = genlist.subdir
         exe = generator.get_exe()
-        exe_arr = self.build_target_to_cmd_array(exe)
         infilelist = genlist.get_inputs()
         outfilelist = genlist.get_outputs()
         extra_dependencies = self.get_custom_target_depend_files(genlist)
@@ -2299,8 +2484,8 @@
             if len(generator.outputs) > 1:
                 outfilelist = outfilelistlen(generator.outputs):
             args = self.replace_paths(target, args, override_subdir=subdir)
-            cmdlist = exe_arr + self.replace_extra_args(args, genlist)
-            cmdlist, reason = self.as_meson_exe_cmdline(cmdlist0, cmdlist1:,
+            cmdlist, reason = self.as_meson_exe_cmdline(exe,
+                                                        self.replace_extra_args(args, genlist),
                                                         capture=outfiles0 if generator.capture else None)
             abs_pdir = os.path.join(self.environment.get_build_dir(), self.get_target_dir(target))
             os.makedirs(abs_pdir, exist_ok=True)
@@ -2539,7 +2724,7 @@
                                              is_generated: bool = False) -> 'ImmutableListProtocolstr':
         # The code generated by valac is usually crap and has tons of unused
         # variables and such, so disable warnings for Vala C sources.
-        no_warn_args = (is_generated == 'vala')
+        no_warn_args = is_generated == 'vala'
         # Add compiler args and include paths from several sources; defaults,
         # build options, external dependencies, etc.
         commands = self.generate_basic_compiler_args(target, compiler, no_warn_args)
@@ -2594,7 +2779,10 @@
         commands += compiler.get_include_args(self.get_target_private_dir(target), False)
         return commands
 
-    def generate_single_compile(self, target, src, is_generated=False, header_deps=None, order_deps=None):
+    def generate_single_compile(self, target: build.BuildTarget, src,
+                                is_generated=False, header_deps=None,
+                                order_deps: T.OptionalT.Liststr = None,
+                                extra_args: T.OptionalT.Liststr = None) -> None:
         """
         Compiles C/C++, ObjC/ObjC++, Fortran, and D sources
         """
@@ -2681,6 +2869,8 @@
                                                     rel_obj)
                         self.add_build(depelem)
             commands += compiler.get_module_outdir_args(self.get_target_private_dir(target))
+        if extra_args is not None:
+            commands.extend(extra_args)
 
         element = NinjaBuildElement(self.all_outputs, rel_obj, compiler_name, rel_src)
         self.add_header_deps(target, element, header_deps)
@@ -2695,7 +2885,8 @@
         element.add_dep(pch_dep)
         for i in self.get_fortran_orderdeps(target, compiler):
             element.add_orderdep(i)
-        element.add_item('DEPFILE', dep_file)
+        if dep_file:
+            element.add_item('DEPFILE', dep_file)
         element.add_item('ARGS', commands)
 
         self.add_dependency_scanner_entries_to_element(target, compiler, element, src)
@@ -2793,8 +2984,8 @@
                 msg = f'Precompiled header of {target.get_basename()!r} must not be in the same ' \
                       'directory as source, please put it in a subdirectory.'
                 raise InvalidArguments(msg)
-            compiler = target.compilerslang
-            if isinstance(compiler, VisualStudioLikeCompiler):
+            compiler: Compiler = target.compilerslang
+            if compiler.get_argument_syntax() == 'msvc':
                 (commands, dep, dst, objs, src) = self.generate_msvc_pch_command(target, compiler, pch)
                 extradep = os.path.join(self.build_to_src, target.get_source_subdir(), pch0)
             elif compiler.id == 'intel':
@@ -2888,7 +3079,7 @@
 
     def get_link_whole_args(self, linker, target):
         use_custom = False
-        if isinstance(linker, mixins.visualstudio.MSVCCompiler):
+        if linker.id == 'msvc':
             # Expand our object lists manually if we are on pre-Visual Studio 2015 Update 2
             # (incidentally, the "linker" here actually refers to cl.exe)
             if mesonlib.version_compare(linker.version, '<19.00.23918'):
@@ -2899,7 +3090,7 @@
             for dep in target.link_whole_targets:
                 l = dep.extract_all_objects(False)
                 objects_from_static_libs += self.determine_ext_objs(l, '')
-                objects_from_static_libs.extend(self.flatten_object_list(dep))
+                objects_from_static_libs.extend(self.flatten_object_list(dep)0)
 
             return objects_from_static_libs
         else:
@@ -2908,6 +3099,7 @@
 
     @lru_cache(maxsize=None)
     def guess_library_absolute_path(self, linker, libname, search_dirs, patterns) -> Path:
+        from ..compilers.c import CCompiler
         for d in search_dirs:
             for p in patterns:
                 trial = CCompiler._get_trials_from_pattern(p, d, libname)
@@ -3029,7 +3221,8 @@
         else:
             commands += compilers.get_base_link_args(target.get_options(),
                                                      linker,
-                                                     isinstance(target, build.SharedModule))
+                                                     isinstance(target, build.SharedModule),
+                                                     self.environment.get_build_dir())
         # Add -nostdlib if needed; can't be overridden
         commands += self.get_no_stdlib_link_args(target, linker)
         # Add things like /NOLOGO; usually can't be overridden
@@ -3210,7 +3403,7 @@
     def generate_scanbuild(self):
         if not environment.detect_scanbuild():
             return
-        if ('', 'scan-build') in self.build.run_target_names:
+        if 'scan-build' in self.all_outputs:
             return
         cmd = self.environment.get_build_command() + \
             '--internal', 'scanbuild', self.environment.source_dir, self.environment.build_dir + \
@@ -3231,8 +3424,6 @@
             return
         if target_name in self.all_outputs:
             return
-        if ('', target_name) in self.build.run_target_names:
-            return
         cmd = self.environment.get_build_command() + \
             '--internal', 'clang' + name, self.environment.source_dir, self.environment.build_dir + \
             extra_args
@@ -3257,8 +3448,6 @@
         import shutil
         if not shutil.which(tool):
             return
-        if ('', target_name) in self.build.run_target_names:
-            return
         if target_name in self.all_outputs:
             return
         cmd = self.environment.get_build_command() + \
@@ -3414,13 +3603,13 @@
                 submodmatch = submodre.match(line)
                 if submodmatch is not None:
                     parents = submodmatch.group(1).lower().split(':')
-                    assert len(parents) in (1, 2), (
+                    assert len(parents) in {1, 2}, (
                         'submodule ancestry must be specified as'
                         f' ancestor:parent but Meson found {parents}')
 
                     ancestor_child = '_'.join(parents)
                     if ancestor_child not in tdeps:
-                        raise MesonException("submodule {} relies on ancestor module {} that was not found.".format(submodmatch.group(2).lower(), ancestor_child.split('_')0))
+                        raise MesonException("submodule {} relies on ancestor module {} that was not found.".format(submodmatch.group(2).lower(), ancestor_child.split('_', maxsplit=1)0))
                     submodsrcfile = srcdir / tdepsancestor_child.fname  # type: Path
                     if not submodsrcfile.is_file():
                         if submodsrcfile.name != src.name:  # generated source file

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/backend/vs2010backend.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/backend/vs2010backend.py Changed

@@ -21,6 +21,7 @@
 import uuid
 import typing as T
 from pathlib import Path, PurePath
+import re
 
 from . import backends
 from .. import build
@@ -96,6 +97,8 @@
 def generate_guid_from_path(path, path_type):
     return str(uuid.uuid5(uuid.NAMESPACE_URL, 'meson-vs-' + path_type + ':' + str(path))).upper()
 
+def detect_microsoft_gdk(platform: str) -> bool:
+    return re.match(r'Gaming\.(Desktop|Xbox.XboxOne|Xbox.Scarlett)\.x64', platform, re.IGNORECASE)
 
 class Vs2010Backend(backends.Backend):
     def __init__(self, build: T.Optionalbuild.Build, interpreter: T.OptionalInterpreter):
@@ -134,7 +137,6 @@
                 infilelist = genlist.get_inputs()
                 outfilelist = genlist.get_outputs()
                 source_dir = os.path.join(down, self.build_to_src, genlist.subdir)
-                exe_arr = self.build_target_to_cmd_array(exe)
                 idgroup = ET.SubElement(parent_node, 'ItemGroup')
                 for i, curfile in enumerate(infilelist):
                     if len(infilelist) == len(outfilelist):
@@ -158,13 +160,12 @@
                              .replace("@BUILD_ROOT@", self.environment.get_build_dir())
                             for x in args
                     args = x.replace('\\', '/') for x in args
-                    cmd = exe_arr + self.replace_extra_args(args, genlist)
                     # Always use a wrapper because MSBuild eats random characters when
                     # there are many arguments.
                     tdir_abs = os.path.join(self.environment.get_build_dir(), self.get_target_dir(target))
                     cmd, _ = self.as_meson_exe_cmdline(
-                        cmd0,
-                        cmd1:,
+                        exe,
+                        self.replace_extra_args(args, genlist),
                         workdir=tdir_abs,
                         capture=outfiles0 if generator.capture else None,
                         force_serialize=True
@@ -180,13 +181,17 @@
 
     def generate(self):
         target_machine = self.interpreter.builtin'target_machine'.cpu_family_method(None, None)
-        if target_machine == '64' or target_machine == 'x86_64':
+        if target_machine in {'64', 'x86_64'}:
             # amd64 or x86_64
-            self.platform = 'x64'
+            target_system = self.interpreter.builtin'target_machine'.system_method(None, None)
+            if detect_microsoft_gdk(target_system):
+                self.platform = target_system
+            else:
+                self.platform = 'x64'
         elif target_machine == 'x86':
             # x86
             self.platform = 'Win32'
-        elif target_machine == 'aarch64' or target_machine == 'arm64':
+        elif target_machine in {'aarch64', 'arm64'}:
             target_cpu = self.interpreter.builtin'target_machine'.cpu_method(None, None)
             if target_cpu == 'arm64ec':
                 self.platform = 'arm64ec'
@@ -198,13 +203,13 @@
             raise MesonException('Unsupported Visual Studio platform: ' + target_machine)
 
         build_machine = self.interpreter.builtin'build_machine'.cpu_family_method(None, None)
-        if build_machine == '64' or build_machine == 'x86_64':
+        if build_machine in {'64', 'x86_64'}:
             # amd64 or x86_64
             self.build_platform = 'x64'
         elif build_machine == 'x86':
             # x86
             self.build_platform = 'Win32'
-        elif build_machine == 'aarch64' or build_machine == 'arm64':
+        elif build_machine in {'aarch64', 'arm64'}:
             target_cpu = self.interpreter.builtin'build_machine'.cpu_method(None, None)
             if target_cpu == 'arm64ec':
                 self.build_platform = 'arm64ec'
@@ -676,6 +681,23 @@
         self.add_target_deps(root, target)
         self._prettyprint_vcxproj_xml(ET.ElementTree(root), ofname)
 
+    def gen_compile_target_vcxproj(self, target, ofname, guid):
+        if target.for_machine is MachineChoice.BUILD:
+            platform = self.build_platform
+        else:
+            platform = self.platform
+        (root, type_config) = self.create_basic_project(target.name,
+                                                        temp_dir=target.get_id(),
+                                                        guid=guid,
+                                                        target_platform=platform)
+        ET.SubElement(root, 'Import', Project=r'$(VCTargetsPath)\Microsoft.Cpp.targets')
+        target.generated = self.compile_target_to_generator(target)
+        target.sources = 
+        self.generate_custom_generator_commands(target, root)
+        self.add_regen_dependency(root)
+        self.add_target_deps(root, target)
+        self._prettyprint_vcxproj_xml(ET.ElementTree(root), ofname)
+
     @classmethod
     def lang_from_source_file(cls, src):
         ext = src.split('.')-1
@@ -828,13 +850,13 @@
 
     def _get_cl_compiler(self, target):
         for lang, c in target.compilers.items():
-            if lang in ('c', 'cpp'):
+            if lang in {'c', 'cpp'}:
                 return c
         # No source files, only objects, but we still need a compiler, so
         # return a found compiler
         if len(target.objects) > 0:
             for lang, c in self.environment.coredata.compilerstarget.for_machine.items():
-                if lang in ('c', 'cpp'):
+                if lang in {'c', 'cpp'}:
                     return c
         raise MesonException('Could not find a C or C++ compiler. MSVC can only build C/C++ projects.')
 
@@ -869,6 +891,8 @@
             return self.gen_custom_target_vcxproj(target, ofname, guid)
         elif isinstance(target, build.RunTarget):
             return self.gen_run_target_vcxproj(target, ofname, guid)
+        elif isinstance(target, build.CompileTarget):
+            return self.gen_compile_target_vcxproj(target, ofname, guid)
         else:
             raise MesonException(f'Unknown target type for {target.get_basename()}')
         # Prefix to use to access the build root from the vcxproj dir
@@ -1003,7 +1027,7 @@
                 file_argsl += compilers.get_base_compile_args(
                     target.get_options(), comp)
                 file_argsl += comp.get_option_compile_args(
-                    self.environment.coredata.options)
+                    target.get_options())
 
         # Add compile args added using add_project_arguments()
         for l, args in self.build.projects_argstarget.for_machine.get(target.subproject, {}).items():
@@ -1043,8 +1067,12 @@
                 # reversed is used to keep order of includes
                 for i in reversed(d.get_incdirs()):
                     curdir = os.path.join(d.get_curdir(), i)
-                    args.append('-I' + self.relpath(curdir, target.subdir))  # build dir
-                    args.append('-I' + os.path.join(proj_to_src_root, curdir))  # src dir
+                    try:
+                        args.append('-I' + self.relpath(curdir, target.subdir)) # build dir
+                        args.append('-I' + os.path.join(proj_to_src_root, curdir))  # src dir
+                    except ValueError:
+                        # Include is on different drive
+                        args.append('-I' + os.path.normpath(curdir))
                 for i in d.get_extra_build_dirs():
                     curdir = os.path.join(d.get_curdir(), i)
                     args.append('-I' + self.relpath(curdir, target.subdir))  # build dir
@@ -1148,7 +1176,8 @@
         # Size-preserving flags
         if '/Os' in o_flags:
             ET.SubElement(clconf, 'FavorSizeOrSpeed').text = 'Size'
-        else:
+        # Note: setting FavorSizeOrSpeed with clang-cl conflicts with /Od and can make debugging difficult, so don't.
+        elif '/Od' not in o_flags:
             ET.SubElement(clconf, 'FavorSizeOrSpeed').text = 'Speed'
         # Note: SuppressStartupBanner is /NOLOGO and is 'true' by default
         self.generate_lang_standard_info(file_args, clconf)
@@ -1242,14 +1271,14 @@
                     # Unfortunately, we can't use self.object_filename_from_source()
                     for gen in l.genlist:
                         for src in gen.get_outputs():
-                            if self.environment.is_source(src) and not self.environment.is_header(src):
+                            if self.environment.is_source(src):
                                 path = self.get_target_generated_dir(t, gen, src)
                                 gen_src_ext = '.' + os.path.splitext(path)11:
                                 extra_link_args.append(path:-len(gen_src_ext) + '.obj')
 
                     for src in l.srclist:
                         obj_basename = None
-                        if self.environment.is_source(src) and not self.environment.is_header(src):
+                        if self.environment.is_source(src):
                             obj_basename = self.object_filename_from_source(t, src)
                             target_private_dir = self.relpath(self.get_target_private_dir(t),
                                                               self.get_target_dir(t))
@@ -1279,7 +1308,7 @@
         for lib in self.get_custom_target_provided_libraries(target):
             additional_links.append(self.relpath(lib, self.get_target_dir(target)))
         additional_objects = 
-        for o in self.flatten_object_list(target, down):
+        for o in self.flatten_object_list(target, down)0:
             assert isinstance(o, str)
             additional_objects.append(o)
         for o in custom_objs:
@@ -1298,7 +1327,7 @@
         ofile.text = f'$(OutDir){target.get_filename()}'
         subsys = ET.SubElement(link, 'SubSystem')
         subsys.text = subsystem
-        if (isinstance(target, build.SharedLibrary) or isinstance(target, build.Executable)) and target.get_import_filename():
+        if isinstance(target, (build.SharedLibrary, build.Executable)) and target.get_import_filename():
             # DLLs built with MSVC always have an import library except when
             # they're data-only DLLs, but we don't support those yet.
             ET.SubElement(link, 'ImportLibrary').text = target.get_import_filename()
@@ -1317,7 +1346,7 @@
             targetplatform = self.platform.lower()
         if targetplatform == 'win32':
             targetmachine.text = 'MachineX86'
-        elif targetplatform == 'x64':
+        elif targetplatform == 'x64' or detect_microsoft_gdk(targetplatform):
             targetmachine.text = 'MachineX64'
         elif targetplatform == 'arm':
             targetmachine.text = 'MachineARM'
@@ -1360,9 +1389,8 @@
                 relpath = os.path.join(down, h.rel_to_builddir(self.build_to_src))
                 if path_normalize_add(relpath, previous_includes):
                     ET.SubElement(inc_hdrs, 'CLInclude', Include=relpath)
-            for lang in pch_sources:
-                h = pch_sourceslang0
-                path = os.path.join(proj_to_src_dir, h)
+            for headers in pch_sources.values():
+                path = os.path.join(proj_to_src_dir, headers0)
                 if path_normalize_add(path, previous_includes):
                     ET.SubElement(inc_hdrs, 'CLInclude', Include=path)
 
@@ -1391,8 +1419,8 @@
                     s = File.from_built_file(target.get_subdir(), s)
                     ET.SubElement(inc_cl, 'ObjectFileName').text = "$(IntDir)" + \
                         self.object_filename_from_source(target, s)
-            for lang in pch_sources:
-                impl = pch_sourceslang1
+            for lang, headers in pch_sources.items():
+                impl = headers1
                 if impl and path_normalize_add(impl, previous_sources):
                     inc_cl = ET.SubElement(inc_src, 'CLCompile', Include=impl)
                     self.create_pch(pch_sources, lang, inc_cl)
@@ -1510,15 +1538,15 @@
             message.text = msg
         if not verify_files:
             ET.SubElement(custombuild, 'VerifyInputsAndOutputsExist').text = 'false'
-        ET.SubElement(custombuild, 'Command').text = f'''setlocal
-{command}
-if %%errorlevel%% neq 0 goto :cmEnd
-:cmEnd
-endlocal & call :cmErrorLevel %%errorlevel%% & goto :cmDone
-:cmErrorLevel
-exit /b %%1
-:cmDone
-if %%errorlevel%% neq 0 goto :VCEnd'''
+
+        # If a command ever were to change the current directory or set local
+        # variables this would need to be more complicated, as msbuild by
+        # default executes all CustomBuilds in a project using the same
+        # shell. Right now such tasks are all done inside the meson_exe
+        # wrapper. The trailing newline appears to be necessary to allow
+        # parallel custom builds to work.
+        ET.SubElement(custombuild, 'Command').text = f"{command}\n"
+
         if not outputs:
             # Use a nonexistent file to always consider the target out-of-date.
             outputs = self.nonexistent_file(os.path.join(self.environment.get_scratch_dir(),

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/backend/xcodebackend.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/backend/xcodebackend.py Changed

@@ -52,7 +52,8 @@
                'objcpp': 'OBJCPLUSPLUS',
                'swift': 'SWIFT_'
                }
-OPT2XCODEOPT = {'0': '0',
+OPT2XCODEOPT = {'plain': None,
+                '0': '0',
                 'g': '0',
                 '1': '1',
                 '2': '2',
@@ -540,7 +541,7 @@
         self.custom_aggregate_targets = {}
         self.build_all_tdep_id = self.gen_id()
         # FIXME: filter out targets that are not built by default.
-        target_dependencies = list(map(lambda t: self.pbx_dep_mapt, self.build_targets))
+        target_dependencies = self.pbx_dep_mapt for t in self.build_targets
         custom_target_dependencies = self.pbx_custom_dep_mapt for t in self.custom_targets
         aggregated_targets = 
         aggregated_targets.append((self.all_id, 'ALL_BUILD',
@@ -1218,6 +1219,8 @@
                     generator_id += 1
 
     def generate_single_generator_phase(self, tname, t, genlist, generator_id, objects_dict):
+        # TODO: this should be rewritten to use the meson wrapper, like the other generators do
+        # Currently it doesn't handle a host binary that requires an exe wrapper correctly.
         generator = genlist.get_generator()
         exe = generator.get_exe()
         exe_arr = self.build_target_to_cmd_array(exe)
@@ -1561,7 +1564,9 @@
                 settings_dict.add_item('EXECUTABLE_SUFFIX', suffix)
             settings_dict.add_item('GCC_GENERATE_DEBUGGING_SYMBOLS', BOOL2XCODEBOOLtarget.get_option(OptionKey('debug')))
             settings_dict.add_item('GCC_INLINES_ARE_PRIVATE_EXTERN', 'NO')
-            settings_dict.add_item('GCC_OPTIMIZATION_LEVEL', OPT2XCODEOPTtarget.get_option(OptionKey('optimization')))
+            opt_flag = OPT2XCODEOPTtarget.get_option(OptionKey('optimization'))
+            if opt_flag is not None:
+                settings_dict.add_item('GCC_OPTIMIZATION_LEVEL', opt_flag)
             if target.has_pch:
                 # Xcode uses GCC_PREFIX_HEADER which only allows one file per target/executable. Precompiling various header files and
                 # applying a particular pch to each source file will require custom scripts (as a build phase) and build flags per each

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/build.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/build.py Changed

@@ -36,24 +36,26 @@
     extract_as_list, typeslistify, stringlistify, classify_unity_sources,
     get_filenames_templates_dict, substitute_values, has_path_sep,
     OptionKey, PerMachineDefaultable, OptionOverrideProxy,
-    MesonBugException
+    MesonBugException, EnvironmentVariables, pickle_load,
 )
 from .compilers import (
-    Compiler, is_object, clink_langs, sort_clink, all_languages,
+    is_object, clink_langs, sort_clink, all_languages,
     is_known_suffix, detect_static_linker
 )
-from .linkers import StaticLinker
 from .interpreterbase import FeatureNew, FeatureDeprecated
 
 if T.TYPE_CHECKING:
     from typing_extensions import Literal
     from ._typing import ImmutableListProtocol
     from .backend.backends import Backend, ExecutableSerialisation
+    from .compilers import Compiler
     from .interpreter.interpreter import Test, SourceOutputs, Interpreter
     from .interpreterbase import SubProject
+    from .linkers import StaticLinker
     from .mesonlib import FileMode, FileOrString
     from .modules import ModuleState
     from .mparser import BaseNode
+    from .wrap import WrapMode
 
     GeneratedTypes = T.Union'CustomTarget', 'CustomTargetIndex', 'GeneratedList'
     LibTypes = T.Union'SharedLibrary', 'StaticLibrary', 'CustomTarget', 'CustomTargetIndex'
@@ -115,15 +117,15 @@
 known_stlib_kwargs = known_build_target_kwargs | {'pic', 'prelink'}
 known_jar_kwargs = known_exe_kwargs | {'main_class', 'java_resources'}
 
-def _process_install_tag(install_tag: T.OptionalT.SequenceT.Optionalstr,
+def _process_install_tag(install_tag: T.OptionalT.ListT.Optionalstr,
                          num_outputs: int) -> T.ListT.Optionalstr:
     _install_tag: T.ListT.Optionalstr
     if not install_tag:
         _install_tag = None * num_outputs
     elif len(install_tag) == 1:
-        _install_tag = list(install_tag) * num_outputs
+        _install_tag = install_tag * num_outputs
     else:
-        _install_tag = list(install_tag)
+        _install_tag = install_tag
     return _install_tag
 
 
@@ -202,6 +204,7 @@
     source_subdir: str
     installable_subdir: str
     install_dir: str
+    install_dir_name: str
     install_mode: 'FileMode'
     exclude: T.TupleT.Setstr, T.Setstr
     strip_directory: bool
@@ -233,7 +236,6 @@
         self.environment = environment
         self.projects = {}
         self.targets: 'T.OrderedDictstr, T.UnionCustomTarget, BuildTarget' = OrderedDict()
-        self.run_target_names: T.SetT.Tuplestr, str = set()
         self.global_args: PerMachineT.Dictstr, T.Liststr = PerMachine({}, {})
         self.global_link_args: PerMachineT.Dictstr, T.Liststr = PerMachine({}, {})
         self.projects_args: PerMachineT.Dictstr, T.Dictstr, T.Liststr = PerMachine({}, {})
@@ -385,7 +387,7 @@
         """Convert IncludeDirs object to a list of strings.
 
         :param sourcedir: The absolute source directory
-        :param builddir: The absolute build directory, option, buid dir will not
+        :param builddir: The absolute build directory, option, build dir will not
             be added if this is unset
         :returns: A list of strings (without compiler argument)
         """
@@ -427,7 +429,7 @@
                 sources.append(s)
 
         # Filter out headers and all non-source files
-        return s for s in sources if environment.is_source(s) and not environment.is_header(s)
+        return s for s in sources if environment.is_source(s)
 
     def classify_all_sources(self, sources: T.ListFileOrString, generated_sources: T.Sequence'GeneratedTypes') -> T.Dict'Compiler', T.List'FileOrString':
         sources_ = self.get_sources(sources, generated_sources)
@@ -499,71 +501,6 @@
         return False
 
 
-EnvInitValueType = T.Dictstr, T.Unionstr, T.Liststr
-
-
-class EnvironmentVariables(HoldableObject):
-    def __init__(self, values: T.OptionalEnvInitValueType = None,
-                 init_method: Literal'set', 'prepend', 'append' = 'set', separator: str = os.pathsep) -> None:
-        self.envvars: T.ListT.TupleT.CallableT.Dictstr, str, str, T.Liststr, str, str, str, T.Liststr, str = 
-        # The set of all env vars we have operations for. Only used for self.has_name()
-        self.varnames: T.Setstr = set()
-
-        if values:
-            init_func = getattr(self, init_method)
-            for name, value in values.items():
-                init_func(name, listify(value), separator)
-
-    def __repr__(self) -> str:
-        repr_str = "<{0}: {1}>"
-        return repr_str.format(self.__class__.__name__, self.envvars)
-
-    def hash(self, hasher: T.Any):
-        myenv = self.get_env({})
-        for key in sorted(myenv.keys()):
-            hasher.update(bytes(key, encoding='utf-8'))
-            hasher.update(b',')
-            hasher.update(bytes(myenvkey, encoding='utf-8'))
-            hasher.update(b';')
-
-    def has_name(self, name: str) -> bool:
-        return name in self.varnames
-
-    def get_names(self) -> T.Setstr:
-        return self.varnames
-
-    def set(self, name: str, values: T.Liststr, separator: str = os.pathsep) -> None:
-        self.varnames.add(name)
-        self.envvars.append((self._set, name, values, separator))
-
-    def append(self, name: str, values: T.Liststr, separator: str = os.pathsep) -> None:
-        self.varnames.add(name)
-        self.envvars.append((self._append, name, values, separator))
-
-    def prepend(self, name: str, values: T.Liststr, separator: str = os.pathsep) -> None:
-        self.varnames.add(name)
-        self.envvars.append((self._prepend, name, values, separator))
-
-    @staticmethod
-    def _set(env: T.Dictstr, str, name: str, values: T.Liststr, separator: str) -> str:
-        return separator.join(values)
-
-    @staticmethod
-    def _append(env: T.Dictstr, str, name: str, values: T.Liststr, separator: str) -> str:
-        curr = env.get(name)
-        return separator.join(values if curr is None else curr + values)
-
-    @staticmethod
-    def _prepend(env: T.Dictstr, str, name: str, values: T.Liststr, separator: str) -> str:
-        curr = env.get(name)
-        return separator.join(values if curr is None else values + curr)
-
-    def get_env(self, full_env: T.MutableMappingstr, str) -> T.Dictstr, str:
-        env = full_env.copy()
-        for method, name, values, separator in self.envvars:
-            envname = method(env, name, values, separator)
-        return env
-
 @dataclass(eq=False)
 class Target(HoldableObject):
 
@@ -627,7 +564,7 @@
             # False (which means we want this specific output out of many
             # outputs to not be installed).
             custom_install_dir = True
-            default_install_dir_name = None
+            install_dir_names = getattr(i, 'optname', None) for i in outdirs
         else:
             custom_install_dir = False
             # if outdirs is empty we need to set to something, otherwise we set
@@ -636,8 +573,9 @@
                 outdirs0 = default_install_dir
             else:
                 outdirs = default_install_dir
+            install_dir_names = default_install_dir_name * len(outdirs)
 
-        return outdirs, default_install_dir_name, custom_install_dir
+        return outdirs, install_dir_names, custom_install_dir
 
     def get_basename(self) -> str:
         return self.name
@@ -783,8 +721,10 @@
         self.process_objectlist(objects)
         self.process_kwargs(kwargs)
         self.check_unknown_kwargs(kwargs)
-        if not any(self.sources, self.generated, self.objects, self.link_whole, self.structured_sources):
-            raise InvalidArguments(f'Build target {name} has no sources.')
+        if not any(self.sources, self.generated, self.objects, self.link_whole_targets, self.structured_sources):
+            mlog.warning(f'Build target {name} has no sources. '
+                         'This was never supposed to be allowed but did because of a bug, '
+                         'support will be removed in a future release of Meson')
         self.validate_install()
         self.check_module_linking()
 
@@ -887,7 +827,7 @@
         # the languages of those libraries as well.
         if self.link_targets or self.link_whole_targets:
             for t in itertools.chain(self.link_targets, self.link_whole_targets):
-                if isinstance(t, CustomTarget) or isinstance(t, CustomTargetIndex):
+                if isinstance(t, (CustomTarget, CustomTargetIndex)):
                     continue # We can't know anything about these.
                 for name, compiler in t.compilers.items():
                     if name in link_langs and name not in self.compilers:
@@ -996,7 +936,7 @@
         return missing_languages
 
     def validate_sources(self):
-        if len(self.compilers) > 1 and any(lang in self.compilers for lang in {'cs', 'java'}):
+        if len(self.compilers) > 1 and any(lang in self.compilers for lang in 'cs', 'java'):
             langs = ', '.join(self.compilers.keys())
             raise InvalidArguments(f'Cannot mix those languages into a target: {langs}')
 
@@ -1133,7 +1073,7 @@
         self.add_pch('c', extract_as_list(kwargs, 'c_pch'))
         self.add_pch('cpp', extract_as_list(kwargs, 'cpp_pch'))
 
-        if not isinstance(self, Executable) or 'export_dynamic' in kwargs:
+        if not isinstance(self, Executable) or kwargs.get('export_dynamic', False):
             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)
@@ -1412,9 +1352,17 @@
                         mlog.warning(f'Try to link an installed static library target {self.name} with a'
                                      'custom target that is not installed, this might cause problems'
                                      'when you try to use this static library')
-                elif t.is_internal():
+                elif t.is_internal() and not t.uses_rust():
                     # When we're a static library and we link_with to an
                     # internal/convenience library, promote to link_whole.
+                    #
+                    # There are cases we cannot do this, however. In Rust, for
+                    # example, this can't be done with Rust ABI libraries, though
+                    # it could be done with C ABI libraries, though there are
+                    # several meson issues that need to be fixed:
+                    # https://github.com/mesonbuild/meson/issues/10722
+                    # https://github.com/mesonbuild/meson/issues/10723
+                    # https://github.com/mesonbuild/meson/issues/10724
                     return self.link_whole(t)
             if not isinstance(t, (Target, CustomTargetIndex)):
                 raise InvalidArguments(f'{t!r} is not a target.')
@@ -1617,11 +1565,23 @@
                 # Pretty hard to fix because the return value is passed everywhere
                 return linker, stdlib_args
 
+        # None of our compilers can do clink, this happens for example if the
+        # target only has ASM sources. Pick the first capable compiler.
+        for l in clink_langs:
+            try:
+                comp = self.all_compilersl
+                return comp, comp.language_stdlib_only_link_flags(self.environment)
+            except KeyError:
+                pass
+
         raise AssertionError(f'Could not get a dynamic linker for build target {self.name!r}')
 
     def uses_rust(self) -> bool:
         return 'rust' in self.compilers
 
+    def uses_fortran(self) -> bool:
+        return 'fortran' in self.compilers
+
     def get_using_msvc(self) -> bool:
         '''
         Check if the dynamic linker is MSVC. Used by Executable, StaticLibrary,
@@ -1823,7 +1783,7 @@
     typename = 'executable'
 
     def __init__(self, name: str, subdir: str, subproject: str, for_machine: MachineChoice,
-                 sources: T.ListFile, structured_sources: T.Optional'StructuredSources',
+                 sources: T.ListSourceOutputs, structured_sources: T.Optional'StructuredSources',
                  objects, environment: environment.Environment, compilers: T.Dictstr, 'Compiler',
                  kwargs):
         key = OptionKey('b_pie')
@@ -1868,8 +1828,8 @@
                 self.suffix = 'abs'
             elif ('c' in self.compilers and self.compilers'c'.get_id().startswith('xc16')):
                 self.suffix = 'elf'
-            elif ('c' in self.compilers and self.compilers'c'.get_id() in ('ti', 'c2000') or
-                  'cpp' in self.compilers and self.compilers'cpp'.get_id() in ('ti', 'c2000')):
+            elif ('c' in self.compilers and self.compilers'c'.get_id() in {'ti', 'c2000'} or
+                  'cpp' in self.compilers and self.compilers'cpp'.get_id() in {'ti', 'c2000'}):
                 self.suffix = 'out'
             else:
                 self.suffix = machine.get_exe_suffix()
@@ -1952,7 +1912,7 @@
     typename = 'static library'
 
     def __init__(self, name: str, subdir: str, subproject: str, for_machine: MachineChoice,
-                 sources: T.ListFile, structured_sources: T.Optional'StructuredSources',
+                 sources: T.ListSourceOutputs, structured_sources: T.Optional'StructuredSources',
                  objects, environment: environment.Environment, compilers: T.Dictstr, 'Compiler',
                  kwargs):
         self.prelink = kwargs.get('prelink', False)
@@ -2024,7 +1984,7 @@
     typename = 'shared library'
 
     def __init__(self, name: str, subdir: str, subproject: str, for_machine: MachineChoice,
-                 sources: T.ListFile, structured_sources: T.Optional'StructuredSources',
+                 sources: T.ListSourceOutputs, structured_sources: T.Optional'StructuredSources',
                  objects, environment: environment.Environment, compilers: T.Dictstr, 'Compiler',
                  kwargs):
         self.soversion = None
@@ -2121,13 +2081,15 @@
                 prefix = ''
                 # Import library is called foo.dll.lib
                 self.import_filename = f'{self.name}.dll.lib'
-                create_debug_file = True
+                # Debug files(.pdb) is only created with debug buildtype
+                create_debug_file = self.environment.coredata.get_option(OptionKey("debug"))
             elif 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
-                create_debug_file = True
+                # Debug files(.pdb) is only created with debug buildtype
+                create_debug_file = self.environment.coredata.get_option(OptionKey("debug"))
             # Assume GCC-compatible naming
             else:
                 # Shared library is of the form libfoo.dll
@@ -2213,10 +2175,10 @@
                     raise InvalidArguments('Shared library darwin_versions: must be X.Y.Z where '
                                            'X, Y, Z are numbers, and Y and Z are optional')
                 parts = v.split('.')
-                if len(parts) in (1, 2, 3) and int(parts0) > 65535:
+                if len(parts) in {1, 2, 3} and int(parts0) > 65535:
                     raise InvalidArguments('Shared library darwin_versions: must be X.Y.Z '
                                            'where X is 0, 65535 and Y, Z are optional')
-                if len(parts) in (2, 3) and int(parts1) > 255:
+                if len(parts) in {2, 3} and int(parts1) > 255:
                     raise InvalidArguments('Shared library darwin_versions: must be X.Y.Z '
                                            'where Y is 0, 255 and Y, Z are optional')
                 if len(parts) == 3 and int(parts2) > 255:
@@ -2231,11 +2193,6 @@
         super().process_kwargs(kwargs)
 
         if not self.environment.machinesself.for_machine.is_android():
-            supports_versioning = True
-        else:
-            supports_versioning = False
-
-        if supports_versioning:
             # Shared library version
             if 'version' in kwargs:
                 self.ltversion = kwargs'version'
@@ -2361,7 +2318,7 @@
     typename = 'shared module'
 
     def __init__(self, name: str, subdir: str, subproject: str, for_machine: MachineChoice,
-                 sources: T.ListFile, structured_sources: T.Optional'StructuredSources',
+                 sources: T.ListSourceOutputs, structured_sources: T.Optional'StructuredSources',
                  objects, environment: environment.Environment,
                  compilers: T.Dictstr, 'Compiler', kwargs):
         if 'version' in kwargs:
@@ -2459,9 +2416,9 @@
                  env: T.OptionalEnvironmentVariables = None,
                  feed: bool = False,
                  install: bool = False,
-                 install_dir: T.OptionalT.SequenceT.Unionstr, LiteralFalse = None,
+                 install_dir: T.OptionalT.ListT.Unionstr, LiteralFalse = None,
                  install_mode: T.OptionalFileMode = None,
-                 install_tag: T.OptionalT.SequenceT.Optionalstr = None,
+                 install_tag: T.OptionalT.ListT.Optionalstr = None,
                  absolute_paths: bool = False,
                  backend: T.Optional'Backend' = None,
                  ):
@@ -2599,7 +2556,7 @@
 
     def is_internal(self) -> bool:
         '''
-        Returns True iif this is a not installed static library.
+        Returns True if this is a not installed static library.
         '''
         if len(self.outputs) != 1:
             return False
@@ -2627,6 +2584,44 @@
     def __len__(self) -> int:
         return len(self.outputs)
 
+class CompileTarget(BuildTarget):
+    '''
+    Target that only compile sources without linking them together.
+    It can be used as preprocessor, or transpiler.
+    '''
+
+    typename = 'compile'
+
+    def __init__(self,
+                 name: str,
+                 subdir: str,
+                 subproject: str,
+                 environment: environment.Environment,
+                 sources: T.ListFile,
+                 output_templ: str,
+                 compiler: Compiler,
+                 kwargs):
+        compilers = {compiler.get_language(): compiler}
+        super().__init__(name, subdir, subproject, compiler.for_machine,
+                         sources, None, , environment, compilers, kwargs)
+        self.filename = name
+        self.compiler = compiler
+        self.output_templ = output_templ
+        self.outputs = 
+        for f in sources:
+            plainname = os.path.basename(f.fname)
+            basename = os.path.splitext(plainname)0
+            self.outputs.append(output_templ.replace('@BASENAME@', basename).replace('@PLAINNAME@', plainname))
+        self.sources_map = dict(zip(sources, self.outputs))
+
+    def type_suffix(self) -> str:
+        return "@compile"
+
+    @property
+    def is_unity(self) -> bool:
+        return False
+
+
 class RunTarget(Target, CommandBase):
 
     typename = 'run'
@@ -2693,7 +2688,7 @@
     typename = 'jar'
 
     def __init__(self, name: str, subdir: str, subproject: str, for_machine: MachineChoice,
-                 sources: T.ListFile, structured_sources: T.Optional'StructuredSources',
+                 sources: T.ListSourceOutputs, structured_sources: T.Optional'StructuredSources',
                  objects, environment: environment.Environment, compilers: T.Dictstr, 'Compiler',
                  kwargs):
         super().__init__(name, subdir, subproject, for_machine, sources, structured_sources, objects,
@@ -2751,7 +2746,7 @@
 
     typename: T.ClassVarstr = 'custom'
 
-    target: CustomTarget
+    target: T.UnionCustomTarget, CompileTarget
     output: str
 
     def __post_init__(self) -> None:
@@ -2762,8 +2757,7 @@
         return f'{self.target.name}{self.output}'
 
     def __repr__(self):
-        return '<CustomTargetIndex: {!r}{}>'.format(
-            self.target, self.target.get_outputs().index(self.output))
+        return '<CustomTargetIndex: {!r}{}>'.format(self.target, self.output)
 
     def get_outputs(self) -> T.Liststr:
         return self.output
@@ -2805,7 +2799,7 @@
 
     def is_internal(self) -> bool:
         '''
-        Returns True iif this is a not installed static library
+        Returns True if this is a not installed static library
         '''
         suf = os.path.splitext(self.output)-1
         return suf in {'.a', '.lib'} and not self.should_install()
@@ -2900,24 +2894,11 @@
 
 def load(build_dir: str) -> Build:
     filename = os.path.join(build_dir, 'meson-private', 'build.dat')
-    load_fail_msg = f'Build data file {filename!r} is corrupted. Try with a fresh build tree.'
-    nonexisting_fail_msg = f'No such build data file as "{filename!r}".'
     try:
-        with open(filename, 'rb') as f:
-            obj = pickle.load(f)
+        return pickle_load(filename, 'Build data', Build)
     except FileNotFoundError:
-        raise MesonException(nonexisting_fail_msg)
-    except (pickle.UnpicklingError, EOFError):
-        raise MesonException(load_fail_msg)
-    except AttributeError:
-        raise MesonException(
-            f"Build data file {filename!r} references functions or classes that don't "
-            "exist. This probably means that it was generated with an old "
-            "version of meson. Try running from the source directory "
-            f"meson {build_dir} --wipe")
-    if not isinstance(obj, Build):
-        raise MesonException(load_fail_msg)
-    return obj
+        raise MesonException(f'No such build data file as {filename!r}.')
+
 
 def save(obj: Build, filename: str) -> None:
     with open(filename, 'wb') as f:

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/cmake/common.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/cmake/common.py Changed

@@ -14,6 +14,7 @@
 
 # This class contains the basic functionality needed to run any interpreter
 # or an interpreter-based tool.
+from __future__ import annotations
 
 from ..mesonlib import MesonException, OptionKey
 from .. import mlog
@@ -100,9 +101,9 @@
             escape = False
         elif i == '\\':
             escape = True
-        elif i in '"', "'":
+        elif i in {'"', "'"}:
             in_string = not in_string
-        elif i in ' ', '\n':
+        elif i in {' ', '\n'}:
             if in_string:
                 curr += i
             else:
@@ -111,7 +112,7 @@
         else:
             curr += i
     res += curr
-    res = list(filter(lambda x: len(x) > 0, res))
+    res = r for r in res if len(r) > 0
     return res
 
 def cmake_get_generator_args(env: 'Environment') -> T.Liststr:
@@ -151,7 +152,7 @@
     dis = '-D' + x for x in blacklist_cmake_defs
     assert dis  # Ensure that dis is not empty.
     for i in args:
-        if any(i.startswith(x) for x in dis):
+        if any(i.startswith(x) for x in dis):
             mlog.warning('Setting', mlog.bold(i), 'is not supported. See the meson docs for cross compilation support:')
             mlog.warning('  - URL: https://mesonbuild.com/CMake-module.html#cross-compilation')
             mlog.warning('  --> Ignoring this option')
@@ -161,7 +162,7 @@
 
 class CMakeInclude:
     def __init__(self, path: Path, isSystem: bool = False):
-        self.path     = path
+        self.path = path
         self.isSystem = isSystem
 
     def __repr__(self) -> str:
@@ -169,11 +170,11 @@
 
 class CMakeFileGroup:
     def __init__(self, data: T.Dictstr, T.Any) -> None:
-        self.defines      = data.get('defines', '')                       # type: str
-        self.flags        = _flags_to_list(data.get('compileFlags', ''))  # type: T.Liststr
+        self.defines = data.get('defines', '')                       # type: str
+        self.flags = _flags_to_list(data.get('compileFlags', ''))  # type: T.Liststr
         self.is_generated = data.get('isGenerated', False)                # type: bool
-        self.language     = data.get('language', 'C')                     # type: str
-        self.sources      = Path(x) for x in data.get('sources', )    # type: T.ListPath
+        self.language = data.get('language', 'C')                     # type: str
+        self.sources = Path(x) for x in data.get('sources', )    # type: T.ListPath
 
         # Fix the include directories
         self.includes =   # type: T.ListCMakeInclude
@@ -199,21 +200,21 @@
 
 class CMakeTarget:
     def __init__(self, data: T.Dictstr, T.Any) -> None:
-        self.artifacts               = Path(x) for x in data.get('artifacts', )         # type: T.ListPath
-        self.src_dir                 = Path(data.get('sourceDirectory', ''))                # type: Path
-        self.build_dir               = Path(data.get('buildDirectory', ''))                 # type: Path
-        self.name                    = data.get('name', '')                                 # type: str
-        self.full_name               = data.get('fullName', '')                             # type: str
-        self.install                 = data.get('hasInstallRule', False)                    # type: bool
-        self.install_paths           = Path(x) for x in set(data.get('installPaths', )) # type: T.ListPath
-        self.link_lang               = data.get('linkerLanguage', '')                       # type: str
-        self.link_libraries          = _flags_to_list(data.get('linkLibraries', ''))        # type: T.Liststr
-        self.link_flags              = _flags_to_list(data.get('linkFlags', ''))            # type: T.Liststr
-        self.link_lang_flags         = _flags_to_list(data.get('linkLanguageFlags', ''))    # type: T.Liststr
-        # self.link_path             = Path(data.get('linkPath', ''))                       # type: Path
-        self.type                    = data.get('type', 'EXECUTABLE')                       # type: str
-        # self.is_generator_provided = data.get('isGeneratorProvided', False)               # type: bool
-        self.files                   =                                                    # type: T.ListCMakeFileGroup
+        self.artifacts = Path(x) for x in data.get('artifacts', )               # type: T.ListPath
+        self.src_dir = Path(data.get('sourceDirectory', ''))                        # type: Path
+        self.build_dir = Path(data.get('buildDirectory', ''))                       # type: Path
+        self.name = data.get('name', '')                                            # type: str
+        self.full_name = data.get('fullName', '')                                   # type: str
+        self.install = data.get('hasInstallRule', False)                            # type: bool
+        self.install_paths = Path(x) for x in set(data.get('installPaths', ))   # type: T.ListPath
+        self.link_lang = data.get('linkerLanguage', '')                             # type: str
+        self.link_libraries = _flags_to_list(data.get('linkLibraries', ''))         # type: T.Liststr
+        self.link_flags = _flags_to_list(data.get('linkFlags', ''))                 # type: T.Liststr
+        self.link_lang_flags = _flags_to_list(data.get('linkLanguageFlags', ''))    # type: T.Liststr
+        # self.link_path = Path(data.get('linkPath', ''))                             # type: Path
+        self.type = data.get('type', 'EXECUTABLE')                                  # type: str
+        # self.is_generator_provided = data.get('isGeneratorProvided', False)         # type: bool
+        self.files =                                                              # type: T.ListCMakeFileGroup
 
         for i in data.get('fileGroups', ):
             self.files += CMakeFileGroup(i)
@@ -240,10 +241,10 @@
 
 class CMakeProject:
     def __init__(self, data: T.Dictstr, T.Any) -> None:
-        self.src_dir   = Path(data.get('sourceDirectory', ''))   # type: Path
-        self.build_dir = Path(data.get('buildDirectory', ''))    # type: Path
-        self.name      = data.get('name', '')                    # type: str
-        self.targets   =                                       # type: T.ListCMakeTarget
+        self.src_dir = Path(data.get('sourceDirectory', ''))    # type: Path
+        self.build_dir = Path(data.get('buildDirectory', ''))   # type: Path
+        self.name = data.get('name', '')                        # type: str
+        self.targets =                                        # type: T.ListCMakeTarget
 
         for i in data.get('targets', ):
             self.targets += CMakeTarget(i)
@@ -259,8 +260,8 @@
 
 class CMakeConfiguration:
     def __init__(self, data: T.Dictstr, T.Any) -> None:
-        self.name     = data.get('name', '')   # type: str
-        self.projects =                      # type: T.ListCMakeProject
+        self.name = data.get('name', '')        # type: str
+        self.projects =                       # type: T.ListCMakeProject
         for i in data.get('projects', ):
             self.projects += CMakeProject(i)

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/cmake/executor.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/cmake/executor.py Changed

@@ -14,24 +14,27 @@
 
 # This class contains the basic functionality needed to run any interpreter
 # or an interpreter-based tool.
+from __future__ import annotations
 
 import subprocess as S
-from pathlib import Path
 from threading import Thread
 import typing as T
 import re
 import os
 
 from .. import mlog
-from ..mesonlib import PerMachine, Popen_safe, version_compare, MachineChoice, is_windows, OptionKey
+from ..mesonlib import PerMachine, Popen_safe, version_compare, is_windows, OptionKey
 from ..programs import find_external_program, NonExistingExternalProgram
 
 if T.TYPE_CHECKING:
+    from pathlib import Path
+
     from ..environment import Environment
+    from ..mesonlib import MachineChoice
     from ..programs import ExternalProgram
 
-TYPE_result    = T.Tupleint, T.Optionalstr, T.Optionalstr
-TYPE_cache_key = T.Tuplestr, T.Tuplestr, ..., str, T.FrozenSetT.Tuplestr, str
+    TYPE_result = T.Tupleint, T.Optionalstr, T.Optionalstr
+    TYPE_cache_key = T.Tuplestr, T.Tuplestr, ..., str, T.FrozenSetT.Tuplestr, str
 
 class CMakeExecutor:
     # The class's copy of the CMake path. Avoids having to search for it
@@ -105,23 +108,29 @@
             mlog.log(f'Did not find CMake {cmakebin.name!r}')
             return None
         try:
-            p, out = Popen_safe(cmakebin.get_command() + '--version')0:2
+            cmd = cmakebin.get_command()
+            p, out = Popen_safe(cmd + '--version')0:2
             if p.returncode != 0:
                 mlog.warning('Found CMake {!r} but couldn\'t run it'
-                             ''.format(' '.join(cmakebin.get_command())))
+                             ''.format(' '.join(cmd)))
                 return None
         except FileNotFoundError:
             mlog.warning('We thought we found CMake {!r} but now it\'s not there. How odd!'
-                         ''.format(' '.join(cmakebin.get_command())))
+                         ''.format(' '.join(cmd)))
             return None
         except PermissionError:
-            msg = 'Found CMake {!r} but didn\'t have permissions to run it.'.format(' '.join(cmakebin.get_command()))
+            msg = 'Found CMake {!r} but didn\'t have permissions to run it.'.format(' '.join(cmd))
             if not is_windows():
                 msg += '\n\nOn Unix-like systems this is often caused by scripts that are not executable.'
             mlog.warning(msg)
             return None
-        cmvers = re.search(r'(cmake|cmake3)\s*version\s*(\d.+)', out).group(2)
-        return cmvers
+
+        cmvers = re.search(r'(cmake|cmake3)\s*version\s*(\d.+)', out)
+        if cmvers is not None:
+            return cmvers.group(2)
+        mlog.warning(f'We thought we found CMake {cmd!r}, but it was missing the expected '
+                     'version string in its output.')
+        return None
 
     def set_exec_mode(self, print_cmout: T.Optionalbool = None, always_capture_stderr: T.Optionalbool = None) -> None:
         if print_cmout is not None:

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/cmake/fileapi.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/cmake/fileapi.py Changed

@@ -11,6 +11,7 @@
 # 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.
+from __future__ import annotations
 
 from .common import CMakeException, CMakeBuildFile, CMakeConfiguration
 import typing as T
@@ -23,13 +24,13 @@
 
 class CMakeFileAPI:
     def __init__(self, build_dir: Path):
-        self.build_dir            = build_dir
-        self.api_base_dir         = self.build_dir / '.cmake' / 'api' / 'v1'
-        self.request_dir          = self.api_base_dir / 'query' / 'client-meson'
-        self.reply_dir            = self.api_base_dir / 'reply'
-        self.cmake_sources        =    # type: T.ListCMakeBuildFile
+        self.build_dir = build_dir
+        self.api_base_dir = self.build_dir / '.cmake' / 'api' / 'v1'
+        self.request_dir = self.api_base_dir / 'query' / 'client-meson'
+        self.reply_dir = self.api_base_dir / 'reply'
+        self.cmake_sources =    # type: T.ListCMakeBuildFile
         self.cmake_configurations =    # type: T.ListCMakeConfiguration
-        self.kind_resolver_map    = {
+        self.kind_resolver_map = {
             'codemodel': self._parse_codemodel,
             'cmakeFiles': self._parse_cmakeFiles,
         }
@@ -103,7 +104,7 @@
             src_dir = Path(dir_entry.get('source', '.'))
             bld_dir = Path(dir_entry.get('build', '.'))
             src_dir = src_dir if src_dir.is_absolute() else source_dir / src_dir
-            bld_dir = bld_dir if bld_dir.is_absolute() else build_dir  / bld_dir
+            bld_dir = bld_dir if bld_dir.is_absolute() else build_dir / bld_dir
             src_dir = src_dir.resolve()
             bld_dir = bld_dir.resolve()

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/cmake/generator.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/cmake/generator.py Changed

@@ -11,8 +11,10 @@
 # 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.
+from __future__ import annotations
 
 from .. import mesonlib
+from .. import mlog
 from .common import cmake_is_debug
 import typing as T
 
@@ -66,6 +68,7 @@
 
     def target_file(arg: str) -> str:
         if arg not in trace.targets:
+            mlog.warning(f"Unable to evaluate the cmake variable '$<TARGET_FILE:{arg}>'.")
             return ''
         tgt = trace.targetsarg
 
@@ -97,9 +100,9 @@
 
     supported = {
         # Boolean functions
-        'BOOL': lambda x: '0' if x.upper() in '0', 'FALSE', 'OFF', 'N', 'NO', 'IGNORE', 'NOTFOUND' or x.endswith('-NOTFOUND') else '1',
-        'AND': lambda x: '1' if all(y == '1' for y in x.split(',')) else '0',
-        'OR': lambda x: '1' if any(y == '1' for y in x.split(',')) else '0',
+        'BOOL': lambda x: '0' if x.upper() in {'0', 'FALSE', 'OFF', 'N', 'NO', 'IGNORE', 'NOTFOUND'} or x.endswith('-NOTFOUND') else '1',
+        'AND': lambda x: '1' if all(y == '1' for y in x.split(',')) else '0',
+        'OR': lambda x: '1' if any(y == '1' for y in x.split(',')) else '0',
         'NOT': lambda x: '0' if x == '1' else '1',
 
         'IF': lambda x: x.split(',')1 if x.split(',')0 == '1' else x.split(',')2,

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/cmake/interpreter.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/cmake/interpreter.py Changed

@@ -14,12 +14,19 @@
 
 # This class contains the basic functionality needed to run any interpreter
 # or an interpreter-based tool.
+from __future__ import annotations
 
-from .common import CMakeException, CMakeTarget, TargetOptions, CMakeConfiguration, language_map, cmake_get_generator_args, check_cmake_args
+from functools import lru_cache
+from os import environ
+from pathlib import Path
+import re
+import typing as T
+
+from .common import CMakeException, CMakeTarget, language_map, cmake_get_generator_args, check_cmake_args
 from .fileapi import CMakeFileAPI
 from .executor import CMakeExecutor
 from .toolchain import CMakeToolchain, CMakeExecScope
-from .traceparser import CMakeTraceParser, CMakeGeneratorTarget
+from .traceparser import CMakeTraceParser
 from .tracetargets import resolve_cmake_trace_targets
 from .. import mlog, mesonlib
 from ..mesonlib import MachineChoice, OrderedSet, path_is_in_root, relative_to_if_possible, OptionKey
@@ -27,12 +34,6 @@
 from ..compilers.compilers import assembler_suffixes, lang_suffixes, header_suffixes, obj_suffixes, lib_suffixes, is_header
 from ..programs import ExternalProgram
 from ..coredata import FORBIDDEN_TARGET_NAMES
-from functools import lru_cache
-from pathlib import Path
-import typing as T
-import re
-from os import environ
-
 from ..mparser import (
     Token,
     BaseNode,
@@ -51,14 +52,16 @@
 
 
 if T.TYPE_CHECKING:
+    from .common import CMakeConfiguration, TargetOptions
+    from .traceparser import CMakeGeneratorTarget
     from .._typing import ImmutableListProtocol
     from ..build import Build
     from ..backend.backends import Backend
     from ..environment import Environment
 
-TYPE_mixed        = T.Unionstr, int, bool, Path, BaseNode
-TYPE_mixed_list   = T.UnionTYPE_mixed, T.SequenceTYPE_mixed
-TYPE_mixed_kwargs = T.Dictstr, TYPE_mixed_list
+    TYPE_mixed = T.Unionstr, int, bool, Path, BaseNode
+    TYPE_mixed_list = T.UnionTYPE_mixed, T.SequenceTYPE_mixed
+    TYPE_mixed_kwargs = T.Dictstr, TYPE_mixed_list
 
 # Disable all warnings automatically enabled with --trace and friends
 # See https://cmake.org/cmake/help/latest/variable/CMAKE_POLICY_WARNING_CMPNNNN.html
@@ -128,7 +131,7 @@
     rm_so_version = re.compile(r'(\.0-9+)+$')
 
     def __init__(self, build_dir: Path):
-        self.tgt_map   = {}          # type: T.Dictstr, T.Union'ConverterTarget', 'ConverterCustomTarget'
+        self.tgt_map: T.Dictstr, T.Union'ConverterTarget', 'ConverterCustomTarget' = {}
         self.build_dir = build_dir
 
     def add(self, tgt: T.Union'ConverterTarget', 'ConverterCustomTarget') -> None:
@@ -207,48 +210,48 @@
 
 class ConverterTarget:
     def __init__(self, target: CMakeTarget, env: 'Environment', for_machine: MachineChoice) -> None:
-        self.env            = env
-        self.for_machine    = for_machine
-        self.artifacts      = target.artifacts
-        self.src_dir        = target.src_dir
-        self.build_dir      = target.build_dir
-        self.name           = target.name
-        self.cmake_name     = target.name
-        self.full_name      = target.full_name
-        self.type           = target.type
-        self.install        = target.install
-        self.install_dir    = None  # type: T.OptionalPath
+        self.env = env
+        self.for_machine = for_machine
+        self.artifacts = target.artifacts
+        self.src_dir = target.src_dir
+        self.build_dir = target.build_dir
+        self.name = target.name
+        self.cmake_name = target.name
+        self.full_name = target.full_name
+        self.type = target.type
+        self.install = target.install
+        self.install_dir: T.OptionalPath = None
         self.link_libraries = target.link_libraries
-        self.link_flags     = target.link_flags + target.link_lang_flags
-        self.depends_raw    =   # type: T.Liststr
-        self.depends        =   # type: T.ListT.UnionConverterTarget, ConverterCustomTarget
+        self.link_flags = target.link_flags + target.link_lang_flags
+        self.depends_raw: T.Liststr = 
+        self.depends: T.ListT.UnionConverterTarget, ConverterCustomTarget = 
 
         if target.install_paths:
             self.install_dir = target.install_paths0
 
-        self.languages           = set() # type: T.Setstr
-        self.sources             =   # type: T.ListPath
-        self.generated           =   # type: T.ListPath
-        self.generated_ctgt      =   # type: T.ListCustomTargetReference
-        self.includes            =   # type: T.ListPath
-        self.sys_includes        =   # type: T.ListPath
-        self.link_with           =   # type: T.ListT.UnionConverterTarget, ConverterCustomTarget
-        self.object_libs         =   # type: T.ListConverterTarget
-        self.compile_opts        = {}  # type: T.Dictstr, T.Liststr
-        self.public_compile_opts =   # type: T.Liststr
-        self.pie                 = False
+        self.languages: T.Setstr = set()
+        self.sources: T.ListPath = 
+        self.generated: T.ListPath = 
+        self.generated_ctgt: T.ListCustomTargetReference = 
+        self.includes: T.ListPath = 
+        self.sys_includes: T.ListPath = 
+        self.link_with: T.ListT.UnionConverterTarget, ConverterCustomTarget = 
+        self.object_libs: T.ListConverterTarget = 
+        self.compile_opts: T.Dictstr, T.Liststr = {}
+        self.public_compile_opts: T.Liststr = 
+        self.pie = False
 
         # Project default override options (c_std, cpp_std, etc.)
-        self.override_options =   # type: T.Liststr
+        self.override_options: T.Liststr = 
 
         # Convert the target name to a valid meson target name
         self.name = _sanitize_cmake_name(self.name)
 
-        self.generated_raw =   # type: T.ListPath
+        self.generated_raw: T.ListPath = 
 
         for i in target.files:
-            languages    = set()  #  type: T.Setstr
-            src_suffixes = set()  #  type: T.Setstr
+            languages: T.Setstr = set()
+            src_suffixes: T.Setstr = set()
 
             # Insert suffixes
             for j in i.sources:
@@ -317,7 +320,7 @@
                         )
                         continue
                     self.override_options += f'{i}_std={std}'
-                elif j in '-fPIC', '-fpic', '-fPIE', '-fpie':
+                elif j in {'-fPIC', '-fpic', '-fPIE', '-fpie'}:
                     self.pie = True
                 elif isinstance(ctgt, ConverterCustomTarget):
                     # Sometimes projects pass generated source files as compiler
@@ -342,10 +345,10 @@
             self.depends_raw = trace.targetsself.cmake_name.depends
 
             rtgt = resolve_cmake_trace_targets(self.cmake_name, trace, self.env)
-            self.includes            += Path(x) for x in rtgt.include_directories
-            self.link_flags          += rtgt.link_flags
+            self.includes += Path(x) for x in rtgt.include_directories
+            self.link_flags += rtgt.link_flags
             self.public_compile_opts += rtgt.public_compile_opts
-            self.link_libraries      += rtgt.libraries
+            self.link_libraries += rtgt.libraries
 
         elif self.type.upper() not in 'EXECUTABLE', 'OBJECT_LIBRARY':
             mlog.warning('CMake: Target', mlog.bold(self.cmake_name), 'not found in CMake trace. This can lead to build errors')
@@ -369,8 +372,8 @@
         for i in self.languages:
             supported += list(lang_suffixesi)
         supported = f'.{x}' for x in supported
-        self.sources       = x for x in self.sources       if any(x.name.endswith(y) for y in supported)
-        self.generated_raw = x for x in self.generated_raw if any(x.name.endswith(y) for y in supported)
+        self.sources = x for x in self.sources if any(x.name.endswith(y) for y in supported)
+        self.generated_raw = x for x in self.generated_raw if any(x.name.endswith(y) for y in supported)
 
         # Make paths relative
         def rel_path(x: Path, is_header: bool, is_generated: bool) -> T.OptionalPath:
@@ -378,7 +381,7 @@
                 x = self.src_dir / x
             x = x.resolve()
             assert x.is_absolute()
-            if not x.exists() and not any(x.name.endswith(y) for y in obj_suffixes) and not is_generated:
+            if not x.exists() and not any(x.name.endswith(y) for y in obj_suffixes) and not is_generated:
                 if path_is_in_root(x, Path(self.env.get_build_dir()), resolve=True):
                     x.mkdir(parents=True, exist_ok=True)
                     return x.relative_to(Path(self.env.get_build_dir()) / subdir)
@@ -394,7 +397,7 @@
                         path_is_in_root(x, root_src_dir) or
                         path_is_in_root(x, Path(self.env.get_build_dir()))
                     )
-                ):
+                    ):
                 mlog.warning('CMake: path', mlog.bold(x.as_posix()), 'is inside the root project but', mlog.bold('not'), 'inside the subproject.')
                 mlog.warning(' --> Ignoring. This can lead to build errors.')
                 return None
@@ -422,9 +425,9 @@
                 self.generated += gen_file
 
         # Remove delete entries
-        self.includes     = x for x in self.includes     if x is not None
+        self.includes = x for x in self.includes if x is not None
         self.sys_includes = x for x in self.sys_includes if x is not None
-        self.sources      = x for x in self.sources      if x is not None
+        self.sources = x for x in self.sources if x is not None
 
         # Make sure '.' is always in the include directories
         if Path('.') not in self.includes:
@@ -458,7 +461,7 @@
             return res
 
         self.link_libraries = handle_frameworks(self.link_libraries)
-        self.link_flags     = handle_frameworks(self.link_flags)
+        self.link_flags = handle_frameworks(self.link_flags)
 
         # Handle explicit CMake add_dependency() calls
         for i in self.depends_raw:
@@ -468,7 +471,7 @@
 
     def process_object_libs(self, obj_target_list: T.List'ConverterTarget', linker_workaround: bool) -> None:
         # Try to detect the object library(s) from the generated input sources
-        temp = x for x in self.generated if any(x.name.endswith('.' + y) for y in obj_suffixes)
+        temp = x for x in self.generated if any(x.name.endswith('.' + y) for y in obj_suffixes)
         stem = x.stem for x in temp
         exts = self._all_source_suffixes()
         # Temp now stores the source filenames of the object files
@@ -480,11 +483,11 @@
                 # suffix and just produces object files like `foo.obj`. Thus we have to do our best to
                 # undo this step and guess the correct language suffix of the object file. This is done
                 # by trying all language suffixes meson knows and checking if one of them fits.
-                candidates = j  # type: T.Liststr
-                if not any(j.endswith('.' + x) for x in exts):
+                candidates = j
+                if not any(j.endswith('.' + x) for x in exts):
                     mlog.warning('Object files do not contain source file extensions, thus falling back to guessing them.', once=True)
                     candidates += f'{j}.{x}' for x in exts
-                if any(x in source_files for x in candidates):
+                if any(x in source_files for x in candidates):
                     if linker_workaround:
                         self._append_objlib_sources(i)
                     else:
@@ -494,17 +497,17 @@
                     break
 
         # Filter out object files from the sources
-        self.generated = x for x in self.generated if not any(x.name.endswith('.' + y) for y in obj_suffixes)
+        self.generated = x for x in self.generated if not any(x.name.endswith('.' + y) for y in obj_suffixes)
 
     def _append_objlib_sources(self, tgt: 'ConverterTarget') -> None:
-        self.includes       += tgt.includes
-        self.sources        += tgt.sources
-        self.generated      += tgt.generated
+        self.includes += tgt.includes
+        self.sources += tgt.sources
+        self.generated += tgt.generated
         self.generated_ctgt += tgt.generated_ctgt
-        self.includes        = list(OrderedSet(self.includes))
-        self.sources         = list(OrderedSet(self.sources))
-        self.generated       = list(OrderedSet(self.generated))
-        self.generated_ctgt  = list(OrderedSet(self.generated_ctgt))
+        self.includes = list(OrderedSet(self.includes))
+        self.sources = list(OrderedSet(self.sources))
+        self.generated = list(OrderedSet(self.generated))
+        self.generated_ctgt = list(OrderedSet(self.generated_ctgt))
 
         # Inherit compiler arguments since they may be required for building
         for lang, opts in tgt.compile_opts.items():
@@ -514,9 +517,9 @@
 
     @lru_cache(maxsize=None)
     def _all_source_suffixes(self) -> 'ImmutableListProtocolstr':
-        suffixes =   # type: T.Liststr
+        suffixes: T.Liststr = 
         for exts in lang_suffixes.values():
-            suffixes += x for x in exts
+            suffixes.extend(exts)
         return suffixes
 
     @lru_cache(maxsize=None)
@@ -580,8 +583,8 @@
 
 class CustomTargetReference:
     def __init__(self, ctgt: 'ConverterCustomTarget', index: int) -> None:
-        self.ctgt = ctgt    # type: ConverterCustomTarget
-        self.index = index  # type: int
+        self.ctgt = ctgt
+        self.index = index
 
     def __repr__(self) -> str:
         if self.valid():
@@ -596,8 +599,8 @@
         return self.ctgt.outputsself.index
 
 class ConverterCustomTarget:
-    tgt_counter = 0  # type: int
-    out_counter = 0  # type: int
+    tgt_counter = 0
+    out_counter = 0
 
     def __init__(self, target: CMakeGeneratorTarget, env: 'Environment', for_machine: MachineChoice) -> None:
         assert target.current_bin_dir is not None
@@ -606,20 +609,20 @@
         if not self.name:
             self.name = f'custom_tgt_{ConverterCustomTarget.tgt_counter}'
             ConverterCustomTarget.tgt_counter += 1
-        self.cmake_name       = str(self.name)
+        self.cmake_name = str(self.name)
         self.original_outputs = list(target.outputs)
-        self.outputs          = x.name for x in self.original_outputs
-        self.conflict_map     = {}                      # type: T.Dictstr, str
-        self.command          =                       # type: T.ListT.ListT.Unionstr, ConverterTarget
-        self.working_dir      = target.working_dir
-        self.depends_raw      = target.depends
-        self.inputs           =                       # type: T.ListT.Unionstr, CustomTargetReference
-        self.depends          =                       # type: T.ListT.UnionConverterTarget, ConverterCustomTarget
-        self.current_bin_dir  = target.current_bin_dir  # type: Path
-        self.current_src_dir  = target.current_src_dir  # type: Path
-        self.env              = env
-        self.for_machine      = for_machine
-        self._raw_target      = target
+        self.outputs = x.name for x in self.original_outputs
+        self.conflict_map: T.Dictstr, str = {}
+        self.command: T.ListT.ListT.Unionstr, ConverterTarget = 
+        self.working_dir = target.working_dir
+        self.depends_raw = target.depends
+        self.inputs: T.ListT.Unionstr, CustomTargetReference = 
+        self.depends: T.ListT.UnionConverterTarget, ConverterCustomTarget = 
+        self.current_bin_dir = target.current_bin_dir
+        self.current_src_dir = target.current_src_dir
+        self.env = env
+        self.for_machine = for_machine
+        self._raw_target = target
 
         # Convert the target name to a valid meson target name
         self.name = _sanitize_cmake_name(self.name)
@@ -649,7 +652,7 @@
         # Ensure that there is no duplicate output in the project so
         # that meson can handle cases where the same filename is
         # generated in multiple directories
-        temp_outputs =   # type: T.Liststr
+        temp_outputs: T.Liststr = 
         for i in self.outputs:
             if i in all_outputs:
                 old = str(i)
@@ -661,10 +664,11 @@
         self.outputs = temp_outputs
 
         # Check if the command is a build target
-        commands =   # type: T.ListT.ListT.Unionstr, ConverterTarget
+        commands: T.ListT.ListT.Unionstr, ConverterTarget = 
         for curr_cmd in self._raw_target.command:
             assert isinstance(curr_cmd, list)
-            cmd =   # type: T.ListT.Unionstr, ConverterTarget
+            assert curr_cmd0 != '', "An empty string is not a valid executable"
+            cmd: T.ListT.Unionstr, ConverterTarget = 
 
             for j in curr_cmd:
                 if not j:
@@ -762,34 +766,34 @@
 
 class CMakeInterpreter:
     def __init__(self, build: 'Build', subdir: Path, src_dir: Path, install_prefix: Path, env: 'Environment', backend: 'Backend'):
-        self.build          = build
-        self.subdir         = subdir
-        self.src_dir        = src_dir
-        self.build_dir_rel  = subdir / '__CMake_build'
-        self.build_dir      = Path(env.get_build_dir()) / self.build_dir_rel
+        self.build = build
+        self.subdir = subdir
+        self.src_dir = src_dir
+        self.build_dir_rel = subdir / '__CMake_build'
+        self.build_dir = Path(env.get_build_dir()) / self.build_dir_rel
         self.install_prefix = install_prefix
-        self.env            = env
-        self.for_machine    = MachineChoice.HOST # TODO make parameter
-        self.backend_name   = backend.name
-        self.linkers        = set()  # type: T.Setstr
-        self.fileapi        = CMakeFileAPI(self.build_dir)
+        self.env = env
+        self.for_machine = MachineChoice.HOST # TODO make parameter
+        self.backend_name = backend.name
+        self.linkers: T.Setstr = set()
+        self.fileapi = CMakeFileAPI(self.build_dir)
 
         # Raw CMake results
-        self.bs_files          =     # type: T.ListPath
-        self.codemodel_configs = None  # type: T.OptionalT.ListCMakeConfiguration
-        self.cmake_stderr      = None  # type: T.Optionalstr
+        self.bs_files: T.ListPath = 
+        self.codemodel_configs: T.OptionalT.ListCMakeConfiguration = None
+        self.cmake_stderr: T.Optionalstr = None
 
         # Analysed data
-        self.project_name      = ''
-        self.languages         =   # type: T.Liststr
-        self.targets           =   # type: T.ListConverterTarget
-        self.custom_targets    =   # type: T.ListConverterCustomTarget
+        self.project_name = ''
+        self.languages: T.Liststr = 
+        self.targets: T.ListConverterTarget = 
+        self.custom_targets: T.ListConverterCustomTarget = 
         self.trace: CMakeTraceParser
         self.output_target_map = OutputTargetMap(self.build_dir)
 
         # Generated meson data
-        self.generated_targets = {}  # type: T.Dictstr, T.Dictstr, T.Optionalstr
-        self.internal_name_map = {}  # type: T.Dictstr, str
+        self.generated_targets: T.Dictstr, T.Dictstr, T.Optionalstr = {}
+        self.internal_name_map: T.Dictstr, str = {}
 
         # Do some special handling for object libraries for certain configurations
         self._object_lib_workaround = False
@@ -886,7 +890,7 @@
         self.trace.parse(self.cmake_stderr)
 
         # Find all targets
-        added_target_names =   # type: T.Liststr
+        added_target_names: T.Liststr = 
         for i_0 in self.codemodel_configs:
             for j_0 in i_0.projects:
                 if not self.project_name:
@@ -923,7 +927,7 @@
 
         # First pass: Basic target cleanup
         object_libs = 
-        custom_target_outputs =   # type: T.Liststr
+        custom_target_outputs: T.Liststr = 
         for ctgt in self.custom_targets:
             ctgt.postprocess(self.output_target_map, self.src_dir, custom_target_outputs, self.trace)
         for tgt in self.targets:
@@ -1022,9 +1026,9 @@
         # Add the run script for custom commands
 
         # Add the targets
-        processing =    # type: T.Liststr
-        processed  = {}   # type: T.Dictstr, T.Dictstr, T.Optionalstr
-        name_map   = {}   # type: T.Dictstr, str
+        processing: T.Liststr = 
+        processed: T.Dictstr, T.Dictstr, T.Optionalstr = {}
+        name_map: T.Dictstr, str = {}
 
         def extract_tgt(tgt: T.UnionConverterTarget, ConverterCustomTarget, CustomTargetReference) -> IdNode:
             tgt_name = None
@@ -1052,13 +1056,13 @@
             detect_cycle(tgt)
 
             # First handle inter target dependencies
-            link_with           =   # type: T.ListIdNode
-            objec_libs          =   # type: T.ListIdNode
-            sources             =   # type: T.ListPath
-            generated           =   # type: T.ListT.UnionIdNode, IndexNode
-            generated_filenames =   # type: T.Liststr
-            custom_targets      =   # type: T.ListConverterCustomTarget
-            dependencies        =   # type: T.ListIdNode
+            link_with: T.ListIdNode = 
+            objec_libs: T.ListIdNode = 
+            sources: T.ListPath = 
+            generated: T.ListT.UnionIdNode, IndexNode = 
+            generated_filenames: T.Liststr = 
+            custom_targets: T.ListConverterCustomTarget = 
+            dependencies: T.ListIdNode = 
             for i in tgt.link_with:
                 assert isinstance(i, ConverterTarget)
                 if i.name not in processed:
@@ -1119,7 +1123,7 @@
             install_tgt = options.get_install(tgt.cmake_name, tgt.install)
 
             # Generate target kwargs
-            tgt_kwargs = {
+            tgt_kwargs: TYPE_mixed_kwargs = {
                 'build_by_default': install_tgt,
                 'link_args': options.get_link_args(tgt.cmake_name, tgt.link_flags + tgt.link_libraries),
                 'link_with': link_with,
@@ -1127,7 +1131,7 @@
                 'install': install_tgt,
                 'override_options': options.get_override_options(tgt.cmake_name, tgt.override_options),
                 'objects': method(x, 'extract_all_objects') for x in objec_libs,
-            }  # type: TYPE_mixed_kwargs
+            }
 
             # Only set if installed and only override if it is set
             if install_tgt and tgt.install_dir:
@@ -1144,12 +1148,12 @@
                 tgt_kwargs'pic' = tgt.pie
 
             # declare_dependency kwargs
-            dep_kwargs = {
+            dep_kwargs: TYPE_mixed_kwargs = {
                 'link_args': tgt.link_flags + tgt.link_libraries,
                 'link_with': id_node(tgt_var),
                 'compile_args': tgt.public_compile_opts,
                 'include_directories': id_node(inc_var),
-            }  # type: TYPE_mixed_kwargs
+            }
 
             if dependencies:
                 generated += dependencies
@@ -1169,10 +1173,10 @@
                 src_node = assign(src_var, function('files', sources))
                 tgt_node = assign(tgt_var, function(tgt_func, tgt_var, id_node(src_var), *generated, tgt_kwargs))
                 node_list += src_node, tgt_node
-                if tgt_func in 'static_library', 'shared_library':
+                if tgt_func in {'static_library', 'shared_library'}:
                     dep_node = assign(dep_var, function('declare_dependency', kwargs=dep_kwargs))
                     node_list += dep_node
-                elif tgt_func in 'shared_module':
+                elif tgt_func == 'shared_module':
                     del dep_kwargs'link_with'
                     dep_node = assign(dep_var, function('declare_dependency', kwargs=dep_kwargs))
                     node_list += dep_node
@@ -1191,7 +1195,7 @@
             # directory.
 
             detect_cycle(tgt)
-            tgt_var = tgt.name  # type: str
+            tgt_var = tgt.name
 
             def resolve_source(x: T.Unionstr, ConverterTarget, ConverterCustomTarget, CustomTargetReference) -> T.Unionstr, IdNode, IndexNode:
                 if isinstance(x, ConverterTarget):
@@ -1210,7 +1214,7 @@
                     return x
 
             # Generate the command list
-            command =   # type: T.ListT.Unionstr, IdNode, IndexNode
+            command: T.ListT.Unionstr, IdNode, IndexNode = 
             command += mesonlib.get_meson_command()
             command += '--internal', 'cmake_run_ctgt'
             command += '-o', '@OUTPUT@'
@@ -1222,12 +1226,12 @@
             for cmd in tgt.command:
                 command += resolve_source(x) for x in cmd + ';;;'
 
-            tgt_kwargs = {
+            tgt_kwargs: TYPE_mixed_kwargs = {
                 'input': resolve_source(x) for x in tgt.inputs,
                 'output': tgt.outputs,
                 'command': command,
                 'depends': resolve_source(x) for x in tgt.depends,
-            }  # type: TYPE_mixed_kwargs
+            }
 
             root_cb.lines += assign(tgt_var, function('custom_target', tgt.name, tgt_kwargs))
             processedtgt.name = {'inc': None, 'src': None, 'dep': None, 'tgt': tgt_var, 'func': 'custom_target'}

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/cmake/toolchain.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/cmake/toolchain.py Changed

@@ -11,12 +11,11 @@
 # 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.
+from __future__ import annotations
 
 from pathlib import Path
 from .traceparser import CMakeTraceParser
 from ..envconfig import CMakeSkipCompilerTest
-from ..mesonlib import MachineChoice
-from ..compilers import VisualStudioLikeCompiler
 from .common import language_map, cmake_get_generator_args
 from .. import mlog
 
@@ -29,6 +28,7 @@
     from .executor import CMakeExecutor
     from ..environment import Environment
     from ..compilers import Compiler
+    from ..mesonlib import MachineChoice
 
 class CMakeExecScope(Enum):
     SUBPROJECT = 'subproject'
@@ -36,20 +36,20 @@
 
 class CMakeToolchain:
     def __init__(self, cmakebin: 'CMakeExecutor', env: 'Environment', for_machine: MachineChoice, exec_scope: CMakeExecScope, build_dir: Path, preload_file: T.OptionalPath = None) -> None:
-        self.env            = env
-        self.cmakebin       = cmakebin
-        self.for_machine    = for_machine
-        self.exec_scope     = exec_scope
-        self.preload_file   = preload_file
-        self.build_dir      = build_dir
-        self.build_dir      = self.build_dir.resolve()
+        self.env = env
+        self.cmakebin = cmakebin
+        self.for_machine = for_machine
+        self.exec_scope = exec_scope
+        self.preload_file = preload_file
+        self.build_dir = build_dir
+        self.build_dir = self.build_dir.resolve()
         self.toolchain_file = build_dir / 'CMakeMesonToolchainFile.cmake'
-        self.cmcache_file   = build_dir / 'CMakeCache.txt'
-        self.minfo          = self.env.machinesself.for_machine
-        self.properties     = self.env.propertiesself.for_machine
-        self.compilers      = self.env.coredata.compilersself.for_machine
-        self.cmakevars      = self.env.cmakevarsself.for_machine
-        self.cmakestate     = self.env.coredata.cmake_cacheself.for_machine
+        self.cmcache_file = build_dir / 'CMakeCache.txt'
+        self.minfo = self.env.machinesself.for_machine
+        self.properties = self.env.propertiesself.for_machine
+        self.compilers = self.env.coredata.compilersself.for_machine
+        self.cmakevars = self.env.cmakevarsself.for_machine
+        self.cmakestate = self.env.coredata.cmake_cacheself.for_machine
 
         self.variables = self.get_defaults()
         self.variables.update(self.cmakevars.get_variables())
@@ -164,7 +164,7 @@
         # Only set these in a cross build. Otherwise CMake will trip up in native
         # builds and thing they are cross (which causes TRY_RUN() to break)
         if self.env.is_cross_build(when_building_for=self.for_machine):
-            defaults'CMAKE_SYSTEM_NAME'      = SYSTEM_MAP.get(self.minfo.system, self.minfo.system)
+            defaults'CMAKE_SYSTEM_NAME' = SYSTEM_MAP.get(self.minfo.system, self.minfo.system)
             defaults'CMAKE_SYSTEM_PROCESSOR' = self.minfo.cpu_family
 
         defaults'CMAKE_SIZEOF_VOID_P' = '8' if self.minfo.is_64_bit else '4'
@@ -203,7 +203,7 @@
 
     @staticmethod
     def is_cmdline_option(compiler: 'Compiler', arg: str) -> bool:
-        if isinstance(compiler, VisualStudioLikeCompiler):
+        if compiler.get_argument_syntax() == 'msvc':
             return arg.startswith('/')
         else:
             return arg.startswith('-')
@@ -215,8 +215,8 @@
 
         # Generate the CMakeLists.txt
         mlog.debug('CMake Toolchain: Calling CMake once to generate the compiler state')
-        languages     = list(self.compilers.keys())
-        lang_ids      = language_map.get(x, x.upper()) for x in languages
+        languages = list(self.compilers.keys())
+        lang_ids = language_map.get(x, x.upper()) for x in languages
         cmake_content = dedent(f'''
             cmake_minimum_required(VERSION 3.7)
             project(CompInfo {' '.join(lang_ids)})
@@ -252,7 +252,7 @@
 
         for lang in languages:
             lang_cmake = language_map.get(lang, lang.upper())
-            file_name  = f'CMake{lang_cmake}Compiler.cmake'
+            file_name = f'CMake{lang_cmake}Compiler.cmake'
             vars = vars_by_file.setdefault(file_name, {})
             varsf'CMAKE_{lang_cmake}_COMPILER_FORCED' = '1'
             self.cmakestate.update(lang, vars)

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/cmake/traceparser.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/cmake/traceparser.py Changed

@@ -14,6 +14,7 @@
 
 # This class contains the basic functionality needed to run any interpreter
 # or an interpreter-based tool.
+from __future__ import annotations
 
 from .common import CMakeException
 from .generator import parse_generator_expressions
@@ -56,17 +57,17 @@
                 name:        str,
                 target_type: str,
                 properties:  T.OptionalT.Dictstr, T.Liststr = None,
-                imported:    bool                                 = False,
-                tline:       T.OptionalCMakeTraceLine           = None
+                imported:    bool = False,
+                tline:       T.OptionalCMakeTraceLine = None
             ):
         if properties is None:
             properties = {}
-        self.name            = name
-        self.type            = target_type
-        self.properties      = properties
-        self.imported        = imported
-        self.tline           = tline
-        self.depends         =       # type: T.Liststr
+        self.name = name
+        self.type = target_type
+        self.properties = properties
+        self.imported = imported
+        self.tline = tline
+        self.depends =       # type: T.Liststr
         self.current_bin_dir = None    # type: T.OptionalPath
         self.current_src_dir = None    # type: T.OptionalPath
 
@@ -83,7 +84,7 @@
             return
         for key, val in self.properties.items():
             self.propertieskey = x.strip() for x in val
-            assert all(';' not in x for x in self.propertieskey)
+            assert all(';' not in x for x in self.propertieskey)
 
 class CMakeGeneratorTarget(CMakeTarget):
     def __init__(self, name: str) -> None:
@@ -95,9 +96,9 @@
 
 class CMakeTraceParser:
     def __init__(self, cmake_version: str, build_dir: Path, env: 'Environment', permissive: bool = True) -> None:
-        self.vars:                      T.Dictstr, T.Liststr     = {}
-        self.vars_by_file: T.DictPath, T.Dictstr, T.Liststr    = {}
-        self.targets:                   T.Dictstr, CMakeTarget     = {}
+        self.vars:                      T.Dictstr, T.Liststr = {}
+        self.vars_by_file: T.DictPath, T.Dictstr, T.Liststr = {}
+        self.targets:                   T.Dictstr, CMakeTarget = {}
         self.cache:                     T.Dictstr, CMakeCacheEntry = {}
 
         self.explicit_headers = set()  # type: T.SetPath
@@ -203,7 +204,7 @@
                 fn(l)
 
         # Evaluate generator expressions
-        strlist_gen:  T.CallableT.Liststr, T.Liststr  = lambda strlist: parse_generator_expressions(';'.join(strlist), self).split(';') if strlist else 
+        strlist_gen:  T.CallableT.Liststr, T.Liststr = lambda strlist: parse_generator_expressions(';'.join(strlist), self).split(';') if strlist else 
         pathlist_gen: T.CallableT.Liststr, T.ListPath = lambda strlist: Path(x) for x in parse_generator_expressions(';'.join(strlist), self).split(';') if strlist else 
 
         self.vars = {k: strlist_gen(v) for k, v in self.vars.items()}
@@ -211,7 +212,7 @@
             p: {k: strlist_gen(v) for k, v in d.items()}
             for p, d in self.vars_by_file.items()
         }
-        self.explicit_headers = set(Path(parse_generator_expressions(str(x), self)) for x in self.explicit_headers)
+        self.explicit_headers = {Path(parse_generator_expressions(str(x), self)) for x in self.explicit_headers}
         self.cache = {
             k: CMakeCacheEntry(
                 strlist_gen(v.value),
@@ -231,7 +232,13 @@
 
         for ctgt in self.custom_targets:
             ctgt.outputs = pathlist_gen(ctgt._outputs_str)
+            temp = ctgt.command
             ctgt.command = strlist_gen(x) for x in ctgt.command
+            for command, src in zip(ctgt.command, temp):
+                if command0 == "":
+                    raise CMakeException(
+                        "We evaluated the cmake variable '{}' to an empty string, which is not a valid path to an executable.".format(src0)
+                    )
             ctgt.working_dir = Path(parse_generator_expressions(str(ctgt.working_dir), self)) if ctgt.working_dir is not None else None
 
         # Postprocess
@@ -297,10 +304,10 @@
         """
         # DOC: https://cmake.org/cmake/help/latest/command/set.html
 
-        cache_type  = None
+        cache_type = None
         cache_force = 'FORCE' in tline.args
         try:
-            cache_idx  = tline.args.index('CACHE')
+            cache_idx = tline.args.index('CACHE')
             cache_type = tline.argscache_idx + 1
         except (ValueError, IndexError):
             pass
@@ -460,7 +467,7 @@
         cbinary_dir = self.var_to_str('MESON_PS_CMAKE_CURRENT_BINARY_DIR')
         csource_dir = self.var_to_str('MESON_PS_CMAKE_CURRENT_SOURCE_DIR')
 
-        target.working_dir     = Path(working_dir) if working_dir else None
+        target.working_dir = Path(working_dir) if working_dir else None
         target.current_bin_dir = Path(cbinary_dir) if cbinary_dir else None
         target.current_src_dir = Path(csource_dir) if csource_dir else None
         target._outputs_str = self._guess_files(target._outputs_str)
@@ -492,7 +499,7 @@
             curr = args.pop(0)
             # XXX: APPEND_STRING is specifically *not* supposed to create a
             # list, is treating them as aliases really okay?
-            if curr == 'APPEND' or curr == 'APPEND_STRING':
+            if curr in {'APPEND', 'APPEND_STRING'}:
                 append = True
                 continue
 
@@ -676,14 +683,14 @@
             if i in ignore:
                 continue
 
-            if i in 'INTERFACE', 'LINK_INTERFACE_LIBRARIES', 'PUBLIC', 'PRIVATE', 'LINK_PUBLIC', 'LINK_PRIVATE':
+            if i in {'INTERFACE', 'LINK_INTERFACE_LIBRARIES', 'PUBLIC', 'PRIVATE', 'LINK_PUBLIC', 'LINK_PRIVATE'}:
                 mode = i
                 continue
 
-            if mode in 'INTERFACE', 'LINK_INTERFACE_LIBRARIES', 'PUBLIC', 'LINK_PUBLIC':
+            if mode in {'INTERFACE', 'LINK_INTERFACE_LIBRARIES', 'PUBLIC', 'LINK_PUBLIC'}:
                 interface += i.split(';')
 
-            if mode in 'PUBLIC', 'PRIVATE', 'LINK_PRIVATE':
+            if mode in {'PUBLIC', 'PRIVATE', 'LINK_PRIVATE'}:
                 private += i.split(';')
 
         if paths:
@@ -741,7 +748,7 @@
             func = mo_file_line.group(4)
             args = mo_file_line.group(5)
             argl = args.split(' ')
-            argl = list(map(lambda x: x.strip(), argl))
+            argl = a.strip() for a in argl
 
             yield CMakeTraceLine(file, int(line), func, argl)

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/cmake/tracetargets.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/cmake/tracetargets.py Changed

@@ -1,5 +1,6 @@
 # SPDX-License-Identifer: Apache-2.0
 # Copyright 2021 The Meson development team
+from __future__ import annotations
 
 from .common import cmake_is_debug
 from .. import mlog
@@ -12,6 +13,7 @@
     from .traceparser import CMakeTraceParser
     from ..environment import Environment
     from ..compilers import Compiler
+    from ..dependencies import MissingCompiler
 
 class ResolvedTarget:
     def __init__(self) -> None:
@@ -24,7 +26,7 @@
                                 trace: 'CMakeTraceParser',
                                 env: 'Environment',
                                 *,
-                                clib_compiler: T.Optional'Compiler' = None,
+                                clib_compiler: T.Union'MissingCompiler', 'Compiler' = None,
                                 not_found_warning: T.Callablestr, None = lambda x: None) -> ResolvedTarget:
     res = ResolvedTarget()
     targets = target_name
@@ -48,7 +50,7 @@
                 res.libraries += curr
             elif Path(curr).is_absolute() and Path(curr).exists():
                 res.libraries += curr
-            elif env.machines.build.is_windows() and reg_is_maybe_bare_lib.match(curr) and clib_compiler is not None:
+            elif env.machines.build.is_windows() and reg_is_maybe_bare_lib.match(curr) and clib_compiler:
                 # On Windows, CMake library dependencies can be passed as bare library names,
                 # CMake brute-forces a combination of prefix/suffix combinations to find the
                 # right library. Assume any bare argument passed which is not also a CMake
@@ -110,8 +112,8 @@
         processed_targets += curr
 
     res.include_directories = sorted(set(res.include_directories))
-    res.link_flags          = sorted(set(res.link_flags))
+    res.link_flags = sorted(set(res.link_flags))
     res.public_compile_opts = sorted(set(res.public_compile_opts))
-    res.libraries           = sorted(set(res.libraries))
+    res.libraries = sorted(set(res.libraries))
 
     return res

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/compilers/__init__.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/compilers/__init__.py Changed

@@ -52,83 +52,6 @@
     'detect_rust_compiler',
     'detect_d_compiler',
     'detect_swift_compiler',
-
-    'AppleClangCCompiler',
-    'AppleClangCPPCompiler',
-    'AppleClangObjCCompiler',
-    'AppleClangObjCPPCompiler',
-    'ArmCCompiler',
-    'ArmCPPCompiler',
-    'ArmclangCCompiler',
-    'ArmclangCPPCompiler',
-    'CCompiler',
-    'ClangCCompiler',
-    'ClangCompiler',
-    'ClangCPPCompiler',
-    'ClangObjCCompiler',
-    'ClangObjCPPCompiler',
-    'ClangClCCompiler',
-    'ClangClCPPCompiler',
-    'CPPCompiler',
-    'DCompiler',
-    'DmdDCompiler',
-    'FortranCompiler',
-    'G95FortranCompiler',
-    'GnuCCompiler',
-    'ElbrusCCompiler',
-    'EmscriptenCCompiler',
-    'GnuCompiler',
-    'GnuLikeCompiler',
-    'GnuCPPCompiler',
-    'ElbrusCPPCompiler',
-    'EmscriptenCPPCompiler',
-    'GnuDCompiler',
-    'GnuFortranCompiler',
-    'ElbrusFortranCompiler',
-    'FlangFortranCompiler',
-    'GnuObjCCompiler',
-    'GnuObjCPPCompiler',
-    'IntelGnuLikeCompiler',
-    'IntelVisualStudioLikeCompiler',
-    'IntelCCompiler',
-    'IntelCPPCompiler',
-    'IntelClCCompiler',
-    'IntelClCPPCompiler',
-    'IntelFortranCompiler',
-    'IntelClFortranCompiler',
-    'JavaCompiler',
-    'LLVMDCompiler',
-    'MonoCompiler',
-    'CudaCompiler',
-    'VisualStudioCsCompiler',
-    'NAGFortranCompiler',
-    'ObjCCompiler',
-    'ObjCPPCompiler',
-    'Open64FortranCompiler',
-    'PathScaleFortranCompiler',
-    'NvidiaHPC_CCompiler',
-    'NvidiaHPC_CPPCompiler',
-    'NvidiaHPC_FortranCompiler',
-    'PGICCompiler',
-    'PGICPPCompiler',
-    'PGIFortranCompiler',
-    'RustCompiler',
-    'ClippyRustCompiler',
-    'CcrxCCompiler',
-    'CcrxCPPCompiler',
-    'Xc16CCompiler',
-    'CompCertCCompiler',
-    'C2000CCompiler',
-    'C2000CPPCompiler',
-    'TICCompiler',
-    'TICPPCompiler',
-    'SunFortranCompiler',
-    'SwiftCompiler',
-    'ValaCompiler',
-    'VisualStudioLikeCompiler',
-    'VisualStudioCCompiler',
-    'VisualStudioCPPCompiler',
-    'CythonCompiler',
 
 
 # Bring symbols from each module into compilers sub-package namespace
@@ -172,87 +95,3 @@
     detect_d_compiler,
     detect_swift_compiler,
 )
-from .c import (
-    CCompiler,
-    AppleClangCCompiler,
-    ArmCCompiler,
-    ArmclangCCompiler,
-    ClangCCompiler,
-    ClangClCCompiler,
-    GnuCCompiler,
-    ElbrusCCompiler,
-    EmscriptenCCompiler,
-    IntelCCompiler,
-    IntelClCCompiler,
-    NvidiaHPC_CCompiler,
-    PGICCompiler,
-    CcrxCCompiler,
-    Xc16CCompiler,
-    CompCertCCompiler,
-    C2000CCompiler,
-    TICCompiler,
-    VisualStudioCCompiler,
-)
-from .cpp import (
-    CPPCompiler,
-    AppleClangCPPCompiler,
-    ArmCPPCompiler,
-    ArmclangCPPCompiler,
-    ClangCPPCompiler,
-    ClangClCPPCompiler,
-    GnuCPPCompiler,
-    ElbrusCPPCompiler,
-    EmscriptenCPPCompiler,
-    IntelCPPCompiler,
-    IntelClCPPCompiler,
-    NvidiaHPC_CPPCompiler,
-    PGICPPCompiler,
-    CcrxCPPCompiler,
-    C2000CPPCompiler,
-    TICPPCompiler,
-    VisualStudioCPPCompiler,
-)
-from .cs import MonoCompiler, VisualStudioCsCompiler
-from .d import (
-    DCompiler,
-    DmdDCompiler,
-    GnuDCompiler,
-    LLVMDCompiler,
-)
-from .cuda import CudaCompiler
-from .fortran import (
-    FortranCompiler,
-    G95FortranCompiler,
-    GnuFortranCompiler,
-    ElbrusFortranCompiler,
-    FlangFortranCompiler,
-    IntelFortranCompiler,
-    IntelClFortranCompiler,
-    NAGFortranCompiler,
-    Open64FortranCompiler,
-    PathScaleFortranCompiler,
-    NvidiaHPC_FortranCompiler,
-    PGIFortranCompiler,
-    SunFortranCompiler,
-)
-from .java import JavaCompiler
-from .objc import (
-    ObjCCompiler,
-    AppleClangObjCCompiler,
-    ClangObjCCompiler,
-    GnuObjCCompiler,
-)
-from .objcpp import (
-    ObjCPPCompiler,
-    AppleClangObjCPPCompiler,
-    ClangObjCPPCompiler,
-    GnuObjCPPCompiler,
-)
-from .rust import RustCompiler, ClippyRustCompiler
-from .swift import SwiftCompiler
-from .vala import ValaCompiler
-from .mixins.visualstudio import VisualStudioLikeCompiler
-from .mixins.gnu import GnuCompiler, GnuLikeCompiler
-from .mixins.intel import IntelGnuLikeCompiler, IntelVisualStudioLikeCompiler
-from .mixins.clang import ClangCompiler
-from .cython import CythonCompiler

_service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/compilers/asm.py Added

@@ -0,0 +1,231 @@
+import os
+import typing as T
+
+from ..mesonlib import EnvironmentException, get_meson_command
+from .compilers import Compiler
+
+if T.TYPE_CHECKING:
+    from ..environment import Environment
+
+nasm_optimization_args = {
+    'plain': ,
+    '0': '-O0',
+    'g': '-O0',
+    '1': '-O1',
+    '2': '-Ox',
+    '3': '-Ox',
+    's': '-Ox',
+}  # type: T.Dictstr, T.Liststr
+
+
+class NasmCompiler(Compiler):
+    language = 'nasm'
+    id = 'nasm'
+
+    def needs_static_linker(self) -> bool:
+        return True
+
+    def get_always_args(self) -> T.Liststr:
+        cpu = '64' if self.info.is_64_bit else '32'
+        if self.info.is_windows() or self.info.is_cygwin():
+            plat = 'win'
+            define = f'WIN{cpu}'
+        elif self.info.is_darwin():
+            plat = 'macho'
+            define = 'MACHO'
+        else:
+            plat = 'elf'
+            define = 'ELF'
+        args = '-f', f'{plat}{cpu}', f'-D{define}'
+        if self.info.is_64_bit:
+            args.append('-D__x86_64__')
+        return args
+
+    def get_werror_args(self) -> T.Liststr:
+        return '-Werror'
+
+    def get_output_args(self, outputname: str) -> T.Liststr:
+        return '-o', outputname
+
+    def unix_args_to_native(self, args: T.Liststr) -> T.Liststr:
+        outargs = 
+        for arg in args:
+            if arg == '-pthread':
+                continue
+            outargs.append(arg)
+        return outargs
+
+    def get_optimization_args(self, optimization_level: str) -> T.Liststr:
+        return nasm_optimization_argsoptimization_level
+
+    def get_debug_args(self, is_debug: bool) -> T.Liststr:
+        if is_debug:
+            if self.info.is_windows():
+                return 
+            return '-g', '-F', 'dwarf'
+        return 
+
+    def get_depfile_suffix(self) -> str:
+        return 'd'
+
+    def get_dependency_gen_args(self, outtarget: str, outfile: str) -> T.Liststr:
+        return '-MD', outfile, '-MQ', outtarget
+
+    def sanity_check(self, work_dir: str, environment: 'Environment') -> None:
+        if self.info.cpu_family not in {'x86', 'x86_64'}:
+            raise EnvironmentException(f'ASM compiler {self.id!r} does not support {self.info.cpu_family} CPU family')
+
+    def get_buildtype_args(self, buildtype: str) -> T.Liststr:
+        # FIXME: Not implemented
+        return 
+
+    def get_pic_args(self) -> T.Liststr:
+        return 
+
+    def get_include_args(self, path: str, is_system: bool) -> T.Liststr:
+        if not path:
+            path = '.'
+        return '-I' + path
+
+    def compute_parameters_with_absolute_paths(self, parameter_list: T.Liststr,
+                                               build_dir: str) -> T.Liststr:
+        for idx, i in enumerate(parameter_list):
+            if i:2 == '-I':
+                parameter_listidx = i:2 + os.path.normpath(os.path.join(build_dir, i2:))
+        return parameter_list
+
+    def get_crt_compile_args(self, crt_val: str, buildtype: str) -> T.Liststr:
+        return 
+
+class YasmCompiler(NasmCompiler):
+    id = 'yasm'
+
+    def get_exelist(self, ccache: bool = True) -> T.Liststr:
+        # Wrap yasm executable with an internal script that will write depfile.
+        exelist = super().get_exelist(ccache)
+        return get_meson_command() + '--internal', 'yasm' + exelist
+
+    def get_debug_args(self, is_debug: bool) -> T.Liststr:
+        if is_debug:
+            if self.info.is_windows():
+                return '-g', 'null'
+            return '-g', 'dwarf2'
+        return 
+
+    def get_dependency_gen_args(self, outtarget: str, outfile: str) -> T.Liststr:
+        return '--depfile', outfile
+
+# https://learn.microsoft.com/en-us/cpp/assembler/masm/ml-and-ml64-command-line-reference
+class MasmCompiler(Compiler):
+    language = 'masm'
+    id = 'ml'
+
+    def get_compile_only_args(self) -> T.Liststr:
+        return '/c'
+
+    def get_argument_syntax(self) -> str:
+        return 'msvc'
+
+    def needs_static_linker(self) -> bool:
+        return True
+
+    def get_always_args(self) -> T.Liststr:
+        return '/nologo'
+
+    def get_werror_args(self) -> T.Liststr:
+        return '/WX'
+
+    def get_output_args(self, outputname: str) -> T.Liststr:
+        return '/Fo', outputname
+
+    def get_optimization_args(self, optimization_level: str) -> T.Liststr:
+        return 
+
+    def get_debug_args(self, is_debug: bool) -> T.Liststr:
+        if is_debug:
+            return '/Zi'
+        return 
+
+    def sanity_check(self, work_dir: str, environment: 'Environment') -> None:
+        if self.info.cpu_family not in {'x86', 'x86_64'}:
+            raise EnvironmentException(f'ASM compiler {self.id!r} does not support {self.info.cpu_family} CPU family')
+
+    def get_buildtype_args(self, buildtype: str) -> T.Liststr:
+        # FIXME: Not implemented
+        return 
+
+    def get_pic_args(self) -> T.Liststr:
+        return 
+
+    def get_include_args(self, path: str, is_system: bool) -> T.Liststr:
+        if not path:
+            path = '.'
+        return '-I' + path
+
+    def compute_parameters_with_absolute_paths(self, parameter_list: T.Liststr,
+                                               build_dir: str) -> T.Liststr:
+        for idx, i in enumerate(parameter_list):
+            if i:2 == '-I' or i:2 == '/I':
+                parameter_listidx = i:2 + os.path.normpath(os.path.join(build_dir, i2:))
+        return parameter_list
+
+    def get_crt_compile_args(self, crt_val: str, buildtype: str) -> T.Liststr:
+        return 
+
+    def depfile_for_object(self, objfile: str) -> T.Optionalstr:
+        return None
+
+
+# https://learn.microsoft.com/en-us/cpp/assembler/arm/arm-assembler-command-line-reference
+class MasmARMCompiler(Compiler):
+    language = 'masm'
+    id = 'armasm'
+
+    def needs_static_linker(self) -> bool:
+        return True
+
+    def get_always_args(self) -> T.Liststr:
+        return '-nologo'
+
+    def get_werror_args(self) -> T.Liststr:
+        return 
+
+    def get_output_args(self, outputname: str) -> T.Liststr:
+        return '-o', outputname
+
+    def get_optimization_args(self, optimization_level: str) -> T.Liststr:
+        return 
+
+    def get_debug_args(self, is_debug: bool) -> T.Liststr:
+        if is_debug:
+            return '-g'
+        return 
+
+    def sanity_check(self, work_dir: str, environment: 'Environment') -> None:
+        if self.info.cpu_family not in {'arm', 'aarch64'}:
+            raise EnvironmentException(f'ASM compiler {self.id!r} does not support {self.info.cpu_family} CPU family')
+
+    def get_buildtype_args(self, buildtype: str) -> T.Liststr:
+        # FIXME: Not implemented
+        return 
+
+    def get_pic_args(self) -> T.Liststr:
+        return 
+
+    def get_include_args(self, path: str, is_system: bool) -> T.Liststr:
+        if not path:
+            path = '.'
+        return '-i' + path
+
+    def compute_parameters_with_absolute_paths(self, parameter_list: T.Liststr,
+                                               build_dir: str) -> T.Liststr:
+        for idx, i in enumerate(parameter_list):
+            if i:2 == '-I':
+                parameter_listidx = i:2 + os.path.normpath(os.path.join(build_dir, i2:))
+        return parameter_list
+
+    def get_crt_compile_args(self, crt_val: str, buildtype: str) -> T.Liststr:
+        return 
+
+    def depfile_for_object(self, objfile: str) -> T.Optionalstr:
+        return None

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/compilers/c.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/compilers/c.py Changed

@@ -11,13 +11,14 @@
 # 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.
+from __future__ import annotations
 
 import os.path
 import typing as T
 
 from .. import coredata
 from .. import mlog
-from ..mesonlib import MachineChoice, MesonException, version_compare, OptionKey
+from ..mesonlib import MesonException, version_compare, OptionKey
 from .c_function_attributes import C_FUNC_ATTRIBUTES
 from .mixins.clike import CLikeCompiler
 from .mixins.ccrx import CcrxCompiler
@@ -27,6 +28,7 @@
 from .mixins.arm import ArmCompiler, ArmclangCompiler
 from .mixins.visualstudio import MSVCCompiler, ClangClCompiler
 from .mixins.gnu import GnuCompiler
+from .mixins.gnu import gnu_common_warning_args, gnu_c_warning_args
 from .mixins.intel import IntelGnuLikeCompiler, IntelVisualStudioLikeCompiler
 from .mixins.clang import ClangCompiler
 from .mixins.elbrus import ElbrusCompiler
@@ -44,6 +46,7 @@
     from ..envconfig import MachineInfo
     from ..environment import Environment
     from ..linkers import DynamicLinker
+    from ..mesonlib import MachineChoice
     from ..programs import ExternalProgram
     from .compilers import CompileCheckMode
 
@@ -61,12 +64,12 @@
 
     language = 'c'
 
-    def __init__(self, exelist: T.Liststr, version: str, for_machine: MachineChoice, is_cross: bool,
+    def __init__(self, ccache: T.Liststr, exelist: T.Liststr, version: str, for_machine: MachineChoice, is_cross: bool,
                  info: 'MachineInfo', exe_wrapper: T.Optional'ExternalProgram' = None,
                  linker: T.Optional'DynamicLinker' = None,
                  full_version: T.Optionalstr = None):
         # If a child ObjC or CPP class has already set it, don't set it ourselves
-        Compiler.__init__(self, exelist, version, for_machine, info,
+        Compiler.__init__(self, ccache, exelist, version, for_machine, info,
                           is_cross=is_cross, full_version=full_version, linker=linker)
         CLikeCompiler.__init__(self, exe_wrapper)
 
@@ -139,18 +142,19 @@
 
 class ClangCCompiler(_ClangCStds, ClangCompiler, CCompiler):
 
-    def __init__(self, exelist: T.Liststr, version: str, for_machine: MachineChoice, is_cross: bool,
+    def __init__(self, ccache: T.Liststr, exelist: T.Liststr, version: str, for_machine: MachineChoice, is_cross: bool,
                  info: 'MachineInfo', exe_wrapper: T.Optional'ExternalProgram' = None,
                  linker: T.Optional'DynamicLinker' = None,
                  defines: T.OptionalT.Dictstr, str = None,
                  full_version: T.Optionalstr = None):
-        CCompiler.__init__(self, exelist, version, for_machine, is_cross, info, exe_wrapper, linker=linker, full_version=full_version)
+        CCompiler.__init__(self, ccache, exelist, version, for_machine, is_cross, info, exe_wrapper, linker=linker, full_version=full_version)
         ClangCompiler.__init__(self, defines)
         default_warn_args = '-Wall', '-Winvalid-pch'
         self.warn_args = {'0': ,
                           '1': default_warn_args,
                           '2': default_warn_args + '-Wextra',
-                          '3': default_warn_args + '-Wextra', '-Wpedantic'}
+                          '3': default_warn_args + '-Wextra', '-Wpedantic',
+                          'everything': '-Weverything'}
 
     def get_options(self) -> 'MutableKeyedOptionDictType':
         opts = super().get_options()
@@ -203,14 +207,16 @@
 
     id = 'emscripten'
 
-    def __init__(self, exelist: T.Liststr, version: str, for_machine: MachineChoice, is_cross: bool,
+    def __init__(self, ccache: T.Liststr, exelist: T.Liststr, version: str, for_machine: MachineChoice, is_cross: bool,
                  info: 'MachineInfo', exe_wrapper: T.Optional'ExternalProgram' = None,
                  linker: T.Optional'DynamicLinker' = None,
                  defines: T.OptionalT.Dictstr, str = None,
                  full_version: T.Optionalstr = None):
         if not is_cross:
             raise MesonException('Emscripten compiler can only be used for cross compilation.')
-        ClangCCompiler.__init__(self, exelist, version, for_machine, is_cross,
+        if not version_compare(version, '>=1.39.19'):
+            raise MesonException('Meson requires Emscripten >= 1.39.19')
+        ClangCCompiler.__init__(self, ccache, exelist, version, for_machine, is_cross,
                                 info, exe_wrapper=exe_wrapper, linker=linker,
                                 defines=defines, full_version=full_version)
 
@@ -220,18 +226,19 @@
     Keil armclang
     '''
 
-    def __init__(self, exelist: T.Liststr, version: str, for_machine: MachineChoice, is_cross: bool,
+    def __init__(self, ccache: T.Liststr, exelist: T.Liststr, version: str, for_machine: MachineChoice, is_cross: bool,
                  info: 'MachineInfo', exe_wrapper: T.Optional'ExternalProgram' = None,
                  linker: T.Optional'DynamicLinker' = None,
                  full_version: T.Optionalstr = None):
-        CCompiler.__init__(self, exelist, version, for_machine, is_cross,
+        CCompiler.__init__(self, ccache, exelist, version, for_machine, is_cross,
                            info, exe_wrapper, linker=linker, full_version=full_version)
         ArmclangCompiler.__init__(self)
         default_warn_args = '-Wall', '-Winvalid-pch'
         self.warn_args = {'0': ,
                           '1': default_warn_args,
                           '2': default_warn_args + '-Wextra',
-                          '3': default_warn_args + '-Wextra', '-Wpedantic'}
+                          '3': default_warn_args + '-Wextra', '-Wpedantic',
+                          'everything': '-Weverything'}
 
     def get_options(self) -> 'MutableKeyedOptionDictType':
         opts = CCompiler.get_options(self)
@@ -256,12 +263,12 @@
     _C2X_VERSION = '>=9.0.0'
     _INVALID_PCH_VERSION = ">=3.4.0"
 
-    def __init__(self, exelist: T.Liststr, version: str, for_machine: MachineChoice, is_cross: bool,
+    def __init__(self, ccache: T.Liststr, exelist: T.Liststr, version: str, for_machine: MachineChoice, is_cross: bool,
                  info: 'MachineInfo', exe_wrapper: T.Optional'ExternalProgram' = None,
                  linker: T.Optional'DynamicLinker' = None,
                  defines: T.OptionalT.Dictstr, str = None,
                  full_version: T.Optionalstr = None):
-        CCompiler.__init__(self, exelist, version, for_machine, is_cross, info, exe_wrapper, linker=linker, full_version=full_version)
+        CCompiler.__init__(self, ccache, exelist, version, for_machine, is_cross, info, exe_wrapper, linker=linker, full_version=full_version)
         GnuCompiler.__init__(self, defines)
         default_warn_args = '-Wall'
         if version_compare(self.version, self._INVALID_PCH_VERSION):
@@ -269,7 +276,10 @@
         self.warn_args = {'0': ,
                           '1': default_warn_args,
                           '2': default_warn_args + '-Wextra',
-                          '3': default_warn_args + '-Wextra', '-Wpedantic'}
+                          '3': default_warn_args + '-Wextra', '-Wpedantic',
+                          'everything': (default_warn_args + '-Wextra', '-Wpedantic' +
+                                         self.supported_warn_args(gnu_common_warning_args) +
+                                         self.supported_warn_args(gnu_c_warning_args))}
 
     def get_options(self) -> 'MutableKeyedOptionDictType':
         opts = CCompiler.get_options(self)
@@ -314,11 +324,11 @@
 
 
 class PGICCompiler(PGICompiler, CCompiler):
-    def __init__(self, exelist: T.Liststr, version: str, for_machine: MachineChoice, is_cross: bool,
+    def __init__(self, ccache: T.Liststr, exelist: T.Liststr, version: str, for_machine: MachineChoice, is_cross: bool,
                  info: 'MachineInfo', exe_wrapper: T.Optional'ExternalProgram' = None,
                  linker: T.Optional'DynamicLinker' = None,
                  full_version: T.Optionalstr = None):
-        CCompiler.__init__(self, exelist, version, for_machine, is_cross,
+        CCompiler.__init__(self, ccache, exelist, version, for_machine, is_cross,
                            info, exe_wrapper, linker=linker, full_version=full_version)
         PGICompiler.__init__(self)
 
@@ -327,22 +337,22 @@
 
     id = 'nvidia_hpc'
 
-    def __init__(self, exelist: T.Liststr, version: str, for_machine: MachineChoice, is_cross: bool,
+    def __init__(self, ccache: T.Liststr, exelist: T.Liststr, version: str, for_machine: MachineChoice, is_cross: bool,
                  info: 'MachineInfo', exe_wrapper: T.Optional'ExternalProgram' = None,
                  linker: T.Optional'DynamicLinker' = None,
                  full_version: T.Optionalstr = None):
-        CCompiler.__init__(self, exelist, version, for_machine, is_cross,
+        CCompiler.__init__(self, ccache, exelist, version, for_machine, is_cross,
                            info, exe_wrapper, linker=linker, full_version=full_version)
         PGICompiler.__init__(self)
 
 
 class ElbrusCCompiler(ElbrusCompiler, CCompiler):
-    def __init__(self, exelist: T.Liststr, version: str, for_machine: MachineChoice, is_cross: bool,
+    def __init__(self, ccache: T.Liststr, exelist: T.Liststr, version: str, for_machine: MachineChoice, is_cross: bool,
                  info: 'MachineInfo', exe_wrapper: T.Optional'ExternalProgram' = None,
                  linker: T.Optional'DynamicLinker' = None,
                  defines: T.OptionalT.Dictstr, str = None,
                  full_version: T.Optionalstr = None):
-        CCompiler.__init__(self, exelist, version, for_machine, is_cross,
+        CCompiler.__init__(self, ccache, exelist, version, for_machine, is_cross,
                            info, exe_wrapper, linker=linker, full_version=full_version)
         ElbrusCompiler.__init__(self)
 
@@ -375,19 +385,20 @@
 
 
 class IntelCCompiler(IntelGnuLikeCompiler, CCompiler):
-    def __init__(self, exelist: T.Liststr, version: str, for_machine: MachineChoice, is_cross: bool,
+    def __init__(self, ccache: T.Liststr, exelist: T.Liststr, version: str, for_machine: MachineChoice, is_cross: bool,
                  info: 'MachineInfo', exe_wrapper: T.Optional'ExternalProgram' = None,
                  linker: T.Optional'DynamicLinker' = None,
                  full_version: T.Optionalstr = None):
-        CCompiler.__init__(self, exelist, version, for_machine, is_cross,
+        CCompiler.__init__(self, ccache, exelist, version, for_machine, is_cross,
                            info, exe_wrapper, linker=linker, full_version=full_version)
         IntelGnuLikeCompiler.__init__(self)
         self.lang_header = 'c-header'
-        default_warn_args = '-Wall', '-w3', '-diag-disable:remark'
+        default_warn_args = '-Wall', '-w3'
         self.warn_args = {'0': ,
-                          '1': default_warn_args,
-                          '2': default_warn_args + '-Wextra',
-                          '3': default_warn_args + '-Wextra'}
+                          '1': default_warn_args + '-diag-disable:remark',
+                          '2': default_warn_args + '-Wextra', '-diag-disable:remark',
+                          '3': default_warn_args + '-Wextra', '-diag-disable:remark',
+                          'everything': default_warn_args + '-Wextra'}
 
     def get_options(self) -> 'MutableKeyedOptionDictType':
         opts = CCompiler.get_options(self)
@@ -406,6 +417,11 @@
         return args
 
 
+class IntelLLVMCCompiler(ClangCCompiler):
+
+    id = 'intel-llvm'
+
+
 class VisualStudioLikeCCompilerMixin(CompilerMixinBase):
 
     """Shared methods that apply to MSVC-like C compilers."""
@@ -435,12 +451,12 @@
     _C11_VERSION = '>=19.28'
     _C17_VERSION = '>=19.28'
 
-    def __init__(self, exelist: T.Liststr, version: str, for_machine: MachineChoice,
+    def __init__(self, ccache: T.Liststr, exelist: T.Liststr, version: str, for_machine: MachineChoice,
                  is_cross: bool, info: 'MachineInfo', target: str,
                  exe_wrapper: T.Optional'ExternalProgram' = None,
                  linker: T.Optional'DynamicLinker' = None,
                  full_version: T.Optionalstr = None):
-        CCompiler.__init__(self, exelist, version, for_machine, is_cross,
+        CCompiler.__init__(self, ccache, exelist, version, for_machine, is_cross,
                            info, exe_wrapper, linker=linker,
                            full_version=full_version)
         MSVCCompiler.__init__(self, target)
@@ -484,7 +500,7 @@
                  exe_wrapper: T.Optional'ExternalProgram' = None,
                  linker: T.Optional'DynamicLinker' = None,
                  full_version: T.Optionalstr = None):
-        CCompiler.__init__(self, exelist, version, for_machine, is_cross,
+        CCompiler.__init__(self, , exelist, version, for_machine, is_cross,
                            info, exe_wrapper, linker=linker,
                            full_version=full_version)
         ClangClCompiler.__init__(self, target)
@@ -506,7 +522,7 @@
                  exe_wrapper: T.Optional'ExternalProgram' = None,
                  linker: T.Optional'DynamicLinker' = None,
                  full_version: T.Optionalstr = None):
-        CCompiler.__init__(self, exelist, version, for_machine, is_cross,
+        CCompiler.__init__(self, , exelist, version, for_machine, is_cross,
                            info, exe_wrapper, linker=linker,
                            full_version=full_version)
         IntelVisualStudioLikeCompiler.__init__(self, target)
@@ -528,13 +544,18 @@
         return args
 
 
+class IntelLLVMClCCompiler(IntelClCCompiler):
+
+    id = 'intel-llvm-cl'
+
+
 class ArmCCompiler(ArmCompiler, CCompiler):
-    def __init__(self, exelist: T.Liststr, version: str, for_machine: MachineChoice,
+    def __init__(self, ccache: T.Liststr, exelist: T.Liststr, version: str, for_machine: MachineChoice,
                  is_cross: bool, info: 'MachineInfo',
                  exe_wrapper: T.Optional'ExternalProgram' = None,
                  linker: T.Optional'DynamicLinker' = None,
                  full_version: T.Optionalstr = None):
-        CCompiler.__init__(self, exelist, version, for_machine, is_cross,
+        CCompiler.__init__(self, ccache, exelist, version, for_machine, is_cross,
                            info, exe_wrapper, linker=linker,
                            full_version=full_version)
         ArmCompiler.__init__(self)
@@ -555,12 +576,12 @@
 
 
 class CcrxCCompiler(CcrxCompiler, CCompiler):
-    def __init__(self, exelist: T.Liststr, version: str, for_machine: MachineChoice,
+    def __init__(self, ccache: T.Liststr, exelist: T.Liststr, version: str, for_machine: MachineChoice,
                  is_cross: bool, info: 'MachineInfo',
                  exe_wrapper: T.Optional'ExternalProgram' = None,
                  linker: T.Optional'DynamicLinker' = None,
                  full_version: T.Optionalstr = None):
-        CCompiler.__init__(self, exelist, version, for_machine, is_cross,
+        CCompiler.__init__(self, ccache, exelist, version, for_machine, is_cross,
                            info, exe_wrapper, linker=linker, full_version=full_version)
         CcrxCompiler.__init__(self)
 
@@ -606,12 +627,12 @@
 
 
 class Xc16CCompiler(Xc16Compiler, CCompiler):
-    def __init__(self, exelist: T.Liststr, version: str, for_machine: MachineChoice,
+    def __init__(self, ccache: T.Liststr, exelist: T.Liststr, version: str, for_machine: MachineChoice,
                  is_cross: bool, info: 'MachineInfo',
                  exe_wrapper: T.Optional'ExternalProgram' = None,
                  linker: T.Optional'DynamicLinker' = None,
                  full_version: T.Optionalstr = None):
-        CCompiler.__init__(self, exelist, version, for_machine, is_cross,
+        CCompiler.__init__(self, ccache, exelist, version, for_machine, is_cross,
                            info, exe_wrapper, linker=linker, full_version=full_version)
         Xc16Compiler.__init__(self)
 
@@ -651,12 +672,12 @@
         return '-I' + path
 
 class CompCertCCompiler(CompCertCompiler, CCompiler):
-    def __init__(self, exelist: T.Liststr, version: str, for_machine: MachineChoice,
+    def __init__(self, ccache: T.Liststr, exelist: T.Liststr, version: str, for_machine: MachineChoice,
                  is_cross: bool, info: 'MachineInfo',
                  exe_wrapper: T.Optional'ExternalProgram' = None,
                  linker: T.Optional'DynamicLinker' = None,
                  full_version: T.Optionalstr = None):
-        CCompiler.__init__(self, exelist, version, for_machine, is_cross,
+        CCompiler.__init__(self, ccache, exelist, version, for_machine, is_cross,
                            info, exe_wrapper, linker=linker, full_version=full_version)
         CompCertCompiler.__init__(self)
 
@@ -684,12 +705,12 @@
         return '-I' + path
 
 class TICCompiler(TICompiler, CCompiler):
-    def __init__(self, exelist: T.Liststr, version: str, for_machine: MachineChoice,
+    def __init__(self, ccache: T.Liststr, exelist: T.Liststr, version: str, for_machine: MachineChoice,
                  is_cross: bool, info: 'MachineInfo',
                  exe_wrapper: T.Optional'ExternalProgram' = None,
                  linker: T.Optional'DynamicLinker' = None,
                  full_version: T.Optionalstr = None):
-        CCompiler.__init__(self, exelist, version, for_machine, is_cross,
+        CCompiler.__init__(self, ccache, exelist, version, for_machine, is_cross,
                            info, exe_wrapper, linker=linker, full_version=full_version)
         TICompiler.__init__(self)

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/compilers/compilers.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/compilers/compilers.py Changed

@@ -11,6 +11,7 @@
 # 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.
+from __future__ import annotations
 
 import abc
 import contextlib, os.path, re
@@ -24,7 +25,7 @@
 from .. import mesonlib
 from ..mesonlib import (
     HoldableObject,
-    EnvironmentException, MachineChoice, MesonException,
+    EnvironmentException, MesonException,
     Popen_safe, LibType, TemporaryDirectoryWinProof, OptionKey,
 )
 
@@ -36,6 +37,7 @@
     from ..envconfig import MachineInfo
     from ..environment import Environment
     from ..linkers import DynamicLinker, RSPFileSyntax
+    from ..mesonlib import MachineChoice
     from ..dependencies import Dependency
 
     CompilerType = T.TypeVar('CompilerType', bound='Compiler')
@@ -45,12 +47,13 @@
 about. To support a new compiler, add its information below.
 Also add corresponding autodetection code in environment.py."""
 
-header_suffixes = ('h', 'hh', 'hpp', 'hxx', 'H', 'ipp', 'moc', 'vapi', 'di')  # type: T.Tuplestr, ...
-obj_suffixes = ('o', 'obj', 'res')  # type: T.Tuplestr, ...
+header_suffixes = {'h', 'hh', 'hpp', 'hxx', 'H', 'ipp', 'moc', 'vapi', 'di'}
+obj_suffixes = {'o', 'obj', 'res'}
 # To the emscripten compiler, .js files are libraries
-lib_suffixes = ('a', 'lib', 'dll', 'dll.a', 'dylib', 'so', 'js')  # type: T.Tuplestr, ...
+lib_suffixes = {'a', 'lib', 'dll', 'dll.a', 'dylib', 'so', 'js'}
 # Mapping of language to suffixes of files that should always be in that language
 # This means we can't include .h headers here since they could be C, C++, ObjC, etc.
+# First suffix is the language's default.
 lang_suffixes = {
     'c': ('c',),
     'cpp': ('cpp', 'cc', 'cxx', 'c++', 'hh', 'hpp', 'ipp', 'hxx', 'ino', 'ixx', 'C'),
@@ -67,23 +70,26 @@
     'swift': ('swift',),
     'java': ('java',),
     'cython': ('pyx', ),
-}  # type: T.Dictstr, T.Tuplestr, ...
+    'nasm': ('asm',),
+    'masm': ('masm',),
+}
 all_languages = lang_suffixes.keys()
-cpp_suffixes = lang_suffixes'cpp' + ('h',)  # type: T.Tuplestr, ...
-c_suffixes = lang_suffixes'c' + ('h',)  # type: T.Tuplestr, ...
+c_cpp_suffixes = {'h'}
+cpp_suffixes = set(lang_suffixes'cpp') | c_cpp_suffixes
+c_suffixes = set(lang_suffixes'c') | c_cpp_suffixes
+assembler_suffixes = {'s', 'S', 'asm', 'masm'}
+llvm_ir_suffixes = {'ll'}
+all_suffixes = set(itertools.chain(*lang_suffixes.values(), assembler_suffixes, llvm_ir_suffixes, c_cpp_suffixes))
+source_suffixes = all_suffixes - header_suffixes
 # List of languages that by default consume and output libraries following the
 # C ABI; these can generally be used interchangeably
-clib_langs = ('objcpp', 'cpp', 'objc', 'c', 'fortran',)  # type: T.Tuplestr, ...
-# List of assembler suffixes that can be linked with C code directly by the linker
-assembler_suffixes: T.Tuplestr, ... = ('s', 'S')
+# This must be sorted, see sort_clink().
+clib_langs = ('objcpp', 'cpp', 'objc', 'c', 'fortran')
 # List of languages that can be linked with C code directly by the linker
 # used in build.py:process_compilers() and build.py:get_dynamic_linker()
-clink_langs = ('d', 'cuda') + clib_langs  # type: T.Tuplestr, ...
-clink_suffixes = tuple()  # type: T.Tuplestr, ...
-for _l in clink_langs + ('vala',):
-    clink_suffixes += lang_suffixes_l
-clink_suffixes += ('h', 'll', 's')
-all_suffixes = set(itertools.chain(*lang_suffixes.values(), clink_suffixes))  # type: T.Setstr
+# This must be sorted, see sort_clink().
+clink_langs = ('d', 'cuda') + clib_langs
+
 SUFFIX_TO_LANG = dict(itertools.chain(*(
     (suffix, lang) for suffix in v for lang, v in lang_suffixes.items()))) # type: T.Dictstr, str
 
@@ -105,6 +111,7 @@
     'vala': 'VALAFLAGS',
     'rust': 'RUSTFLAGS',
     'cython': 'CYTHONFLAGS',
+    'cs': 'CSFLAGS', # This one might not be standard.
 }
 
 # All these are only for C-linkable languages; see `clink_langs` above.
@@ -130,17 +137,19 @@
     if isinstance(fname, mesonlib.File):
         fname = fname.fname
     suffix = fname.split('.')-1.lower()
-    return suffix in clink_suffixes
+    return suffix in source_suffixes
 
 def is_assembly(fname: 'mesonlib.FileOrString') -> bool:
     if isinstance(fname, mesonlib.File):
         fname = fname.fname
-    return fname.split('.')-1.lower() == 's'
+    suffix = fname.split('.')-1
+    return suffix in assembler_suffixes
 
 def is_llvm_ir(fname: 'mesonlib.FileOrString') -> bool:
     if isinstance(fname, mesonlib.File):
         fname = fname.fname
-    return fname.split('.')-1 == 'll'
+    suffix = fname.split('.')-1
+    return suffix in llvm_ir_suffixes
 
 @lru_cache(maxsize=None)
 def cached_by_name(fname: 'mesonlib.FileOrString') -> bool:
@@ -247,7 +256,8 @@
                 'winspool.lib', 'shell32.lib', 'ole32.lib', 'oleaut32.lib',
                 'uuid.lib', 'comdlg32.lib', 'advapi32.lib'  # type: T.Liststr
 
-clike_optimization_args = {'0': ,
+clike_optimization_args = {'plain': ,
+                           '0': ,
                            'g': ,
                            '1': '-O1',
                            '2': '-O2',
@@ -255,7 +265,8 @@
                            's': '-Os',
                            }  # type: T.Dictstr, T.Liststr
 
-cuda_optimization_args = {'0': ,
+cuda_optimization_args = {'plain': ,
+                          '0': ,
                           'g': '-O0',
                           '1': '-O1',
                           '2': '-O2',
@@ -272,11 +283,12 @@
 base_options: 'KeyedOptionDictType' = {
     OptionKey('b_pch'): coredata.UserBooleanOption('Use precompiled headers', True),
     OptionKey('b_lto'): coredata.UserBooleanOption('Use link time optimization', False),
-    OptionKey('b_lto'): coredata.UserBooleanOption('Use link time optimization', False),
     OptionKey('b_lto_threads'): coredata.UserIntegerOption('Use multiple threads for Link Time Optimization', (None, None, 0)),
     OptionKey('b_lto_mode'): coredata.UserComboOption('Select between different LTO modes.',
                                                       'default', 'thin',
                                                       'default'),
+    OptionKey('b_thinlto_cache'): coredata.UserBooleanOption('Use LLVM ThinLTO caching for faster incremental builds', False),
+    OptionKey('b_thinlto_cache_dir'): coredata.UserStringOption('Directory to store ThinLTO cache objects', ''),
     OptionKey('b_sanitize'): coredata.UserComboOption('Code sanitizer to use',
                                                       'none', 'address', 'thread', 'undefined', 'memory', 'leak', 'address,undefined',
                                                       'none'),
@@ -374,13 +386,19 @@
     return args
 
 def get_base_link_args(options: 'KeyedOptionDictType', linker: 'Compiler',
-                       is_shared_module: bool) -> T.Liststr:
+                       is_shared_module: bool, build_dir: str) -> T.Liststr:
     args =   # type: T.Liststr
     try:
         if optionsOptionKey('b_lto').value:
+            thinlto_cache_dir = None
+            if get_option_value(options, OptionKey('b_thinlto_cache'), False):
+                thinlto_cache_dir = get_option_value(options, OptionKey('b_thinlto_cache_dir'), '')
+                if thinlto_cache_dir == '':
+                    thinlto_cache_dir = os.path.join(build_dir, 'meson-private', 'thinlto-cache')
             args.extend(linker.get_lto_link_args(
                 threads=get_option_value(options, OptionKey('b_lto_threads'), 0),
-                mode=get_option_value(options, OptionKey('b_lto_mode'), 'default')))
+                mode=get_option_value(options, OptionKey('b_lto_mode'), 'default'),
+                thinlto_cache_dir=thinlto_cache_dir))
     except KeyError:
         pass
     try:
@@ -450,22 +468,18 @@
     """The result of Compiler.compiles (and friends)."""
 
     def __init__(self, stdo: T.Optionalstr = None, stde: T.Optionalstr = None,
-                 args: T.OptionalT.Liststr = None,
-                 returncode: int = 999, pid: int = -1,
-                 text_mode: bool = True,
+                 command: T.OptionalT.Liststr = None,
+                 returncode: int = 999,
                  input_name: T.Optionalstr = None,
                  output_name: T.Optionalstr = None,
-                 command: T.OptionalT.Liststr = None, cached: bool = False):
+                 cached: bool = False):
         self.stdout = stdo
         self.stderr = stde
         self.input_name = input_name
         self.output_name = output_name
         self.command = command or 
-        self.args = args or 
         self.cached = cached
         self.returncode = returncode
-        self.pid = pid
-        self.text_mode = text_mode
 
 
 class Compiler(HoldableObject, metaclass=abc.ABCMeta):
@@ -482,12 +496,14 @@
     language: str
     id: str
     warn_args: T.Dictstr, T.Liststr
+    mode: str = 'COMPILER'
 
-    def __init__(self, exelist: T.Liststr, version: str,
+    def __init__(self, ccache: T.Liststr, exelist: T.Liststr, version: str,
                  for_machine: MachineChoice, info: 'MachineInfo',
                  linker: T.Optional'DynamicLinker' = None,
                  full_version: T.Optionalstr = None, is_cross: bool = False):
-        self.exelist = exelist
+        self.exelist = ccache + exelist
+        self.exelist_no_ccache = exelist
         # In case it's been overridden by a child class already
         if not hasattr(self, 'file_suffixes'):
             self.file_suffixes = lang_suffixesself.language
@@ -501,6 +517,7 @@
         self.linker = linker
         self.info = info
         self.is_cross = is_cross
+        self.modes: T.ListCompiler = 
 
     def __repr__(self) -> str:
         repr_str = "<{0}: v{1} `{2}`>"
@@ -519,6 +536,9 @@
     def get_id(self) -> str:
         return self.id
 
+    def get_modes(self) -> T.ListCompiler:
+        return self.modes
+
     def get_linker_id(self) -> str:
         # There is not guarantee that we have a dynamic linker instance, as
         # some languages don't have separate linkers and compilers. In those
@@ -574,8 +594,8 @@
     def symbols_have_underscore_prefix(self, env: 'Environment') -> bool:
         raise EnvironmentException('%s does not support symbols_have_underscore_prefix ' % self.get_id())
 
-    def get_exelist(self) -> T.Liststr:
-        return self.exelist.copy()
+    def get_exelist(self, ccache: bool = True) -> T.Liststr:
+        return self.exelist.copy() if ccache else self.exelist_no_ccache.copy()
 
     def get_linker_exelist(self) -> T.Liststr:
         return self.linker.get_exelist()
@@ -691,7 +711,7 @@
         raise EnvironmentException('Language %s does not support function checks.' % self.get_display_language())
 
     @classmethod
-    def _unix_args_to_native(cls, args: T.Liststr, info: 'MachineInfo') -> T.Liststr:
+    def _unix_args_to_native(cls, args: T.Liststr, info: MachineInfo) -> T.Liststr:
         "Always returns a copy that can be independently mutated"
         return args.copy()
 
@@ -796,7 +816,7 @@
             if extra_args:
                 commands += extra_args
             # Generate full command-line with the exelist
-            command_list = self.get_exelist() + commands.to_native()
+            command_list = self.get_exelist(ccache=not no_ccache) + commands.to_native()
             mlog.debug('Running compile:')
             mlog.debug('Working directory: ', tmpdirname)
             mlog.debug('Command line: ', ' '.join(command_list), '\n')
@@ -809,7 +829,7 @@
             mlog.debug('Compiler stdout:\n', stdo)
             mlog.debug('Compiler stderr:\n', stde)
 
-            result = CompileResult(stdo, stde, list(commands), p.returncode, p.pid, input_name=srcname)
+            result = CompileResult(stdo, stde, command_list, p.returncode, input_name=srcname)
             if want_output:
                 result.output_name = output
             yield result
@@ -827,7 +847,7 @@
 
         # Check if not cached, and generate, otherwise get from the cache
         if key in cdata.compiler_check_cache:
-            p = cdata.compiler_check_cachekey  # type: CompileResult
+            p = cdata.compiler_check_cachekey
             p.cached = True
             mlog.debug('Using cached compile:')
             mlog.debug('Cached command line: ', ' '.join(p.command), '\n')
@@ -970,7 +990,8 @@
     def get_lto_compile_args(self, *, threads: int = 0, mode: str = 'default') -> T.Liststr:
         return 
 
-    def get_lto_link_args(self, *, threads: int = 0, mode: str = 'default') -> T.Liststr:
+    def get_lto_link_args(self, *, threads: int = 0, mode: str = 'default',
+                          thinlto_cache_dir: T.Optionalstr = None) -> T.Liststr:
         return self.linker.get_lto_args()
 
     def sanitizer_compile_args(self, value: str) -> T.Liststr:
@@ -1037,6 +1058,9 @@
     def get_preprocess_only_args(self) -> T.Liststr:
         raise EnvironmentException('This compiler does not have a preprocessor')
 
+    def get_preprocess_to_file_args(self) -> T.Liststr:
+        return self.get_preprocess_only_args()
+
     def get_default_include_dirs(self) -> T.Liststr:
         # TODO: This is a candidate for returning an immutable list
         return 
@@ -1125,7 +1149,7 @@
     def get_include_args(self, path: str, is_system: bool) -> T.Liststr:
         return 
 
-    def depfile_for_object(self, objfile: str) -> str:
+    def depfile_for_object(self, objfile: str) -> T.Optionalstr:
         return objfile + '.' + self.get_depfile_suffix()
 
     def get_depfile_suffix(self) -> str:
@@ -1277,6 +1301,10 @@
     def needs_static_linker(self) -> bool:
         raise NotImplementedError(f'There is no static linker for {self.language}')
 
+    def get_preprocessor(self) -> Compiler:
+        """Get compiler's preprocessor.
+        """
+        raise EnvironmentException(f'{self.get_id()} does not support preprocessor')
 
 def get_global_options(lang: str,
                        comp: T.TypeCompiler,

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/compilers/cpp.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/compilers/cpp.py Changed

@@ -11,6 +11,7 @@
 # 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.
+from __future__ import annotations
 
 import copy
 import functools
@@ -19,13 +20,12 @@
 
 from .. import coredata
 from .. import mlog
-from ..mesonlib import MesonException, MachineChoice, version_compare, OptionKey
+from ..mesonlib import MesonException, version_compare, OptionKey
 
 from .compilers import (
     gnu_winlibs,
     msvc_winlibs,
     Compiler,
-    CompileCheckMode,
 )
 from .c_function_attributes import CXX_FUNC_ATTRIBUTES, C_FUNC_ATTRIBUTES
 from .mixins.clike import CLikeCompiler
@@ -33,7 +33,7 @@
 from .mixins.ti import TICompiler
 from .mixins.arm import ArmCompiler, ArmclangCompiler
 from .mixins.visualstudio import MSVCCompiler, ClangClCompiler
-from .mixins.gnu import GnuCompiler
+from .mixins.gnu import GnuCompiler, gnu_common_warning_args, gnu_cpp_warning_args
 from .mixins.intel import IntelGnuLikeCompiler, IntelVisualStudioLikeCompiler
 from .mixins.clang import ClangCompiler
 from .mixins.elbrus import ElbrusCompiler
@@ -41,11 +41,13 @@
 from .mixins.emscripten import EmscriptenMixin
 
 if T.TYPE_CHECKING:
+    from .compilers import CompileCheckMode
     from ..coredata import MutableKeyedOptionDictType, KeyedOptionDictType
     from ..dependencies import Dependency
     from ..envconfig import MachineInfo
     from ..environment import Environment
     from ..linkers import DynamicLinker
+    from ..mesonlib import MachineChoice
     from ..programs import ExternalProgram
     CompilerMixinBase = CLikeCompiler
 else:
@@ -55,7 +57,7 @@
 def non_msvc_eh_options(eh: str, args: T.Liststr) -> None:
     if eh == 'none':
         args.append('-fno-exceptions')
-    elif eh == 's' or eh == 'c':
+    elif eh in {'s', 'c'}:
         mlog.warning('non-MSVC compilers do not support ' + eh + ' exception handling.' +
                      'You may want to set eh to \'default\'.')
 
@@ -68,12 +70,12 @@
 
     language = 'cpp'
 
-    def __init__(self, exelist: T.Liststr, version: str, for_machine: MachineChoice, is_cross: bool,
+    def __init__(self, ccache: T.Liststr, exelist: T.Liststr, version: str, for_machine: MachineChoice, is_cross: bool,
                  info: 'MachineInfo', exe_wrapper: T.Optional'ExternalProgram' = None,
                  linker: T.Optional'DynamicLinker' = None,
                  full_version: T.Optionalstr = None):
         # If a child ObjCPP class has already set it, don't set it ourselves
-        Compiler.__init__(self, exelist, version, for_machine, info,
+        Compiler.__init__(self, ccache, exelist, version, for_machine, info,
                           is_cross=is_cross, linker=linker,
                           full_version=full_version)
         CLikeCompiler.__init__(self, exe_wrapper)
@@ -153,7 +155,7 @@
         }
 
         # Currently, remapping is only supported for Clang, Elbrus and GCC
-        assert self.id in frozenset('clang', 'lcc', 'gcc', 'emscripten', 'armltdclang')
+        assert self.id in frozenset('clang', 'lcc', 'gcc', 'emscripten', 'armltdclang', 'intel-llvm')
 
         if cpp_std not in CPP_FALLBACKS:
             # 'c++03' and 'c++98' don't have fallback types
@@ -180,19 +182,20 @@
 
 
 class ClangCPPCompiler(ClangCompiler, CPPCompiler):
-    def __init__(self, exelist: T.Liststr, version: str, for_machine: MachineChoice, is_cross: bool,
+    def __init__(self, ccache: T.Liststr, exelist: T.Liststr, version: str, for_machine: MachineChoice, is_cross: bool,
                  info: 'MachineInfo', exe_wrapper: T.Optional'ExternalProgram' = None,
                  linker: T.Optional'DynamicLinker' = None,
                  defines: T.OptionalT.Dictstr, str = None,
                  full_version: T.Optionalstr = None):
-        CPPCompiler.__init__(self, exelist, version, for_machine, is_cross,
+        CPPCompiler.__init__(self, ccache, exelist, version, for_machine, is_cross,
                              info, exe_wrapper, linker=linker, full_version=full_version)
         ClangCompiler.__init__(self, defines)
-        default_warn_args = '-Wall', '-Winvalid-pch', '-Wnon-virtual-dtor'
+        default_warn_args = '-Wall', '-Winvalid-pch'
         self.warn_args = {'0': ,
                           '1': default_warn_args,
                           '2': default_warn_args + '-Wextra',
-                          '3': default_warn_args + '-Wextra', '-Wpedantic'}
+                          '3': default_warn_args + '-Wextra', '-Wpedantic',
+                          'everything': '-Weverything'}
 
     def get_options(self) -> 'MutableKeyedOptionDictType':
         opts = CPPCompiler.get_options(self)
@@ -276,14 +279,16 @@
 
     id = 'emscripten'
 
-    def __init__(self, exelist: T.Liststr, version: str, for_machine: MachineChoice, is_cross: bool,
+    def __init__(self, ccache: T.Liststr, exelist: T.Liststr, version: str, for_machine: MachineChoice, is_cross: bool,
                  info: 'MachineInfo', exe_wrapper: T.Optional'ExternalProgram' = None,
                  linker: T.Optional'DynamicLinker' = None,
                  defines: T.OptionalT.Dictstr, str = None,
                  full_version: T.Optionalstr = None):
         if not is_cross:
             raise MesonException('Emscripten compiler can only be used for cross compilation.')
-        ClangCPPCompiler.__init__(self, exelist, version, for_machine, is_cross,
+        if not version_compare(version, '>=1.39.19'):
+            raise MesonException('Meson requires Emscripten >= 1.39.19')
+        ClangCPPCompiler.__init__(self, ccache, exelist, version, for_machine, is_cross,
                                   info, exe_wrapper=exe_wrapper, linker=linker,
                                   defines=defines, full_version=full_version)
 
@@ -301,18 +306,19 @@
     Keil armclang
     '''
 
-    def __init__(self, exelist: T.Liststr, version: str, for_machine: MachineChoice, is_cross: bool,
+    def __init__(self, ccache: T.Liststr, exelist: T.Liststr, version: str, for_machine: MachineChoice, is_cross: bool,
                  info: 'MachineInfo', exe_wrapper: T.Optional'ExternalProgram' = None,
                  linker: T.Optional'DynamicLinker' = None,
                  full_version: T.Optionalstr = None):
-        CPPCompiler.__init__(self, exelist, version, for_machine, is_cross,
+        CPPCompiler.__init__(self, ccache, exelist, version, for_machine, is_cross,
                              info, exe_wrapper, linker=linker, full_version=full_version)
         ArmclangCompiler.__init__(self)
-        default_warn_args = '-Wall', '-Winvalid-pch', '-Wnon-virtual-dtor'
+        default_warn_args = '-Wall', '-Winvalid-pch'
         self.warn_args = {'0': ,
                           '1': default_warn_args,
                           '2': default_warn_args + '-Wextra',
-                          '3': default_warn_args + '-Wextra', '-Wpedantic'}
+                          '3': default_warn_args + '-Wextra', '-Wpedantic',
+                          'everything': '-Weverything'}
 
     def get_options(self) -> 'MutableKeyedOptionDictType':
         opts = CPPCompiler.get_options(self)
@@ -346,19 +352,22 @@
 
 
 class GnuCPPCompiler(GnuCompiler, CPPCompiler):
-    def __init__(self, exelist: T.Liststr, version: str, for_machine: MachineChoice, is_cross: bool,
+    def __init__(self, ccache: T.Liststr, exelist: T.Liststr, version: str, for_machine: MachineChoice, is_cross: bool,
                  info: 'MachineInfo', exe_wrapper: T.Optional'ExternalProgram' = None,
                  linker: T.Optional'DynamicLinker' = None,
                  defines: T.OptionalT.Dictstr, str = None,
                  full_version: T.Optionalstr = None):
-        CPPCompiler.__init__(self, exelist, version, for_machine, is_cross,
+        CPPCompiler.__init__(self, ccache, exelist, version, for_machine, is_cross,
                              info, exe_wrapper, linker=linker, full_version=full_version)
         GnuCompiler.__init__(self, defines)
-        default_warn_args = '-Wall', '-Winvalid-pch', '-Wnon-virtual-dtor'
+        default_warn_args = '-Wall', '-Winvalid-pch'
         self.warn_args = {'0': ,
                           '1': default_warn_args,
                           '2': default_warn_args + '-Wextra',
-                          '3': default_warn_args + '-Wextra', '-Wpedantic'}
+                          '3': default_warn_args + '-Wextra', '-Wpedantic',
+                          'everything': (default_warn_args + '-Wextra', '-Wpedantic' +
+                                         self.supported_warn_args(gnu_common_warning_args) +
+                                         self.supported_warn_args(gnu_cpp_warning_args))}
 
     def get_options(self) -> 'MutableKeyedOptionDictType':
         key = OptionKey('std', machine=self.for_machine, lang=self.language)
@@ -431,11 +440,11 @@
 
 
 class PGICPPCompiler(PGICompiler, CPPCompiler):
-    def __init__(self, exelist: T.Liststr, version: str, for_machine: MachineChoice, is_cross: bool,
+    def __init__(self, ccache: T.Liststr, exelist: T.Liststr, version: str, for_machine: MachineChoice, is_cross: bool,
                  info: 'MachineInfo', exe_wrapper: T.Optional'ExternalProgram' = None,
                  linker: T.Optional'DynamicLinker' = None,
                  full_version: T.Optionalstr = None):
-        CPPCompiler.__init__(self, exelist, version, for_machine, is_cross,
+        CPPCompiler.__init__(self, ccache, exelist, version, for_machine, is_cross,
                              info, exe_wrapper, linker=linker, full_version=full_version)
         PGICompiler.__init__(self)
 
@@ -444,22 +453,22 @@
 
     id = 'nvidia_hpc'
 
-    def __init__(self, exelist: T.Liststr, version: str, for_machine: MachineChoice, is_cross: bool,
+    def __init__(self, ccache: T.Liststr, exelist: T.Liststr, version: str, for_machine: MachineChoice, is_cross: bool,
                  info: 'MachineInfo', exe_wrapper: T.Optional'ExternalProgram' = None,
                  linker: T.Optional'DynamicLinker' = None,
                  full_version: T.Optionalstr = None):
-        CPPCompiler.__init__(self, exelist, version, for_machine, is_cross,
+        CPPCompiler.__init__(self, ccache, exelist, version, for_machine, is_cross,
                              info, exe_wrapper, linker=linker, full_version=full_version)
         PGICompiler.__init__(self)
 
 
 class ElbrusCPPCompiler(ElbrusCompiler, CPPCompiler):
-    def __init__(self, exelist: T.Liststr, version: str, for_machine: MachineChoice, is_cross: bool,
+    def __init__(self, ccache: T.Liststr, exelist: T.Liststr, version: str, for_machine: MachineChoice, is_cross: bool,
                  info: 'MachineInfo', exe_wrapper: T.Optional'ExternalProgram' = None,
                  linker: T.Optional'DynamicLinker' = None,
                  defines: T.OptionalT.Dictstr, str = None,
                  full_version: T.Optionalstr = None):
-        CPPCompiler.__init__(self, exelist, version, for_machine, is_cross,
+        CPPCompiler.__init__(self, ccache, exelist, version, for_machine, is_cross,
                              info, exe_wrapper, linker=linker, full_version=full_version)
         ElbrusCompiler.__init__(self)
 
@@ -525,20 +534,20 @@
 
 
 class IntelCPPCompiler(IntelGnuLikeCompiler, CPPCompiler):
-    def __init__(self, exelist: T.Liststr, version: str, for_machine: MachineChoice, is_cross: bool,
+    def __init__(self, ccache: T.Liststr, exelist: T.Liststr, version: str, for_machine: MachineChoice, is_cross: bool,
                  info: 'MachineInfo', exe_wrapper: T.Optional'ExternalProgram' = None,
                  linker: T.Optional'DynamicLinker' = None,
                  full_version: T.Optionalstr = None):
-        CPPCompiler.__init__(self, exelist, version, for_machine, is_cross,
+        CPPCompiler.__init__(self, ccache, exelist, version, for_machine, is_cross,
                              info, exe_wrapper, linker=linker, full_version=full_version)
         IntelGnuLikeCompiler.__init__(self)
         self.lang_header = 'c++-header'
-        default_warn_args = '-Wall', '-w3', '-diag-disable:remark',
-                             '-Wpch-messages', '-Wnon-virtual-dtor'
+        default_warn_args = '-Wall', '-w3', '-Wpch-messages'
         self.warn_args = {'0': ,
-                          '1': default_warn_args,
-                          '2': default_warn_args + '-Wextra',
-                          '3': default_warn_args + '-Wextra'}
+                          '1': default_warn_args + '-diag-disable:remark',
+                          '2': default_warn_args + '-Wextra', '-diag-disable:remark',
+                          '3': default_warn_args + '-Wextra', '-diag-disable:remark',
+                          'everything': default_warn_args + '-Wextra'}
 
     def get_options(self) -> 'MutableKeyedOptionDictType':
         opts = CPPCompiler.get_options(self)
@@ -593,6 +602,11 @@
         return 
 
 
+class IntelLLVMCPPCompiler(ClangCPPCompiler):
+
+    id = 'intel-llvm'
+
+
 class VisualStudioLikeCPPCompilerMixin(CompilerMixinBase):
 
     """Mixin for C++ specific method overrides in MSVC-like compilers."""
@@ -694,15 +708,21 @@
 
     id = 'msvc'
 
-    def __init__(self, exelist: T.Liststr, version: str, for_machine: MachineChoice,
+    def __init__(self, ccache: T.Liststr, exelist: T.Liststr, version: str, for_machine: MachineChoice,
                  is_cross: bool, info: 'MachineInfo', target: str,
                  exe_wrapper: T.Optional'ExternalProgram' = None,
                  linker: T.Optional'DynamicLinker' = None,
                  full_version: T.Optionalstr = None):
-        CPPCompiler.__init__(self, exelist, version, for_machine, is_cross,
+        CPPCompiler.__init__(self, ccache, exelist, version, for_machine, is_cross,
                              info, exe_wrapper, linker=linker, full_version=full_version)
         MSVCCompiler.__init__(self, target)
 
+        # By default, MSVC has a broken __cplusplus define that pretends to be c++98:
+        # https://docs.microsoft.com/en-us/cpp/build/reference/zc-cplusplus?view=msvc-160
+        # Pass the flag to enable a truthful define, if possible.
+        if version_compare(self.version, '>= 19.14.26428'):
+            self.always_args = self.always_args + '/Zc:__cplusplus'
+
     def get_options(self) -> 'MutableKeyedOptionDictType':
         cpp_stds = 'none', 'c++11', 'vc++11'
         # Visual Studio 2015 and later
@@ -732,16 +752,6 @@
             del argsi
         return args
 
-    def get_always_args(self) -> T.Liststr:
-        args = super().get_always_args()
-
-        # By default, MSVC has a broken __cplusplus define that pretends to be c++98:
-        # https://docs.microsoft.com/en-us/cpp/build/reference/zc-cplusplus?view=msvc-160
-        # Pass the flag to enable a truthful define, if possible.
-        if version_compare(self.version, '>= 15.7') and '/Zc:__cplusplus' not in args:
-            return args + '/Zc:__cplusplus'
-        return args
-
 class ClangClCPPCompiler(CPP11AsCPP14Mixin, VisualStudioLikeCPPCompilerMixin, ClangClCompiler, CPPCompiler):
 
     id = 'clang-cl'
@@ -751,12 +761,12 @@
                  exe_wrapper: T.Optional'ExternalProgram' = None,
                  linker: T.Optional'DynamicLinker' = None,
                  full_version: T.Optionalstr = None):
-        CPPCompiler.__init__(self, exelist, version, for_machine, is_cross,
+        CPPCompiler.__init__(self, , exelist, version, for_machine, is_cross,
                              info, exe_wrapper, linker=linker, full_version=full_version)
         ClangClCompiler.__init__(self, target)
 
     def get_options(self) -> 'MutableKeyedOptionDictType':
-        cpp_stds = 'none', 'c++11', 'vc++11', 'c++14', 'vc++14', 'c++17', 'vc++17', 'c++latest'
+        cpp_stds = 'none', 'c++11', 'vc++11', 'c++14', 'vc++14', 'c++17', 'vc++17', 'c++20', 'vc++20', 'c++latest'
         return self._get_options_impl(super().get_options(), cpp_stds)
 
 
@@ -767,7 +777,7 @@
                  exe_wrapper: T.Optional'ExternalProgram' = None,
                  linker: T.Optional'DynamicLinker' = None,
                  full_version: T.Optionalstr = None):
-        CPPCompiler.__init__(self, exelist, version, for_machine, is_cross,
+        CPPCompiler.__init__(self, , exelist, version, for_machine, is_cross,
                              info, exe_wrapper, linker=linker, full_version=full_version)
         IntelVisualStudioLikeCompiler.__init__(self, target)
 
@@ -781,12 +791,17 @@
         return IntelVisualStudioLikeCompiler.get_compiler_check_args(self, mode)
 
 
+class IntelLLVMClCPPCompiler(IntelClCPPCompiler):
+
+    id = 'intel-llvm-cl'
+
+
 class ArmCPPCompiler(ArmCompiler, CPPCompiler):
-    def __init__(self, exelist: T.Liststr, version: str, for_machine: MachineChoice, is_cross: bool,
+    def __init__(self, ccache: T.Liststr, exelist: T.Liststr, version: str, for_machine: MachineChoice, is_cross: bool,
                  info: 'MachineInfo', exe_wrapper: T.Optional'ExternalProgram' = None,
                  linker: T.Optional'DynamicLinker' = None,
                  full_version: T.Optionalstr = None):
-        CPPCompiler.__init__(self, exelist, version, for_machine, is_cross,
+        CPPCompiler.__init__(self, ccache, exelist, version, for_machine, is_cross,
                              info, exe_wrapper, linker=linker, full_version=full_version)
         ArmCompiler.__init__(self)
 
@@ -814,11 +829,11 @@
 
 
 class CcrxCPPCompiler(CcrxCompiler, CPPCompiler):
-    def __init__(self, exelist: T.Liststr, version: str, for_machine: MachineChoice, is_cross: bool,
+    def __init__(self, ccache: T.Liststr, exelist: T.Liststr, version: str, for_machine: MachineChoice, is_cross: bool,
                  info: 'MachineInfo', exe_wrapper: T.Optional'ExternalProgram' = None,
                  linker: T.Optional'DynamicLinker' = None,
                  full_version: T.Optionalstr = None):
-        CPPCompiler.__init__(self, exelist, version, for_machine, is_cross,
+        CPPCompiler.__init__(self, ccache, exelist, version, for_machine, is_cross,
                              info, exe_wrapper, linker=linker, full_version=full_version)
         CcrxCompiler.__init__(self)
 
@@ -842,11 +857,11 @@
         return 
 
 class TICPPCompiler(TICompiler, CPPCompiler):
-    def __init__(self, exelist: T.Liststr, version: str, for_machine: MachineChoice, is_cross: bool,
+    def __init__(self, ccache: T.Liststr, exelist: T.Liststr, version: str, for_machine: MachineChoice, is_cross: bool,
                  info: 'MachineInfo', exe_wrapper: T.Optional'ExternalProgram' = None,
                  linker: T.Optional'DynamicLinker' = None,
                  full_version: T.Optionalstr = None):
-        CPPCompiler.__init__(self, exelist, version, for_machine, is_cross,
+        CPPCompiler.__init__(self, ccache, exelist, version, for_machine, is_cross,
                              info, exe_wrapper, linker=linker, full_version=full_version)
         TICompiler.__init__(self)

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/compilers/cs.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/compilers/cs.py Changed

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/compilers/cuda.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/compilers/cuda.py Changed

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/compilers/cython.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/compilers/cython.py Changed

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/compilers/d.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/compilers/d.py Changed

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/compilers/detect.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/compilers/detect.py Changed

@@ -14,123 +14,13 @@
 from __future__ import annotations
 
 from ..mesonlib import (
-    MesonException, EnvironmentException, join_args,
+    MesonException, EnvironmentException, MachineChoice, join_args,
     search_version, is_windows, Popen_safe, windows_proof_rm,
 )
 from ..envconfig import BinaryTable
 from .. import mlog
 
-from ..linkers import (
-    guess_win_linker,
-    guess_nix_linker,
-    AIXArLinker,
-    ArLinker,
-    ArmarLinker,
-    ArmClangDynamicLinker,
-    ArmDynamicLinker,
-    CcrxLinker,
-    CcrxDynamicLinker,
-    CompCertLinker,
-    CompCertDynamicLinker,
-    C2000Linker,
-    C2000DynamicLinker,
-    TILinker,
-    TIDynamicLinker,
-    DLinker,
-    NAGDynamicLinker,
-    NvidiaHPC_DynamicLinker,
-    PGIDynamicLinker,
-    PGIStaticLinker,
-    Xc16Linker,
-    Xc16DynamicLinker,
-    XilinkDynamicLinker,
-    CudaLinker,
-    IntelVisualStudioLinker,
-    VisualStudioLinker,
-    VisualStudioLikeLinkerMixin,
-    WASMDynamicLinker,
-)
-from .c import (
-    AppleClangCCompiler,
-    ArmCCompiler,
-    ArmclangCCompiler,
-    ArmLtdClangCCompiler,
-    ClangCCompiler,
-    ClangClCCompiler,
-    GnuCCompiler,
-    ElbrusCCompiler,
-    EmscriptenCCompiler,
-    IntelCCompiler,
-    IntelClCCompiler,
-    NvidiaHPC_CCompiler,
-    PGICCompiler,
-    CcrxCCompiler,
-    Xc16CCompiler,
-    CompCertCCompiler,
-    C2000CCompiler,
-    TICCompiler,
-    VisualStudioCCompiler,
-)
-from .cpp import (
-    AppleClangCPPCompiler,
-    ArmCPPCompiler,
-    ArmclangCPPCompiler,
-    ArmLtdClangCPPCompiler,
-    ClangCPPCompiler,
-    ClangClCPPCompiler,
-    GnuCPPCompiler,
-    ElbrusCPPCompiler,
-    EmscriptenCPPCompiler,
-    IntelCPPCompiler,
-    IntelClCPPCompiler,
-    NvidiaHPC_CPPCompiler,
-    PGICPPCompiler,
-    CcrxCPPCompiler,
-    C2000CPPCompiler,
-    TICPPCompiler,
-    VisualStudioCPPCompiler,
-)
-from .cs import MonoCompiler, VisualStudioCsCompiler
-from .d import (
-    DCompiler,
-    DmdDCompiler,
-    GnuDCompiler,
-    LLVMDCompiler,
-)
-from .cuda import CudaCompiler
-from .fortran import (
-    ArmLtdFlangFortranCompiler,
-    G95FortranCompiler,
-    GnuFortranCompiler,
-    ElbrusFortranCompiler,
-    FlangFortranCompiler,
-    IntelFortranCompiler,
-    IntelClFortranCompiler,
-    NAGFortranCompiler,
-    Open64FortranCompiler,
-    PathScaleFortranCompiler,
-    NvidiaHPC_FortranCompiler,
-    PGIFortranCompiler,
-    SunFortranCompiler,
-)
-from .java import JavaCompiler
-from .objc import (
-    AppleClangObjCCompiler,
-    ClangObjCCompiler,
-    GnuObjCCompiler,
-)
-from .objcpp import (
-    AppleClangObjCPPCompiler,
-    ClangObjCPPCompiler,
-    GnuObjCPPCompiler,
-)
-from .cython import CythonCompiler
-from .rust import RustCompiler, ClippyRustCompiler
-from .swift import SwiftCompiler
-from .vala import ValaCompiler
-from .mixins.visualstudio import VisualStudioLikeCompiler
-from .mixins.gnu import GnuCompiler
-from .mixins.clang import ClangCompiler
+from ..linkers import guess_win_linker, guess_nix_linker
 
 import subprocess
 import platform
@@ -145,11 +35,9 @@
     from .c import CCompiler
     from .cpp import CPPCompiler
     from .fortran import FortranCompiler
-    from .objc import ObjCCompiler
-    from .objcpp import ObjCPPCompiler
+    from .rust import RustCompiler
     from ..linkers import StaticLinker
     from ..environment import Environment
-    from ..mesonlib import MachineChoice
     from ..programs import ExternalProgram
 
 
@@ -180,11 +68,11 @@
         defaults'objc' = 'clang'
         defaults'objcpp' = 'clang++'
     else:
-        defaults'c' = 'cc', 'gcc', 'clang', 'nvc', 'pgcc', 'icc'
-        defaults'cpp' = 'c++', 'g++', 'clang++', 'nvc++', 'pgc++', 'icpc'
+        defaults'c' = 'cc', 'gcc', 'clang', 'nvc', 'pgcc', 'icc', 'icx'
+        defaults'cpp' = 'c++', 'g++', 'clang++', 'nvc++', 'pgc++', 'icpc', 'icpx'
         defaults'objc' = 'cc', 'gcc', 'clang'
         defaults'objcpp' = 'c++', 'g++', 'clang++'
-    defaults'fortran' = 'gfortran', 'flang', 'nvfortran', 'pgfortran', 'ifort', 'g95'
+    defaults'fortran' = 'gfortran', 'flang', 'nvfortran', 'pgfortran', 'ifort', 'ifx', 'g95'
     defaults'cs' = 'mcs', 'csc'
 defaults'd' = 'ldc2', 'ldc', 'gdc', 'dmd'
 defaults'java' = 'javac'
@@ -200,6 +88,7 @@
 defaults'cuda_static_linker' = 'nvlink'
 defaults'gcc_static_linker' = 'gcc-ar'
 defaults'clang_static_linker' = 'llvm-ar'
+defaults'nasm' = 'nasm', 'yasm'
 
 
 def compiler_from_language(env: 'Environment', lang: str, for_machine: MachineChoice) -> T.OptionalCompiler:
@@ -217,6 +106,8 @@
         'fortran': detect_fortran_compiler,
         'swift': detect_swift_compiler,
         'cython': detect_cython_compiler,
+        'nasm': detect_nasm_compiler,
+        'masm': detect_masm_compiler,
     }
     return lang_maplang(env, for_machine) if lang in lang_map else None
 
@@ -270,36 +161,38 @@
 # ===============
 
 def detect_static_linker(env: 'Environment', compiler: Compiler) -> StaticLinker:
+    from . import d
+    from ..linkers import linkers
     linker = env.lookup_binary_entry(compiler.for_machine, 'ar')
     if linker is not None:
-        linkers = linker
+        trials = linker
     else:
         default_linkers = l for l in defaults'static_linker'
-        if isinstance(compiler, CudaCompiler):
-            linkers = defaults'cuda_static_linker' + default_linkers
-        elif isinstance(compiler, VisualStudioLikeCompiler):
-            linkers = defaults'vs_static_linker', defaults'clang_cl_static_linker'
-        elif isinstance(compiler, GnuCompiler):
+        if compiler.language == 'cuda':
+            trials = defaults'cuda_static_linker' + default_linkers
+        elif compiler.get_argument_syntax() == 'msvc':
+            trials = defaults'vs_static_linker', defaults'clang_cl_static_linker'
+        elif compiler.id == 'gcc':
             # Use gcc-ar if available; needed for LTO
-            linkers = defaults'gcc_static_linker' + default_linkers
-        elif isinstance(compiler, ClangCompiler):
+            trials = defaults'gcc_static_linker' + default_linkers
+        elif compiler.id == 'clang':
             # Use llvm-ar if available; needed for LTO
-            linkers = defaults'clang_static_linker' + default_linkers
-        elif isinstance(compiler, DCompiler):
+            trials = defaults'clang_static_linker' + default_linkers
+        elif compiler.language == 'd':
             # Prefer static linkers over linkers used by D compilers
             if is_windows():
-                linkers = defaults'vs_static_linker', defaults'clang_cl_static_linker', compiler.get_linker_exelist()
+                trials = defaults'vs_static_linker', defaults'clang_cl_static_linker', compiler.get_linker_exelist()
             else:
-                linkers = default_linkers
-        elif isinstance(compiler, IntelClCCompiler):
+                trials = default_linkers
+        elif compiler.id == 'intel-cl' and compiler.language == 'c': # why not cpp? Is this a bug?
             # Intel has it's own linker that acts like microsoft's lib
-            linkers = 'xilib'
-        elif isinstance(compiler, (PGICCompiler, PGIFortranCompiler)) and is_windows():
-            linkers = 'ar'  # For PGI on Windows, "ar" is just a wrapper calling link/lib.
+            trials = 'xilib'
+        elif is_windows() and compiler.id == 'pgi': # this handles cpp / nvidia HPC, in addition to just c/fortran
+            trials = 'ar'  # For PGI on Windows, "ar" is just a wrapper calling link/lib.
         else:
-            linkers = default_linkers
+            trials = default_linkers
     popen_exceptions = {}
-    for linker in linkers:
+    for linker in trials:
         linker_name = os.path.basename(linker0)
 
         if any(os.path.basename(x) in {'lib', 'lib.exe', 'llvm-lib', 'llvm-lib.exe', 'xilib', 'xilib.exe'} for x in linker):
@@ -314,42 +207,43 @@
             popen_exceptionsjoin_args(linker + arg) = e
             continue
         if "xilib: executing 'lib'" in err:
-            return IntelVisualStudioLinker(linker, getattr(compiler, 'machine', None))
+            return linkers.IntelVisualStudioLinker(linker, getattr(compiler, 'machine', None))
         if '/OUT:' in out.upper() or '/OUT:' in err.upper():
-            return VisualStudioLinker(linker, getattr(compiler, 'machine', None))
+            return linkers.VisualStudioLinker(linker, getattr(compiler, 'machine', None))
         if 'ar-Error-Unknown switch: --version' in err:
-            return PGIStaticLinker(linker)
+            return linkers.PGIStaticLinker(linker)
         if p.returncode == 0 and 'armar' in linker_name:
-            return ArmarLinker(linker)
+            return linkers.ArmarLinker(linker)
         if 'DMD32 D Compiler' in out or 'DMD64 D Compiler' in out:
-            assert isinstance(compiler, DCompiler)
-            return DLinker(linker, compiler.arch)
+            assert isinstance(compiler, d.DCompiler)
+            return linkers.DLinker(linker, compiler.arch)
         if 'LDC - the LLVM D compiler' in out:
-            assert isinstance(compiler, DCompiler)
-            return DLinker(linker, compiler.arch, rsp_syntax=compiler.rsp_file_syntax())
+            assert isinstance(compiler, d.DCompiler)
+            return linkers.DLinker(linker, compiler.arch, rsp_syntax=compiler.rsp_file_syntax())
         if 'GDC' in out and ' based on D ' in out:
-            assert isinstance(compiler, DCompiler)
-            return DLinker(linker, compiler.arch)
+            assert isinstance(compiler, d.DCompiler)
+            return linkers.DLinker(linker, compiler.arch)
         if err.startswith('Renesas') and 'rlink' in linker_name:
-            return CcrxLinker(linker)
+            return linkers.CcrxLinker(linker)
         if out.startswith('GNU ar') and 'xc16-ar' in linker_name:
-            return Xc16Linker(linker)
+            return linkers.Xc16Linker(linker)
         if 'Texas Instruments Incorporated' in out:
             if 'ar2000' in linker_name:
-                return C2000Linker(linker)
+                return linkers.C2000Linker(linker)
             else:
-                return TILinker(linker)
+                return linkers.TILinker(linker)
         if out.startswith('The CompCert'):
-            return CompCertLinker(linker)
+            return linkers.CompCertLinker(linker)
         if p.returncode == 0:
-            return ArLinker(compiler.for_machine, linker)
+            return linkers.ArLinker(compiler.for_machine, linker)
         if p.returncode == 1 and err.startswith('usage'): # OSX
-            return ArLinker(compiler.for_machine, linker)
+            return linkers.AppleArLinker(compiler.for_machine, linker)
         if p.returncode == 1 and err.startswith('Usage'): # AIX
-            return AIXArLinker(linker)
+            return linkers.AIXArLinker(linker)
         if p.returncode == 1 and err.startswith('ar: bad option: --'): # Solaris
-            return ArLinker(compiler.for_machine, linker)
-    _handle_exceptions(popen_exceptions, linkers, 'linker')
+            return linkers.ArLinker(compiler.for_machine, linker)
+    _handle_exceptions(popen_exceptions, trials, 'linker')
+    raise EnvironmentException('Unreachable code (exception to make mypy happy)')
 
 
 # Compilers
@@ -363,6 +257,8 @@
     the compiler (GCC or Clang usually) as their shared linker, to find
     the linker they need.
     """
+    from . import c, cpp
+    from ..linkers import linkers
     popen_exceptions: T.Dictstr, T.UnionException, str = {}
     compilers, ccache, exe_wrap = _get_compilers(env, lang, for_machine)
     if override_compiler is not None:
@@ -451,35 +347,34 @@
 
             if guess_gcc_or_lcc == 'lcc':
                 version = _get_lcc_version_from_defines(defines)
-                cls = ElbrusCCompiler if lang == 'c' else ElbrusCPPCompiler
+                cls = c.ElbrusCCompiler if lang == 'c' else cpp.ElbrusCPPCompiler
             else:
                 version = _get_gnu_version_from_defines(defines)
-                cls = GnuCCompiler if lang == 'c' else GnuCPPCompiler
+                cls = c.GnuCCompiler if lang == 'c' else cpp.GnuCPPCompiler
 
             linker = guess_nix_linker(env, compiler, cls, version, for_machine)
 
             return cls(
-                ccache + compiler, version, for_machine, is_cross,
+                ccache, compiler, version, for_machine, is_cross,
                 info, exe_wrap, defines=defines, full_version=full_version,
                 linker=linker)
 
         if 'Emscripten' in out:
-            cls = EmscriptenCCompiler if lang == 'c' else EmscriptenCPPCompiler
+            cls = c.EmscriptenCCompiler if lang == 'c' else cpp.EmscriptenCPPCompiler
             env.coredata.add_lang_args(cls.language, cls, for_machine, env)
 
             # emcc requires a file input in order to pass arguments to the
             # linker. It'll exit with an error code, but still print the
-            # linker version. Old emcc versions ignore -Wl,--version completely,
-            # however. We'll report "unknown version" in that case.
+            # linker version.
             with tempfile.NamedTemporaryFile(suffix='.c') as f:
                 cmd = compiler + cls.LINKER_PREFIX + "--version", f.name
                 _, o, _ = Popen_safe(cmd)
 
-            linker = WASMDynamicLinker(
+            linker = linkers.WASMDynamicLinker(
                 compiler, for_machine, cls.LINKER_PREFIX,
                 , version=search_version(o))
             return cls(
-                ccache + compiler, version, for_machine, is_cross, info,
+                ccache, compiler, version, for_machine, is_cross, info,
                 exe_wrap, linker=linker, full_version=full_version)
 
         if 'Arm C/C++/Fortran Compiler' in out:
@@ -487,12 +382,12 @@
             assert arm_ver_match is not None, 'for mypy'  # because mypy *should* be complaning that this could be None
             version = '.'.join(x for x in arm_ver_match.groups() if x is not None)
             if lang == 'c':
-                cls = ArmLtdClangCCompiler
+                cls = c.ArmLtdClangCCompiler
             elif lang == 'cpp':
-                cls = ArmLtdClangCPPCompiler
+                cls = cpp.ArmLtdClangCPPCompiler
             linker = guess_nix_linker(env, compiler, cls, version, for_machine)
             return cls(
-                ccache + compiler, version, for_machine, is_cross, info,
+                ccache, compiler, version, for_machine, is_cross, info,
                 exe_wrap, linker=linker)
         if 'armclang' in out:
             # The compiler version is not present in the first line of output,
@@ -508,11 +403,11 @@
             # Override previous values
             version = search_version(arm_ver_str)
             full_version = arm_ver_str
-            cls = ArmclangCCompiler if lang == 'c' else ArmclangCPPCompiler
-            linker = ArmClangDynamicLinker(for_machine, version=version)
+            cls = c.ArmclangCCompiler if lang == 'c' else cpp.ArmclangCPPCompiler
+            linker = linkers.ArmClangDynamicLinker(for_machine, version=version)
             env.coredata.add_lang_args(cls.language, cls, for_machine, env)
             return cls(
-                ccache + compiler, version, for_machine, is_cross, info,
+                ccache, compiler, version, for_machine, is_cross, info,
                 exe_wrap, full_version=full_version, linker=linker)
         if 'CL.EXE COMPATIBILITY' in out:
             # if this is clang-cl masquerading as cl, detect it as cl, not
@@ -528,7 +423,7 @@
                 target = match.group(1)
             else:
                 target = 'unknown target'
-            cls = ClangClCCompiler if lang == 'c' else ClangClCPPCompiler
+            cls = c.ClangClCCompiler if lang == 'c' else cpp.ClangClCPPCompiler
             linker = guess_win_linker(env, 'lld-link', cls, version, for_machine)
             return cls(
                 compiler, version, for_machine, is_cross, info, target,
@@ -541,9 +436,9 @@
             # Even if the for_machine is darwin, we could be using vanilla
             # clang.
             if 'Apple' in out:
-                cls = AppleClangCCompiler if lang == 'c' else AppleClangCPPCompiler
+                cls = c.AppleClangCCompiler if lang == 'c' else cpp.AppleClangCPPCompiler
             else:
-                cls = ClangCCompiler if lang == 'c' else ClangCPPCompiler
+                cls = c.ClangCCompiler if lang == 'c' else cpp.ClangCPPCompiler
 
             if 'windows' in out or env.machinesfor_machine.is_windows():
                 # If we're in a MINGW context this actually will use a gnu
@@ -557,15 +452,24 @@
                 linker = guess_nix_linker(env, compiler, cls, version, for_machine)
 
             return cls(
-                ccache + compiler, version, for_machine, is_cross, info,
+                ccache, compiler, version, for_machine, is_cross, info,
                 exe_wrap, defines=defines, full_version=full_version, linker=linker)
 
         if 'Intel(R) C++ Intel(R)' in err:
             version = search_version(err)
             target = 'x86' if 'IA-32' in err else 'x86_64'
-            cls = IntelClCCompiler if lang == 'c' else IntelClCPPCompiler
+            cls = c.IntelClCCompiler if lang == 'c' else cpp.IntelClCPPCompiler
             env.coredata.add_lang_args(cls.language, cls, for_machine, env)
-            linker = XilinkDynamicLinker(for_machine, , version=version)
+            linker = linkers.XilinkDynamicLinker(for_machine, , version=version)
+            return cls(
+                compiler, version, for_machine, is_cross, info, target,
+                exe_wrap, linker=linker)
+        if 'Intel(R) oneAPI DPC++/C++ Compiler for applications' in err:
+            version = search_version(err)
+            target = 'x86' if 'IA-32' in err else 'x86_64'
+            cls = c.IntelLLVMClCCompiler if lang == 'c' else cpp.IntelLLVMClCPPCompiler
+            env.coredata.add_lang_args(cls.language, cls, for_machine, env)
+            linker = linkers.XilinkDynamicLinker(for_machine, , version=version)
             return cls(
                 compiler, version, for_machine, is_cross, info, target,
                 exe_wrap, linker=linker)
@@ -580,86 +484,90 @@
                     break
             else:
                 raise EnvironmentException(f'Failed to detect MSVC compiler version: stderr was\n{err!r}')
-            cl_signature = lookat.split('\n')0
+            cl_signature = lookat.split('\n', maxsplit=1)0
             match = re.search(r'.*(x86|x64|ARM|ARM64)(^_A-Za-z0-9|$)', cl_signature)
             if match:
                 target = match.group(1)
             else:
                 m = f'Failed to detect MSVC compiler target architecture: \'cl /?\' output is\n{cl_signature}'
                 raise EnvironmentException(m)
-            cls = VisualStudioCCompiler if lang == 'c' else VisualStudioCPPCompiler
+            cls = c.VisualStudioCCompiler if lang == 'c' else cpp.VisualStudioCPPCompiler
             linker = guess_win_linker(env, 'link', cls, version, for_machine)
             # As of this writing, CCache does not support MSVC but sccache does.
-            if 'sccache' in ccache:
-                final_compiler = ccache + compiler
-            else:
-                final_compiler = compiler
+            if 'sccache' not in ccache:
+                ccache = 
             return cls(
-                final_compiler, version, for_machine, is_cross, info, target,
+                ccache, compiler, version, for_machine, is_cross, info, target,
                 exe_wrap, full_version=cl_signature, linker=linker)
         if 'PGI Compilers' in out:
-            cls = PGICCompiler if lang == 'c' else PGICPPCompiler
+            cls = c.PGICCompiler if lang == 'c' else cpp.PGICPPCompiler
             env.coredata.add_lang_args(cls.language, cls, for_machine, env)
-            linker = PGIDynamicLinker(compiler, for_machine, cls.LINKER_PREFIX, , version=version)
+            linker = linkers.PGIDynamicLinker(compiler, for_machine, cls.LINKER_PREFIX, , version=version)
             return cls(
-                ccache + compiler, version, for_machine, is_cross,
+                ccache, compiler, version, for_machine, is_cross,
                 info, exe_wrap, linker=linker)
         if 'NVIDIA Compilers and Tools' in out:
-            cls = NvidiaHPC_CCompiler if lang == 'c' else NvidiaHPC_CPPCompiler
+            cls = c.NvidiaHPC_CCompiler if lang == 'c' else cpp.NvidiaHPC_CPPCompiler
             env.coredata.add_lang_args(cls.language, cls, for_machine, env)
-            linker = NvidiaHPC_DynamicLinker(compiler, for_machine, cls.LINKER_PREFIX, , version=version)
+            linker = linkers.NvidiaHPC_DynamicLinker(compiler, for_machine, cls.LINKER_PREFIX, , version=version)
             return cls(
-                ccache + compiler, version, for_machine, is_cross,
+                ccache, compiler, version, for_machine, is_cross,
                 info, exe_wrap, linker=linker)
         if '(ICC)' in out:
-            cls = IntelCCompiler if lang == 'c' else IntelCPPCompiler
+            cls = c.IntelCCompiler if lang == 'c' else cpp.IntelCPPCompiler
             l = guess_nix_linker(env, compiler, cls, version, for_machine)
             return cls(
-                ccache + compiler, version, for_machine, is_cross, info,
+                ccache, compiler, version, for_machine, is_cross, info,
+                exe_wrap, full_version=full_version, linker=l)
+        if 'Intel(R) oneAPI' in out:
+            cls = c.IntelLLVMCCompiler if lang == 'c' else cpp.IntelLLVMCPPCompiler
+            l = guess_nix_linker(env, compiler, cls, version, for_machine)
+            return cls(
+                ccache, compiler, version, for_machine, is_cross, info,
                 exe_wrap, full_version=full_version, linker=l)
         if 'TMS320C2000 C/C++' in out or 'MSP430 C/C++' in out or 'TI ARM C/C++ Compiler' in out:
-            lnk: T.UnionT.TypeC2000DynamicLinker, T.TypeTIDynamicLinker
+            lnk: T.UnionT.Typelinkers.C2000DynamicLinker, T.Typelinkers.TIDynamicLinker
             if 'TMS320C2000 C/C++' in out:
-                cls = C2000CCompiler if lang == 'c' else C2000CPPCompiler
-                lnk = C2000DynamicLinker
+                cls = c.C2000CCompiler if lang == 'c' else cpp.C2000CPPCompiler
+                lnk = linkers.C2000DynamicLinker
             else:
-                cls = TICCompiler if lang == 'c' else TICPPCompiler
-                lnk = TIDynamicLinker
+                cls = c.TICCompiler if lang == 'c' else cpp.TICPPCompiler
+                lnk = linkers.TIDynamicLinker
 
             env.coredata.add_lang_args(cls.language, cls, for_machine, env)
             linker = lnk(compiler, for_machine, version=version)
             return cls(
-                ccache + compiler, version, for_machine, is_cross, info,
+                ccache, compiler, version, for_machine, is_cross, info,
                 exe_wrap, full_version=full_version, linker=linker)
         if 'ARM' in out:
-            cls = ArmCCompiler if lang == 'c' else ArmCPPCompiler
+            cls = c.ArmCCompiler if lang == 'c' else cpp.ArmCPPCompiler
             env.coredata.add_lang_args(cls.language, cls, for_machine, env)
-            linker = ArmDynamicLinker(for_machine, version=version)
+            linker = linkers.ArmDynamicLinker(for_machine, version=version)
             return cls(
-                ccache + compiler, version, for_machine, is_cross,
+                ccache, compiler, version, for_machine, is_cross,
                 info, exe_wrap, full_version=full_version, linker=linker)
         if 'RX Family' in out:
-            cls = CcrxCCompiler if lang == 'c' else CcrxCPPCompiler
+            cls = c.CcrxCCompiler if lang == 'c' else cpp.CcrxCPPCompiler
             env.coredata.add_lang_args(cls.language, cls, for_machine, env)
-            linker = CcrxDynamicLinker(for_machine, version=version)
+            linker = linkers.CcrxDynamicLinker(for_machine, version=version)
             return cls(
-                ccache + compiler, version, for_machine, is_cross, info,
+                ccache, compiler, version, for_machine, is_cross, info,
                 exe_wrap, full_version=full_version, linker=linker)
 
         if 'Microchip Technology' in out:
-            cls = Xc16CCompiler if lang == 'c' else Xc16CCompiler
+            cls = c.Xc16CCompiler
             env.coredata.add_lang_args(cls.language, cls, for_machine, env)
-            linker = Xc16DynamicLinker(for_machine, version=version)
+            linker = linkers.Xc16DynamicLinker(for_machine, version=version)
             return cls(
-                ccache + compiler, version, for_machine, is_cross, info,
+                ccache, compiler, version, for_machine, is_cross, info,
                 exe_wrap, full_version=full_version, linker=linker)
 
         if 'CompCert' in out:
-            cls = CompCertCCompiler
+            cls = c.CompCertCCompiler
             env.coredata.add_lang_args(cls.language, cls, for_machine, env)
-            linker = CompCertDynamicLinker(for_machine, version=version)
+            linker = linkers.CompCertDynamicLinker(for_machine, version=version)
             return cls(
-                ccache + compiler, version, for_machine, is_cross, info,
+                ccache, compiler, version, for_machine, is_cross, info,
                 exe_wrap, full_version=full_version, linker=linker)
 
     _handle_exceptions(popen_exceptions, compilers)
@@ -672,6 +580,8 @@
     return _detect_c_or_cpp_compiler(env, 'cpp', for_machine)
 
 def detect_cuda_compiler(env: 'Environment', for_machine: MachineChoice) -> Compiler:
+    from .cuda import CudaCompiler
+    from ..linkers.linkers import CudaLinker
     popen_exceptions = {}
     is_cross = env.is_cross_build(for_machine)
     compilers, ccache, exe_wrap = _get_compilers(env, 'cuda', for_machine)
@@ -698,15 +608,17 @@
         #    - CUDA Toolkit 8.0.61 requires NVIDIA Driver 375.26
         # Luckily, the "V" also makes it very simple to extract
         # the full version:
-        version = out.strip().split('V')-1
+        version = out.strip().rsplit('V', maxsplit=1)-1
         cpp_compiler = detect_cpp_compiler(env, for_machine)
         cls = CudaCompiler
         env.coredata.add_lang_args(cls.language, cls, for_machine, env)
         linker = CudaLinker(compiler, for_machine, CudaCompiler.LINKER_PREFIX, , version=CudaLinker.parse_version())
-        return cls(ccache + compiler, version, for_machine, is_cross, exe_wrap, host_compiler=cpp_compiler, info=info, linker=linker)
+        return cls(ccache, compiler, version, for_machine, is_cross, exe_wrap, host_compiler=cpp_compiler, info=info, linker=linker)
     raise EnvironmentException(f'Could not find suitable CUDA compiler: "{"; ".join(" ".join(c) for c in compilers)}"')
 
 def detect_fortran_compiler(env: 'Environment', for_machine: MachineChoice) -> Compiler:
+    from . import fortran
+    from ..linkers import linkers
     popen_exceptions: T.Dictstr, T.UnionException, str = {}
     compilers, ccache, exe_wrap = _get_compilers(env, 'fortran', for_machine)
     is_cross = env.is_cross_build(for_machine)
@@ -736,102 +648,122 @@
                     continue
                 if guess_gcc_or_lcc == 'lcc':
                     version = _get_lcc_version_from_defines(defines)
-                    cls = ElbrusFortranCompiler
+                    cls = fortran.ElbrusFortranCompiler
                     linker = guess_nix_linker(env, compiler, cls, version, for_machine)
                     return cls(
                         compiler, version, for_machine, is_cross, info,
                         exe_wrap, defines, full_version=full_version, linker=linker)
                 else:
                     version = _get_gnu_version_from_defines(defines)
-                    cls = GnuFortranCompiler
+                    cls = fortran.GnuFortranCompiler
                     linker = guess_nix_linker(env, compiler, cls, version, for_machine)
                     return cls(
                         compiler, version, for_machine, is_cross, info,
                         exe_wrap, defines, full_version=full_version, linker=linker)
 
             if 'Arm C/C++/Fortran Compiler' in out:
-                cls = ArmLtdFlangFortranCompiler
+                cls = fortran.ArmLtdFlangFortranCompiler
                 arm_ver_match = re.search(r'version (\d+)\.(\d+)\.?(\d+)? $build number (\d+)$', out)
                 assert arm_ver_match is not None, 'for mypy'  # because mypy *should* be complaning that this could be None
                 version = '.'.join(x for x in arm_ver_match.groups() if x is not None)
                 linker = guess_nix_linker(env, compiler, cls, version, for_machine)
                 return cls(
-                    ccache + compiler, version, for_machine, is_cross, info,
+                    compiler, version, for_machine, is_cross, info,
                     exe_wrap, linker=linker)
             if 'G95' in out:
-                cls = G95FortranCompiler
+                cls = fortran.G95FortranCompiler
                 linker = guess_nix_linker(env, compiler, cls, version, for_machine)
-                return G95FortranCompiler(
+                return cls(
                     compiler, version, for_machine, is_cross, info,
                     exe_wrap, full_version=full_version, linker=linker)
 
             if 'Sun Fortran' in err:
                 version = search_version(err)
-                cls = SunFortranCompiler
+                cls = fortran.SunFortranCompiler
                 linker = guess_nix_linker(env, compiler, cls, version, for_machine)
-                return SunFortranCompiler(
+                return cls(
                     compiler, version, for_machine, is_cross, info,
                     exe_wrap, full_version=full_version, linker=linker)
 
+            if 'Intel(R) Fortran Compiler for applications' in err:
+                version = search_version(err)
+                target = 'x86' if 'IA-32' in err else 'x86_64'
+                cls = fortran.IntelLLVMClFortranCompiler
+                env.coredata.add_lang_args(cls.language, cls, for_machine, env)
+                linker = linkers.XilinkDynamicLinker(for_machine, , version=version)
+                return cls(
+                    compiler, version, for_machine, is_cross, info,
+                    target, exe_wrap, linker=linker)
+
             if 'Intel(R) Visual Fortran' in err or 'Intel(R) Fortran' in err:
                 version = search_version(err)
                 target = 'x86' if 'IA-32' in err else 'x86_64'
-                cls = IntelClFortranCompiler
+                cls = fortran.IntelClFortranCompiler
                 env.coredata.add_lang_args(cls.language, cls, for_machine, env)
-                linker = XilinkDynamicLinker(for_machine, , version=version)
+                linker = linkers.XilinkDynamicLinker(for_machine, , version=version)
                 return cls(
                     compiler, version, for_machine, is_cross, info,
                     target, exe_wrap, linker=linker)
 
             if 'ifort (IFORT)' in out:
-                linker = guess_nix_linker(env, compiler, IntelFortranCompiler, version, for_machine)
-                return IntelFortranCompiler(
+                cls = fortran.IntelFortranCompiler
+                linker = guess_nix_linker(env, compiler, cls, version, for_machine)
+                return cls(
+                    compiler, version, for_machine, is_cross, info,
+                    exe_wrap, full_version=full_version, linker=linker)
+
+            if 'ifx (IFORT)' in out:
+                cls = fortran.IntelLLVMFortranCompiler
+                linker = guess_nix_linker(env, compiler, cls, version, for_machine)
+                return cls(
                     compiler, version, for_machine, is_cross, info,
                     exe_wrap, full_version=full_version, linker=linker)
 
             if 'PathScale EKOPath(tm)' in err:
-                return PathScaleFortranCompiler(
+                return fortran.PathScaleFortranCompiler(
                     compiler, version, for_machine, is_cross, info,
                     exe_wrap, full_version=full_version)
 
             if 'PGI Compilers' in out:
-                cls = PGIFortranCompiler
+                cls = fortran.PGIFortranCompiler
                 env.coredata.add_lang_args(cls.language, cls, for_machine, env)
-                linker = PGIDynamicLinker(compiler, for_machine,
-                                          cls.LINKER_PREFIX, , version=version)
+                linker = linkers.PGIDynamicLinker(compiler, for_machine,
+                                                  cls.LINKER_PREFIX, , version=version)
                 return cls(
                     compiler, version, for_machine, is_cross, info, exe_wrap,
                     full_version=full_version, linker=linker)
 
             if 'NVIDIA Compilers and Tools' in out:
-                cls = NvidiaHPC_FortranCompiler
+                cls = fortran.NvidiaHPC_FortranCompiler
                 env.coredata.add_lang_args(cls.language, cls, for_machine, env)
-                linker = PGIDynamicLinker(compiler, for_machine,
-                                          cls.LINKER_PREFIX, , version=version)
+                linker = linkers.PGIDynamicLinker(compiler, for_machine,
+                                                  cls.LINKER_PREFIX, , version=version)
                 return cls(
                     compiler, version, for_machine, is_cross, info, exe_wrap,
                     full_version=full_version, linker=linker)
 
             if 'flang' in out or 'clang' in out:
+                cls = fortran.FlangFortranCompiler
                 linker = guess_nix_linker(env,
-                                          compiler, FlangFortranCompiler, version, for_machine)
-                return FlangFortranCompiler(
+                                          compiler, cls, version, for_machine)
+                return cls(
                     compiler, version, for_machine, is_cross, info,
                     exe_wrap, full_version=full_version, linker=linker)
 
             if 'Open64 Compiler Suite' in err:
+                cls = fortran.Open64FortranCompiler
                 linker = guess_nix_linker(env,
-                                          compiler, Open64FortranCompiler, version, for_machine)
-                return Open64FortranCompiler(
+                                          compiler, cls, version, for_machine)
+                return cls(
                     compiler, version, for_machine, is_cross, info,
                     exe_wrap, full_version=full_version, linker=linker)
 
             if 'NAG Fortran' in err:
                 full_version = err.split('\n', 1)0
                 version = full_version.split()-1
-                cls = NAGFortranCompiler
+                cls = fortran.NAGFortranCompiler
                 env.coredata.add_lang_args(cls.language, cls, for_machine, env)
-                linker = NAGDynamicLinker(
+                linker = linkers.NAGDynamicLinker(
                     compiler, for_machine, cls.LINKER_PREFIX, ,
                     version=version)
                 return cls(
@@ -842,17 +774,18 @@
     raise EnvironmentException('Unreachable code (exception to make mypy happy)')
 
 def detect_objc_compiler(env: 'Environment', for_machine: MachineChoice) -> 'Compiler':
-    return _detect_objc_or_objcpp_compiler(env, for_machine, True)
+    return _detect_objc_or_objcpp_compiler(env, 'objc', for_machine)
 
 def detect_objcpp_compiler(env: 'Environment', for_machine: MachineChoice) -> 'Compiler':
-    return _detect_objc_or_objcpp_compiler(env, for_machine, False)
+    return _detect_objc_or_objcpp_compiler(env, 'objcpp', for_machine)
 
-def _detect_objc_or_objcpp_compiler(env: 'Environment', for_machine: MachineChoice, objc: bool) -> 'Compiler':
+def _detect_objc_or_objcpp_compiler(env: 'Environment', lang: str, for_machine: MachineChoice) -> 'Compiler':
+    from . import objc, objcpp
     popen_exceptions: T.Dictstr, T.UnionException, str = {}
-    compilers, ccache, exe_wrap = _get_compilers(env, 'objc' if objc else 'objcpp', for_machine)
+    compilers, ccache, exe_wrap = _get_compilers(env, lang, for_machine)
     is_cross = env.is_cross_build(for_machine)
     info = env.machinesfor_machine
-    comp: T.UnionT.TypeObjCCompiler, T.TypeObjCPPCompiler
+    comp: T.UnionT.Typeobjc.ObjCCompiler, T.Typeobjcpp.ObjCPPCompiler
 
     for compiler in compilers:
         arg = '--version'
@@ -868,10 +801,10 @@
                 popen_exceptionsjoin_args(compiler) = 'no pre-processor defines'
                 continue
             version = _get_gnu_version_from_defines(defines)
-            comp = GnuObjCCompiler if objc else GnuObjCPPCompiler
+            comp = objc.GnuObjCCompiler if lang == 'objc' else objcpp.GnuObjCPPCompiler
             linker = guess_nix_linker(env, compiler, comp, version, for_machine)
             return comp(
-                ccache + compiler, version, for_machine, is_cross, info,
+                ccache, compiler, version, for_machine, is_cross, info,
                 exe_wrap, defines, linker=linker)
         if 'clang' in out:
             linker = None
@@ -880,9 +813,9 @@
                 popen_exceptionsjoin_args(compiler) = 'no pre-processor defines'
                 continue
             if 'Apple' in out:
-                comp = AppleClangObjCCompiler if objc else AppleClangObjCPPCompiler
+                comp = objc.AppleClangObjCCompiler if lang == 'objc' else objcpp.AppleClangObjCPPCompiler
             else:
-                comp = ClangObjCCompiler if objc else ClangObjCPPCompiler
+                comp = objc.ClangObjCCompiler if lang == 'objc' else objcpp.ClangObjCPPCompiler
             if 'windows' in out or env.machinesfor_machine.is_windows():
                 # If we're in a MINGW context this actually will use a gnu style ld
                 try:
@@ -893,12 +826,13 @@
             if not linker:
                 linker = guess_nix_linker(env, compiler, comp, version, for_machine)
             return comp(
-                ccache + compiler, version, for_machine,
+                ccache, compiler, version, for_machine,
                 is_cross, info, exe_wrap, linker=linker, defines=defines)
     _handle_exceptions(popen_exceptions, compilers)
     raise EnvironmentException('Unreachable code (exception to make mypy happy)')
 
 def detect_java_compiler(env: 'Environment', for_machine: MachineChoice) -> Compiler:
+    from .java import JavaCompiler
     exelist = env.lookup_binary_entry(for_machine, 'java')
     info = env.machinesfor_machine
     if exelist is None:
@@ -921,6 +855,7 @@
     raise EnvironmentException('Unknown compiler: ' + join_args(exelist))
 
 def detect_cs_compiler(env: 'Environment', for_machine: MachineChoice) -> Compiler:
+    from . import cs
     compilers, ccache, exe_wrap = _get_compilers(env, 'cs', for_machine)
     popen_exceptions = {}
     info = env.machinesfor_machine
@@ -932,11 +867,11 @@
             continue
 
         version = search_version(out)
-        cls: T.UnionT.TypeMonoCompiler, T.TypeVisualStudioCsCompiler
+        cls: T.Typecs.CsCompiler
         if 'Mono' in out:
-            cls = MonoCompiler
+            cls = cs.MonoCompiler
         elif "Visual C#" in out:
-            cls = VisualStudioCsCompiler
+            cls = cs.VisualStudioCsCompiler
         else:
             continue
         env.coredata.add_lang_args(cls.language, cls, for_machine, env)
@@ -947,7 +882,8 @@
 
 def detect_cython_compiler(env: 'Environment', for_machine: MachineChoice) -> Compiler:
     """Search for a cython compiler."""
-    compilers, _, _ = _get_compilers(env, 'cython', for_machine)
+    from .cython import CythonCompiler
+    compilers, _, _ = _get_compilers(env, 'cython', MachineChoice.BUILD)
     is_cross = env.is_cross_build(for_machine)
     info = env.machinesfor_machine
 
@@ -963,12 +899,13 @@
         if 'Cython' in err:
             comp_class = CythonCompiler
             env.coredata.add_lang_args(comp_class.language, comp_class, for_machine, env)
-            return comp_class(comp, version, for_machine, info, is_cross=is_cross)
+            return comp_class(, comp, version, for_machine, info, is_cross=is_cross)
     _handle_exceptions(popen_exceptions, compilers)
     raise EnvironmentException('Unreachable code (exception to make mypy happy)')
 
 def detect_vala_compiler(env: 'Environment', for_machine: MachineChoice) -> Compiler:
-    exelist = env.lookup_binary_entry(for_machine, 'vala')
+    from .vala import ValaCompiler
+    exelist = env.lookup_binary_entry(MachineChoice.BUILD, 'vala')
     is_cross = env.is_cross_build(for_machine)
     info = env.machinesfor_machine
     if exelist is None:
@@ -987,13 +924,15 @@
     raise EnvironmentException('Unknown compiler: ' + join_args(exelist))
 
 def detect_rust_compiler(env: 'Environment', for_machine: MachineChoice) -> RustCompiler:
+    from . import rust
+    from ..linkers import linkers
     popen_exceptions = {}  # type: T.Dictstr, Exception
     compilers, _, exe_wrap = _get_compilers(env, 'rust', for_machine)
     is_cross = env.is_cross_build(for_machine)
     info = env.machinesfor_machine
 
     cc = detect_c_compiler(env, for_machine)
-    is_link_exe = isinstance(cc.linker, VisualStudioLikeLinkerMixin)
+    is_link_exe = isinstance(cc.linker, linkers.VisualStudioLikeLinkerMixin)
     override = env.lookup_binary_entry(for_machine, 'rust_ld')
 
     for compiler in compilers:
@@ -1005,13 +944,13 @@
             continue
 
         version = search_version(out)
-        cls: T.TypeRustCompiler = RustCompiler
+        cls: T.TypeRustCompiler = rust.RustCompiler
 
         # Clippy is a wrapper around rustc, but it doesn't have rustc in it's
         # output. We can otherwise treat it as rustc.
         if 'clippy' in out:
             out = 'rustc'
-            cls = ClippyRustCompiler
+            cls = rust.ClippyRustCompiler
 
         if 'rustc' in out:
             # On Linux and mac rustc will invoke gcc (clang for mac
@@ -1066,7 +1005,7 @@
                                           override, cls, version, for_machine, use_linker_prefix=False)
                 # rustc takes linker arguments without a prefix, and
                 # inserts the correct prefix itself.
-                assert isinstance(linker, VisualStudioLikeLinkerMixin)
+                assert isinstance(linker, linkers.VisualStudioLikeLinkerMixin)
                 linker.direct = True
                 compiler.extend(cls.use_linker_args(linker.exelist0, ''))
             else:
@@ -1091,12 +1030,13 @@
     raise EnvironmentException('Unreachable code (exception to make mypy happy)')
 
 def detect_d_compiler(env: 'Environment', for_machine: MachineChoice) -> Compiler:
+    from . import c, d
     info = env.machinesfor_machine
 
     # Detect the target architecture, required for proper architecture handling on Windows.
     # MSVC compiler is required for correct platform detection.
     c_compiler = {'c': detect_c_compiler(env, for_machine)}
-    is_msvc = isinstance(c_compiler'c', VisualStudioCCompiler)
+    is_msvc = isinstance(c_compiler'c', c.VisualStudioCCompiler)
     if not is_msvc:
         c_compiler = {}
 
@@ -1109,6 +1049,7 @@
     popen_exceptions = {}
     is_cross = env.is_cross_build(for_machine)
     compilers, ccache, exe_wrap = _get_compilers(env, 'd', for_machine)
+    cls: T.Typed.DCompiler
     for exelist in compilers:
         # Search for a D compiler.
         # We prefer LDC over GDC unless overridden with the DC
@@ -1127,6 +1068,7 @@
         full_version = out.split('\n', 1)0
 
         if 'LLVM D compiler' in out:
+            cls = d.LLVMDCompiler
             # LDC seems to require a file
             # We cannot use NamedTemproraryFile on windows, its documented
             # to not work for our uses. So, just use mkstemp and only have
@@ -1139,7 +1081,7 @@
                     objfile = os.path.basename(f):-1 + 'obj'
                     linker = guess_win_linker(env,
                                               exelist,
-                                              LLVMDCompiler, full_version, for_machine,
+                                              cls, full_version, for_machine,
                                               use_linker_prefix=True, invoked_directly=False,
                                               extra_args=f)
                 else:
@@ -1147,22 +1089,24 @@
                     # Clean it up.
                     objfile = os.path.basename(f):-1 + 'o'
                     linker = guess_nix_linker(env,
-                                              exelist, LLVMDCompiler, full_version, for_machine,
+                                              exelist, cls, full_version, for_machine,
                                               extra_args=f)
             finally:
                 windows_proof_rm(f)
                 windows_proof_rm(objfile)
 
-            return LLVMDCompiler(
+            return cls(
                 exelist, version, for_machine, info, arch,
                 full_version=full_version, linker=linker, version_output=out)
         elif 'gdc' in out:
-            linker = guess_nix_linker(env, exelist, GnuDCompiler, version, for_machine)
-            return GnuDCompiler(
+            cls = d.GnuDCompiler
+            linker = guess_nix_linker(env, exelist, cls, version, for_machine)
+            return cls(
                 exelist, version, for_machine, info, arch,
                 exe_wrapper=exe_wrap, is_cross=is_cross,
                 full_version=full_version, linker=linker)
         elif 'The D Language Foundation' in out or 'Digital Mars' in out:
+            cls = d.DmdDCompiler
             # DMD seems to require a file
             # We cannot use NamedTemproraryFile on windows, its documented
             # to not work for our uses. So, just use mkstemp and only have
@@ -1177,18 +1121,18 @@
                 if info.is_windows() or info.is_cygwin():
                     objfile = os.path.basename(f):-1 + 'obj'
                     linker = guess_win_linker(env,
-                                              exelist, DmdDCompiler, full_version, for_machine,
+                                              exelist, cls, full_version, for_machine,
                                               invoked_directly=False, extra_args=f, arch_arg)
                 else:
                     objfile = os.path.basename(f):-1 + 'o'
                     linker = guess_nix_linker(env,
-                                              exelist, DmdDCompiler, full_version, for_machine,
+                                              exelist, cls, full_version, for_machine,
                                               extra_args=f, arch_arg)
             finally:
                 windows_proof_rm(f)
                 windows_proof_rm(objfile)
 
-            return DmdDCompiler(
+            return cls(
                 exelist, version, for_machine, info, arch,
                 full_version=full_version, linker=linker)
         raise EnvironmentException('Unknown compiler: ' + join_args(exelist))
@@ -1197,6 +1141,7 @@
     raise EnvironmentException('Unreachable code (exception to make mypy happy)')
 
 def detect_swift_compiler(env: 'Environment', for_machine: MachineChoice) -> Compiler:
+    from .swift import SwiftCompiler
     exelist = env.lookup_binary_entry(for_machine, 'swift')
     is_cross = env.is_cross_build(for_machine)
     info = env.machinesfor_machine
@@ -1212,14 +1157,93 @@
     if 'Swift' in err:
         # As for 5.0.1 swiftc *requires* a file to check the linker:
         with tempfile.NamedTemporaryFile(suffix='.swift') as f:
+            cls = SwiftCompiler
             linker = guess_nix_linker(env,
-                                      exelist, SwiftCompiler, version, for_machine,
+                                      exelist, cls, version, for_machine,
                                       extra_args=f.name)
-        return SwiftCompiler(
+        return cls(
             exelist, version, for_machine, is_cross, info, linker=linker)
 
     raise EnvironmentException('Unknown compiler: ' + join_args(exelist))
 
+def detect_nasm_compiler(env: 'Environment', for_machine: MachineChoice) -> Compiler:
+    from .asm import NasmCompiler, YasmCompiler
+    compilers, _, _ = _get_compilers(env, 'nasm', for_machine)
+    is_cross = env.is_cross_build(for_machine)
+
+    # We need a C compiler to properly detect the machine info and linker
+    cc = detect_c_compiler(env, for_machine)
+    if not is_cross:
+        from ..environment import detect_machine_info
+        info = detect_machine_info({'c': cc})
+    else:
+        info = env.machinesfor_machine
+
+    popen_exceptions: T.Dictstr, Exception = {}
+    for comp in compilers:
+        if comp == 'nasm' and is_windows() and not shutil.which(comp0):
+            # nasm is not in PATH on Windows by default
+            default_path = os.path.join(os.environ'ProgramFiles', 'NASM')
+            comp0 = shutil.which(comp0, path=default_path) or comp0
+        try:
+            output = Popen_safe(comp + '--version')1
+        except OSError as e:
+            popen_exceptions' '.join(comp + '--version') = e
+            continue
+
+        version = search_version(output)
+        if 'NASM' in output:
+            comp_class = NasmCompiler
+            env.coredata.add_lang_args(comp_class.language, comp_class, for_machine, env)
+            return comp_class(, comp, version, for_machine, info, cc.linker, is_cross=is_cross)
+        elif 'yasm' in output:
+            comp_class = YasmCompiler
+            env.coredata.add_lang_args(comp_class.language, comp_class, for_machine, env)
+            return comp_class(, comp, version, for_machine, info, cc.linker, is_cross=is_cross)
+    _handle_exceptions(popen_exceptions, compilers)
+    raise EnvironmentException('Unreachable code (exception to make mypy happy)')
+
+def detect_masm_compiler(env: 'Environment', for_machine: MachineChoice) -> Compiler:
+    # We need a C compiler to properly detect the machine info and linker
+    is_cross = env.is_cross_build(for_machine)
+    cc = detect_c_compiler(env, for_machine)
+    if not is_cross:
+        from ..environment import detect_machine_info
+        info = detect_machine_info({'c': cc})
+    else:
+        info = env.machinesfor_machine
+
+    from .asm import MasmCompiler, MasmARMCompiler
+    comp_class: T.TypeCompiler
+    if info.cpu_family == 'x86':
+        comp = 'ml'
+        comp_class = MasmCompiler
+        arg = '/?'
+    elif info.cpu_family == 'x86_64':
+        comp = 'ml64'
+        comp_class = MasmCompiler
+        arg = '/?'
+    elif info.cpu_family == 'arm':
+        comp = 'armasm'
+        comp_class = MasmARMCompiler
+        arg = '-h'
+    elif info.cpu_family == 'aarch64':
+        comp = 'armasm64'
+        comp_class = MasmARMCompiler
+        arg = '-h'
+    else:
+        raise EnvironmentException(f'Platform {info.cpu_family} not supported by MASM')
+
+    popen_exceptions: T.Dictstr, Exception = {}
+    try:
+        output = Popen_safe(comp + arg)2
+        version = search_version(output)
+        env.coredata.add_lang_args(comp_class.language, comp_class, for_machine, env)
+        return comp_class(, comp, version, for_machine, info, cc.linker, is_cross=is_cross)
+    except OSError as e:
+        popen_exceptions' '.join(comp + arg) = e
+    _handle_exceptions(popen_exceptions, comp)
+    raise EnvironmentException('Unreachable code (exception to make mypy happy)')
 
 # GNU/Clang defines and version
 # =============================

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/compilers/fortran.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/compilers/fortran.py Changed

@@ -11,10 +11,10 @@
 # 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.
+from __future__ import annotations
 
-from pathlib import Path
 import typing as T
-import subprocess, os
+import os
 
 from .. import coredata
 from .compilers import (
@@ -23,7 +23,7 @@
 )
 from .mixins.clike import CLikeCompiler
 from .mixins.gnu import (
-    GnuCompiler, gnulike_buildtype_args, gnu_optimization_args,
+    GnuCompiler, gnulike_buildtype_args, gnu_optimization_args
 )
 from .mixins.intel import IntelGnuLikeCompiler, IntelVisualStudioLikeCompiler
 from .mixins.clang import ClangCompiler
@@ -31,7 +31,7 @@
 from .mixins.pgi import PGICompiler
 
 from mesonbuild.mesonlib import (
-    version_compare, EnvironmentException, MesonException, MachineChoice,
+    version_compare, MesonException,
     LibType, OptionKey,
 )
 
@@ -41,6 +41,7 @@
     from ..envconfig import MachineInfo
     from ..environment import Environment
     from ..linkers import DynamicLinker
+    from ..mesonlib import MachineChoice
     from ..programs import ExternalProgram
     from .compilers import CompileCheckMode
 
@@ -53,7 +54,7 @@
                  info: 'MachineInfo', exe_wrapper: T.Optional'ExternalProgram' = None,
                  linker: T.Optional'DynamicLinker' = None,
                  full_version: T.Optionalstr = None):
-        Compiler.__init__(self, exelist, version, for_machine, info,
+        Compiler.__init__(self, , exelist, version, for_machine, info,
                           is_cross=is_cross, full_version=full_version, linker=linker)
         CLikeCompiler.__init__(self, exe_wrapper)
 
@@ -65,41 +66,15 @@
                              "meson.get_compiler('fortran').links('block; end block; end program')\n\n"
                              'that example is to see if the compiler has Fortran 2008 Block element.')
 
-    def sanity_check(self, work_dir_: str, environment: 'Environment') -> None:
-        work_dir = Path(work_dir_)
-        source_name = work_dir / 'sanitycheckf.f90'
-        binary_name = work_dir / 'sanitycheckf'
-        if binary_name.is_file():
-            binary_name.unlink()
-
-        source_name.write_text('program main; print *, "Fortran compilation is working."; end program', encoding='utf-8')
-
-        extra_flags: T.Liststr = 
-        extra_flags += environment.coredata.get_external_args(self.for_machine, self.language)
-        extra_flags += environment.coredata.get_external_link_args(self.for_machine, self.language)
-        extra_flags += self.get_always_args()
-        # %% build the test executable "sanitycheckf"
-        # cwd=work_dir is necessary on Windows especially for Intel compilers to avoid error: cannot write on sanitycheckf.obj
-        # this is a defect with how Windows handles files and ifort's object file-writing behavior vis concurrent ProcessPoolExecutor.
-        # This simple workaround solves the issue.
-        returncode = subprocess.run(self.exelist + extra_flags + str(source_name), '-o', str(binary_name),
-                                    cwd=work_dir).returncode
-        if returncode != 0:
-            raise EnvironmentException('Compiler %s can not compile programs.' % self.name_string())
-        if self.is_cross:
-            if self.exe_wrapper is None:
-                # Can't check if the binaries run so we have to assume they do
-                return
-            cmdlist = self.exe_wrapper.get_command() + str(binary_name)
-        else:
-            cmdlist = str(binary_name)
-        # %% Run the test executable
-        try:
-            returncode = subprocess.run(cmdlist, stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL).returncode
-            if returncode != 0:
-                raise EnvironmentException('Executables created by Fortran compiler %s are not runnable.' % self.name_string())
-        except OSError:
-            raise EnvironmentException('Executables created by Fortran compiler %s are not runnable.' % self.name_string())
+    def _get_basic_compiler_args(self, env: 'Environment', mode: CompileCheckMode) -> T.TupleT.Liststr, T.Liststr:
+        cargs = env.coredata.get_external_args(self.for_machine, self.language)
+        largs = env.coredata.get_external_link_args(self.for_machine, self.language)
+        return cargs, largs
+
+    def sanity_check(self, work_dir: str, environment: 'Environment') -> None:
+        source_name = 'sanitycheckf.f90'
+        code = 'program main; print *, "Fortran compilation is working."; end program\n'
+        return self._sanity_check_impl(work_dir, environment, source_name, code)
 
     def get_buildtype_args(self, buildtype: str) -> T.Liststr:
         return gnulike_buildtype_argsbuildtype
@@ -130,9 +105,9 @@
     def module_name_to_filename(self, module_name: str) -> str:
         if '_' in module_name:  # submodule
             s = module_name.lower()
-            if self.id in ('gcc', 'intel', 'intel-cl'):
+            if self.id in {'gcc', 'intel', 'intel-cl'}:
                 filename = s.replace('_', '@') + '.smod'
-            elif self.id in ('pgi', 'flang'):
+            elif self.id in {'pgi', 'flang'}:
                 filename = s.replace('_', '-') + '.mod'
             else:
                 filename = s + '.mod'
@@ -180,7 +155,8 @@
         self.warn_args = {'0': ,
                           '1': default_warn_args,
                           '2': default_warn_args + '-Wextra',
-                          '3': default_warn_args + '-Wextra', '-Wpedantic', '-fimplicit-none'}
+                          '3': default_warn_args + '-Wextra', '-Wpedantic', '-fimplicit-none',
+                          'everything': default_warn_args + '-Wextra', '-Wpedantic', '-fimplicit-none'}
 
     def get_options(self) -> 'MutableKeyedOptionDictType':
         opts = FortranCompiler.get_options(self)
@@ -271,7 +247,8 @@
         self.warn_args = {'0': ,
                           '1': default_warn_args,
                           '2': default_warn_args + '-Wextra',
-                          '3': default_warn_args + '-Wextra', '-pedantic'}
+                          '3': default_warn_args + '-Wextra', '-pedantic',
+                          'everything': default_warn_args + '-Wextra', '-pedantic'}
 
     def get_module_outdir_args(self, path: str) -> T.Liststr:
         return '-fmod=' + path
@@ -324,7 +301,8 @@
         self.warn_args = {'0': ,
                           '1': default_warn_args,
                           '2': default_warn_args + '-warn', 'unused',
-                          '3': '-warn', 'all'}
+                          '3': '-warn', 'all',
+                          'everything': '-warn', 'all'}
 
     def get_options(self) -> 'MutableKeyedOptionDictType':
         opts = FortranCompiler.get_options(self)
@@ -352,6 +330,11 @@
         return '-gen-dep=' + outtarget, '-gen-depformat=make'
 
 
+class IntelLLVMFortranCompiler(IntelFortranCompiler):
+
+    id = 'intel-llvm'
+
+
 class IntelClFortranCompiler(IntelVisualStudioLikeCompiler, FortranCompiler):
 
     file_suffixes = ('f90', 'f', 'for', 'ftn', 'fpp', )
@@ -371,7 +354,8 @@
         self.warn_args = {'0': ,
                           '1': default_warn_args,
                           '2': default_warn_args + '/warn:unused',
-                          '3': '/warn:all'}
+                          '3': '/warn:all',
+                          'everything': '/warn:all'}
 
     def get_options(self) -> 'MutableKeyedOptionDictType':
         opts = FortranCompiler.get_options(self)
@@ -392,6 +376,10 @@
         return '/module:' + path
 
 
+class IntelLLVMClFortranCompiler(IntelClFortranCompiler):
+
+    id = 'intel-llvm-cl'
+
 class PathScaleFortranCompiler(FortranCompiler):
 
     id = 'pathscale'
@@ -407,7 +395,8 @@
         self.warn_args = {'0': ,
                           '1': default_warn_args,
                           '2': default_warn_args,
-                          '3': default_warn_args}
+                          '3': default_warn_args,
+                          'everything': default_warn_args}
 
     def openmp_flags(self) -> T.Liststr:
         return '-mp'
@@ -428,7 +417,8 @@
         self.warn_args = {'0': ,
                           '1': default_warn_args,
                           '2': default_warn_args,
-                          '3': default_warn_args + '-Mdclchk'}
+                          '3': default_warn_args + '-Mdclchk',
+                          'everything': default_warn_args + '-Mdclchk'}
 
     def language_stdlib_only_link_flags(self, env: 'Environment') -> T.Liststr:
         # TODO: needs default search path added
@@ -453,7 +443,8 @@
         self.warn_args = {'0': ,
                           '1': default_warn_args,
                           '2': default_warn_args,
-                          '3': default_warn_args + '-Mdclchk'}
+                          '3': default_warn_args + '-Mdclchk',
+                          'everything': default_warn_args + '-Mdclchk'}
 
 
 class FlangFortranCompiler(ClangCompiler, FortranCompiler):
@@ -472,7 +463,8 @@
         self.warn_args = {'0': ,
                           '1': default_warn_args,
                           '2': default_warn_args,
-                          '3': default_warn_args}
+                          '3': default_warn_args,
+                          'everything': default_warn_args}
 
     def language_stdlib_only_link_flags(self, env: 'Environment') -> T.Liststr:
         # We need to apply the search prefix here, as these link arguments may
@@ -504,7 +496,8 @@
         self.warn_args = {'0': ,
                           '1': default_warn_args,
                           '2': default_warn_args,
-                          '3': default_warn_args}
+                          '3': default_warn_args,
+                          'everything': default_warn_args}
 
     def openmp_flags(self) -> T.Liststr:
         return '-mp'
@@ -527,6 +520,7 @@
             '1': ,
             '2': ,
             '3': ,
+            'everything': ,
         }
 
     def get_always_args(self) -> T.Liststr:

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/compilers/java.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/compilers/java.py Changed

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/compilers/mixins/arm.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/compilers/mixins/arm.py Changed

@@ -11,6 +11,7 @@
 # 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.
+from __future__ import annotations
 
 """Representations specific to the arm family of compilers."""
 
@@ -43,6 +44,7 @@
 }  # type: T.Dictstr, T.Liststr
 
 arm_optimization_args = {
+    'plain': ,
     '0': '-O0',
     'g': '-g',
     '1': '-O1',
@@ -61,6 +63,7 @@
 }  # type: T.Dictstr, T.Liststr
 
 armclang_optimization_args = {
+    'plain': ,
     '0': , # Compiler defaults to -O0
     'g': '-g',
     '1': '-O1',
@@ -83,7 +86,8 @@
         self.warn_args = {'0': ,
                           '1': default_warn_args,
                           '2': default_warn_args + ,
-                          '3': default_warn_args + }  # type: T.Dictstr, T.Liststr
+                          '3': default_warn_args + ,
+                          'everything': default_warn_args + }  # type: T.Dictstr, T.Liststr
         # Assembly
         self.can_compile_suffixes.add('s')

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/compilers/mixins/ccrx.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/compilers/mixins/ccrx.py Changed

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/compilers/mixins/clang.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/compilers/mixins/clang.py Changed

@@ -11,6 +11,7 @@
 # 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.
+from __future__ import annotations
 
 """Abstractions for the LLVM/Clang compiler family."""
 
@@ -19,7 +20,8 @@
 import typing as T
 
 from ... import mesonlib
-from ...linkers import AppleDynamicLinker, ClangClDynamicLinker, LLVMDynamicLinker, GnuGoldDynamicLinker
+from ...linkers import AppleDynamicLinker, ClangClDynamicLinker, LLVMDynamicLinker, GnuGoldDynamicLinker, \
+    MoldDynamicLinker
 from ...mesonlib import OptionKey
 from ..compilers import CompileCheckMode
 from .gnu import GnuLikeCompiler
@@ -35,6 +37,7 @@
 }  # type: T.Dictstr, T.Liststr
 
 clang_optimization_args = {
+    'plain': ,
     '0': '-O0',
     'g': '-Og',
     '1': '-O1',
@@ -51,7 +54,8 @@
         super().__init__()
         self.defines = defines or {}
         self.base_options.update(
-            {OptionKey('b_colorout'), OptionKey('b_lto_threads'), OptionKey('b_lto_mode')})
+            {OptionKey('b_colorout'), OptionKey('b_lto_threads'), OptionKey('b_lto_mode'), OptionKey('b_thinlto_cache'),
+             OptionKey('b_thinlto_cache_dir')})
 
         # TODO: this really should be part of the linker base_options, but
         # linkers don't have base_options.
@@ -148,17 +152,26 @@
     def get_lto_compile_args(self, *, threads: int = 0, mode: str = 'default') -> T.Liststr:
         args: T.Liststr = 
         if mode == 'thin':
-            # Thin LTO requires the use of gold, lld, ld64, or lld-link
-            if not isinstance(self.linker, (AppleDynamicLinker, ClangClDynamicLinker, LLVMDynamicLinker, GnuGoldDynamicLinker)):
-                raise mesonlib.MesonException(f"LLVM's thinLTO only works with gnu gold, lld, lld-link, and ld64, not {self.linker.id}")
+            # ThinLTO requires the use of gold, lld, ld64, lld-link or mold 1.1+
+            if isinstance(self.linker, (MoldDynamicLinker)):
+                # https://github.com/rui314/mold/commit/46995bcfc3e3113133620bf16445c5f13cd76a18
+                if not mesonlib.version_compare(self.linker.version, '>=1.1'):
+                    raise mesonlib.MesonException("LLVM's ThinLTO requires mold 1.1+")
+            elif not isinstance(self.linker, (AppleDynamicLinker, ClangClDynamicLinker, LLVMDynamicLinker, GnuGoldDynamicLinker)):
+                raise mesonlib.MesonException(f"LLVM's ThinLTO only works with gold, lld, lld-link, ld64 or mold, not {self.linker.id}")
             args.append(f'-flto={mode}')
         else:
             assert mode == 'default', 'someone forgot to wire something up'
             args.extend(super().get_lto_compile_args(threads=threads))
         return args
 
-    def get_lto_link_args(self, *, threads: int = 0, mode: str = 'default') -> T.Liststr:
+    def get_lto_link_args(self, *, threads: int = 0, mode: str = 'default',
+                          thinlto_cache_dir: T.Optionalstr = None) -> T.Liststr:
         args = self.get_lto_compile_args(threads=threads, mode=mode)
+        if mode == 'thin' and thinlto_cache_dir is not None:
+            # We check for ThinLTO linker support above in get_lto_compile_args, and all of them support
+            # get_thinlto_cache_args as well
+            args.extend(self.linker.get_thinlto_cache_args(thinlto_cache_dir))
         # In clang -flto-jobs=0 means auto, and is the default if unspecified, just like in meson
         if threads > 0:
             if not mesonlib.version_compare(self.version, '>=4.0.0'):

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/compilers/mixins/clike.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/compilers/mixins/clike.py Changed

@@ -11,6 +11,7 @@
 # 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.
+from __future__ import annotations
 
 
 """Mixin classes to be shared between C and C++ compilers.
@@ -27,6 +28,7 @@
 import os
 import re
 import subprocess
+import copy
 import typing as T
 from pathlib import Path
 
@@ -100,6 +102,7 @@
         # Remove system/default include paths added with -isystem
         default_dirs = self.compiler.get_default_include_dirs()
         if default_dirs:
+            real_default_dirs = self._cached_realpath(i) for i in default_dirs
             bad_idx_list =   # type: T.Listint
             for i, each in enumerate(new):
                 if not each.startswith('-isystem'):
@@ -108,16 +111,21 @@
                 # Remove the -isystem and the path if the path is a default path
                 if (each == '-isystem' and
                         i < (len(new) - 1) and
-                        newi + 1 in default_dirs):
+                        self._cached_realpath(newi + 1) in real_default_dirs):
                     bad_idx_list += i, i + 1
-                elif each.startswith('-isystem=') and each9: in default_dirs:
+                elif each.startswith('-isystem=') and self._cached_realpath(each9:) in real_default_dirs:
                     bad_idx_list += i
-                elif each8: in default_dirs:
+                elif self._cached_realpath(each8:) in real_default_dirs:
                     bad_idx_list += i
             for i in reversed(bad_idx_list):
                 new.pop(i)
         return self.compiler.unix_args_to_native(new._container)
 
+    @staticmethod
+    @functools.lru_cache(maxsize=None)
+    def _cached_realpath(arg: str) -> str:
+        return os.path.realpath(arg)
+
     def __repr__(self) -> str:
         self.flush_pre_post()
         return f'CLikeCompilerArgs({self.compiler!r}, {self._container!r})'
@@ -144,6 +152,8 @@
             self.exe_wrapper = None
         else:
             self.exe_wrapper = exe_wrapper
+        # Lazy initialized in get_preprocessor()
+        self.preprocessor: T.OptionalCompiler = None
 
     def compiler_args(self, args: T.OptionalT.Iterablestr = None) -> CLikeCompilerArgs:
         # This is correct, mypy just doesn't understand co-operative inheritance
@@ -175,9 +185,6 @@
     def get_depfile_suffix(self) -> str:
         return 'd'
 
-    def get_exelist(self) -> T.Liststr:
-        return self.exelist.copy()
-
     def get_preprocess_only_args(self) -> T.Liststr:
         return '-E', '-P'
 
@@ -284,7 +291,7 @@
 
     def _sanity_check_impl(self, work_dir: str, environment: 'Environment',
                            sname: str, code: str) -> None:
-        mlog.debug('Sanity testing ' + self.get_display_language() + ' compiler:', ' '.join(self.exelist))
+        mlog.debug('Sanity testing ' + self.get_display_language() + ' compiler:', mesonlib.join_args(self.exelist))
         mlog.debug(f'Is cross compiler: {self.is_cross!s}.')
 
         source_name = os.path.join(work_dir, sname)
@@ -293,7 +300,7 @@
         if self.is_cross:
             binname += '_cross'
             if self.exe_wrapper is None:
-                # Linking cross built apps is painful. You can't really
+                # Linking cross built C/C++ apps is painful. You can't really
                 # tell if you should use -nostdlib or not and for example
                 # on OSX the compiler binary is the same but you need
                 # a ton of compiler flags to differentiate between
@@ -313,7 +320,7 @@
         # after which all further arguments will be passed directly to the linker
         cmdlist = self.exelist + sname + self.get_output_args(binname) + extra_flags
         pc, stdo, stde = mesonlib.Popen_safe(cmdlist, cwd=work_dir)
-        mlog.debug('Sanity check compiler command line:', ' '.join(cmdlist))
+        mlog.debug('Sanity check compiler command line:', mesonlib.join_args(cmdlist))
         mlog.debug('Sanity check compile stdout:')
         mlog.debug(stdo)
         mlog.debug('-----\nSanity check compile stderr:')
@@ -329,12 +336,12 @@
             cmdlist = self.exe_wrapper.get_command() + binary_name
         else:
             cmdlist = binary_name
-        mlog.debug('Running test binary command: ' + ' '.join(cmdlist))
+        mlog.debug('Running test binary command: ', mesonlib.join_args(cmdlist))
         try:
-            pe = subprocess.Popen(cmdlist)
+            # fortran code writes to stdout
+            pe = subprocess.run(cmdlist, stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL)
         except Exception as e:
             raise mesonlib.EnvironmentException(f'Could not invoke sanity test executable: {e!s}.')
-        pe.wait()
         if pe.returncode != 0:
             raise mesonlib.EnvironmentException(f'Executables created by {self.language} compiler {self.name_string()} are not runnable.')
 
@@ -516,9 +523,7 @@
                     low = cur + 1
                     if low > maxint:
                         raise mesonlib.EnvironmentException('Cross-compile check overflowed')
-                    cur = cur * 2 + 1
-                    if cur > maxint:
-                        cur = maxint
+                    cur = min(cur * 2 + 1, maxint)
                 high = cur
             else:
                 high = cur = -1
@@ -526,9 +531,7 @@
                     high = cur - 1
                     if high < minint:
                         raise mesonlib.EnvironmentException('Cross-compile check overflowed')
-                    cur = cur * 2
-                    if cur < minint:
-                        cur = minint
+                    cur = max(cur * 2, minint)
                 low = cur
         else:
             # Sanity check limits given by user
@@ -879,9 +882,7 @@
         if extra_args is None:
             extra_args = 
         # Create code that accesses all members
-        members = ''
-        for member in membernames:
-            members += f'foo.{member};\n'
+        members = ''.join(f'foo.{member};\n' for member in membernames)
         t = f'''{prefix}
         void bar(void) {{
             {typename} foo;
@@ -979,7 +980,6 @@
             return m.cpu_family == 'x86'
         return None
 
-
     def symbols_have_underscore_prefix(self, env: 'Environment') -> bool:
         '''
         Check if the compiler prefixes an underscore to global C symbols
@@ -999,7 +999,6 @@
         # most unreliable way of checking this, see #5482
         return self._symbols_have_underscore_prefix_searchbin(env)
 
-
     def _get_patterns(self, env: 'Environment', prefixes: T.Liststr, suffixes: T.Liststr, shared: bool = False) -> T.Liststr:
         patterns =   # type: T.Liststr
         for p in prefixes:
@@ -1159,6 +1158,8 @@
                 trial = self._get_file_from_list(env, trials)
                 if not trial:
                     continue
+                if libname.startswith('lib') and trial.name.startswith(libname):
+                    mlog.warning(f'find_library({libname!r}) starting in "lib" only works by accident and is not portable')
                 return trial.as_posix()
         return None
 
@@ -1194,7 +1195,7 @@
         if self.id != 'clang':
             raise mesonlib.MesonException('Cannot find framework path with non-clang compiler')
         # Construct the compiler command-line
-        commands = self.get_exelist() + '-v', '-E', '-'
+        commands = self.get_exelist(ccache=False) + '-v', '-E', '-'
         commands += self.get_always_args()
         # Add CFLAGS/CXXFLAGS/OBJCFLAGS/OBJCXXFLAGS from the env
         commands += env.coredata.get_external_args(self.for_machine, self.language)
@@ -1323,7 +1324,7 @@
         # don't work
         m = env.machinesself.for_machine
         if not (m.is_windows() or m.is_cygwin()):
-            if name in 'dllimport', 'dllexport':
+            if name in {'dllimport', 'dllexport'}:
                 return False, False
 
         return self.compiles(self.attribute_check_func(name), env,
@@ -1331,3 +1332,18 @@
 
     def get_disable_assert_args(self) -> T.Liststr:
         return '-DNDEBUG'
+
+    @functools.lru_cache(maxsize=None)
+    def can_compile(self, src: 'mesonlib.FileOrString') -> bool:
+        # Files we preprocess can be anything, e.g. .in
+        if self.mode == 'PREPROCESSOR':
+            return True
+        return super().can_compile(src)
+
+    def get_preprocessor(self) -> Compiler:
+        if not self.preprocessor:
+            self.preprocessor = copy.copy(self)
+            self.preprocessor.exelist = self.exelist + self.get_preprocess_to_file_args()
+            self.preprocessor.mode = 'PREPROCESSOR'
+            self.modes.append(self.preprocessor)
+        return self.preprocessor

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/compilers/mixins/compcert.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/compilers/mixins/compcert.py Changed

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/compilers/mixins/elbrus.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/compilers/mixins/elbrus.py Changed

@@ -11,6 +11,7 @@
 # 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.
+from __future__ import annotations
 
 """Abstractions for the Elbrus family of compilers."""
 
@@ -41,14 +42,15 @@
         self.warn_args = {'0': ,
                           '1': default_warn_args,
                           '2': default_warn_args + '-Wextra',
-                          '3': default_warn_args + '-Wextra', '-Wpedantic'}
+                          '3': default_warn_args + '-Wextra', '-Wpedantic',
+                          'everything': default_warn_args + '-Wextra', '-Wpedantic'}
 
     # FIXME: use _build_wrapper to call this so that linker flags from the env
     # get applied
     def get_library_dirs(self, env: 'Environment', elf_class: T.Optionalint = None) -> T.Liststr:
         os_env = os.environ.copy()
         os_env'LC_ALL' = 'C'
-        stdo = Popen_safe(self.exelist + '--print-search-dirs', env=os_env)1
+        stdo = Popen_safe(self.get_exelist(ccache=False) + '--print-search-dirs', env=os_env)1
         for line in stdo.split('\n'):
             if line.startswith('libraries:'):
                 # lcc does not include '=' in --print-search-dirs output. Also it could show nonexistent dirs.
@@ -59,7 +61,7 @@
     def get_program_dirs(self, env: 'Environment') -> T.Liststr:
         os_env = os.environ.copy()
         os_env'LC_ALL' = 'C'
-        stdo = Popen_safe(self.exelist + '--print-search-dirs', env=os_env)1
+        stdo = Popen_safe(self.get_exelist(ccache=False) + '--print-search-dirs', env=os_env)1
         for line in stdo.split('\n'):
             if line.startswith('programs:'):
                 # lcc does not include '=' in --print-search-dirs output.
@@ -70,7 +72,7 @@
     def get_default_include_dirs(self) -> T.Liststr:
         os_env = os.environ.copy()
         os_env'LC_ALL' = 'C'
-        p = subprocess.Popen(self.exelist + '-xc', '-E', '-v', '-', env=os_env, stdin=subprocess.DEVNULL, stdout=subprocess.PIPE, stderr=subprocess.PIPE)
+        p = subprocess.Popen(self.get_exelist(ccache=False) + '-xc', '-E', '-v', '-', env=os_env, stdin=subprocess.DEVNULL, stdout=subprocess.PIPE, stderr=subprocess.PIPE)
         stderr = p.stderr.read().decode('utf-8', errors='replace')
         includes = 
         for line in stderr.split('\n'):

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/compilers/mixins/emscripten.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/compilers/mixins/emscripten.py Changed

@@ -11,6 +11,7 @@
 # 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.
+from __future__ import annotations
 
 """Provides a mixin for shared code between C and C++ Emscripten compilers."""
 
@@ -58,14 +59,11 @@
             suffix = 'o'
         return os.path.join(dirname, 'output.' + suffix)
 
-    def thread_flags(self, env: 'Environment') -> T.Liststr:
-        return '-s', 'USE_PTHREADS=1'
-
     def thread_link_flags(self, env: 'Environment') -> T.Liststr:
-        args = '-s', 'USE_PTHREADS=1'
+        args = '-pthread'
         count: int = env.coredata.optionsOptionKey('thread_count', lang=self.language, machine=self.for_machine).value
         if count:
-            args.extend('-s', f'PTHREAD_POOL_SIZE={count}')
+            args.append(f'-sPTHREAD_POOL_SIZE={count}')
         return args
 
     def get_options(self) -> 'coredata.MutableKeyedOptionDictType':

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/compilers/mixins/gnu.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/compilers/mixins/gnu.py Changed

@@ -11,6 +11,7 @@
 # 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.
+from __future__ import annotations
 
 """Provides mixins for GNU compilers and GNU-like compilers."""
 
@@ -55,6 +56,7 @@
 }  # type: T.Dictstr, T.Liststr
 
 gnu_optimization_args = {
+    'plain': ,
     '0': '-O0',
     'g': '-Og',
     '1': '-O1',
@@ -91,6 +93,238 @@
     'never': '-fdiagnostics-color=never',
 }  # type: T.Dictstr, T.Liststr
 
+# Warnings collected from the GCC source and documentation.  This is an
+# objective set of all the warnings flags that apply to general projects: the
+# only ones omitted are those that require a project-specific value, or are
+# related to non-standard or legacy language support.  This behaves roughly
+# like -Weverything in clang.  Warnings implied by -Wall, -Wextra, or
+# higher-level warnings already enabled here are not included in these lists to
+# keep them as short as possible.  History goes back to GCC 3.0.0, everything
+# earlier is considered historical and listed under version 0.0.0.
+
+# GCC warnings for all C-family languages
+# Omitted non-general warnings:
+#   -Wabi=
+#   -Waggregate-return
+#   -Walloc-size-larger-than=BYTES
+#   -Walloca-larger-than=BYTES
+#   -Wframe-larger-than=BYTES
+#   -Wlarger-than=BYTES
+#   -Wstack-usage=BYTES
+#   -Wsystem-headers
+#   -Wtrampolines
+#   -Wvla-larger-than=BYTES
+#
+# Omitted warnings enabled elsewhere in meson:
+#   -Winvalid-pch (GCC 3.4.0)
+gnu_common_warning_args = {
+    "0.0.0": 
+        "-Wcast-qual",
+        "-Wconversion",
+        "-Wfloat-equal",
+        "-Wformat=2",
+        "-Winline",
+        "-Wmissing-declarations",
+        "-Wredundant-decls",
+        "-Wshadow",
+        "-Wundef",
+        "-Wuninitialized",
+        "-Wwrite-strings",
+    ,
+    "3.0.0": 
+        "-Wdisabled-optimization",
+        "-Wpacked",
+        "-Wpadded",
+    ,
+    "3.3.0": 
+        "-Wmultichar",
+        "-Wswitch-default",
+        "-Wswitch-enum",
+        "-Wunused-macros",
+    ,
+    "4.0.0": 
+        "-Wmissing-include-dirs",
+    ,
+    "4.1.0": 
+        "-Wunsafe-loop-optimizations",
+        "-Wstack-protector",
+    ,
+    "4.2.0": 
+        "-Wstrict-overflow=5",
+    ,
+    "4.3.0": 
+        "-Warray-bounds=2",
+        "-Wlogical-op",
+        "-Wstrict-aliasing=3",
+        "-Wvla",
+    ,
+    "4.6.0": 
+        "-Wdouble-promotion",
+        "-Wsuggest-attribute=const",
+        "-Wsuggest-attribute=noreturn",
+        "-Wsuggest-attribute=pure",
+        "-Wtrampolines",
+    ,
+    "4.7.0": 
+        "-Wvector-operation-performance",
+    ,
+    "4.8.0": 
+        "-Wsuggest-attribute=format",
+    ,
+    "4.9.0": 
+        "-Wdate-time",
+    ,
+    "5.1.0": 
+        "-Wformat-signedness",
+        "-Wnormalized=nfc",
+    ,
+    "6.1.0": 
+        "-Wduplicated-cond",
+        "-Wnull-dereference",
+        "-Wshift-negative-value",
+        "-Wshift-overflow=2",
+        "-Wunused-const-variable=2",
+    ,
+    "7.1.0": 
+        "-Walloca",
+        "-Walloc-zero",
+        "-Wformat-overflow=2",
+        "-Wformat-truncation=2",
+        "-Wstringop-overflow=3",
+    ,
+    "7.2.0": 
+        "-Wduplicated-branches",
+    ,
+    "8.1.0": 
+        "-Wattribute-alias=2",
+        "-Wcast-align=strict",
+        "-Wsuggest-attribute=cold",
+        "-Wsuggest-attribute=malloc",
+    ,
+    "10.1.0": 
+        "-Wanalyzer-too-complex",
+        "-Warith-conversion",
+    ,
+    "12.1.0": 
+        "-Wbidi-chars=ucn",
+        "-Wopenacc-parallelism",
+        "-Wtrivial-auto-var-init",
+    ,
+}  # type: T.Dictstr, T.Liststr
+
+# GCC warnings for C
+# Omitted non-general or legacy warnings:
+#   -Wc11-c2x-compat
+#   -Wc90-c99-compat
+#   -Wc99-c11-compat
+#   -Wdeclaration-after-statement
+#   -Wtraditional
+#   -Wtraditional-conversion
+gnu_c_warning_args = {
+    "0.0.0": 
+        "-Wbad-function-cast",
+        "-Wmissing-prototypes",
+        "-Wnested-externs",
+        "-Wstrict-prototypes",
+    ,
+    "3.4.0": 
+        "-Wold-style-definition",
+        "-Winit-self",
+    ,
+    "4.1.0": 
+        "-Wc++-compat",
+    ,
+    "4.5.0": 
+        "-Wunsuffixed-float-constants",
+    ,
+}  # type: T.Dictstr, T.Liststr
+
+# GCC warnings for C++
+# Omitted non-general or legacy warnings:
+#   -Wc++0x-compat
+#   -Wc++1z-compat
+#   -Wc++2a-compat
+#   -Wctad-maybe-unsupported
+#   -Wnamespaces
+#   -Wtemplates
+gnu_cpp_warning_args = {
+    "0.0.0": 
+        "-Wctor-dtor-privacy",
+        "-Weffc++",
+        "-Wnon-virtual-dtor",
+        "-Wold-style-cast",
+        "-Woverloaded-virtual",
+        "-Wsign-promo",
+    ,
+    "4.0.1": 
+        "-Wstrict-null-sentinel",
+    ,
+    "4.6.0": 
+        "-Wnoexcept",
+    ,
+    "4.7.0": 
+        "-Wzero-as-null-pointer-constant",
+    ,
+    "4.8.0": 
+        "-Wabi-tag",
+        "-Wuseless-cast",
+    ,
+    "4.9.0": 
+        "-Wconditionally-supported",
+    ,
+    "5.1.0": 
+        "-Wsuggest-final-methods",
+        "-Wsuggest-final-types",
+        "-Wsuggest-override",
+    ,
+    "6.1.0": 
+        "-Wmultiple-inheritance",
+        "-Wplacement-new=2",
+        "-Wvirtual-inheritance",
+    ,
+    "7.1.0": 
+        "-Waligned-new=all",
+        "-Wnoexcept-type",
+        "-Wregister",
+    ,
+    "8.1.0": 
+        "-Wcatch-value=3",
+        "-Wextra-semi",
+    ,
+    "9.1.0": 
+        "-Wdeprecated-copy-dtor",
+        "-Wredundant-move",
+    ,
+    "10.1.0": 
+        "-Wcomma-subscript",
+        "-Wmismatched-tags",
+        "-Wredundant-tags",
+        "-Wvolatile",
+    ,
+    "11.1.0": 
+        "-Wdeprecated-enum-enum-conversion",
+        "-Wdeprecated-enum-float-conversion",
+        "-Winvalid-imported-macros",
+    ,
+}  # type: T.Dictstr, T.Liststr
+
+# GCC warnings for Objective C and Objective C++
+# Omitted non-general or legacy warnings:
+#   -Wtraditional
+#   -Wtraditional-conversion
+gnu_objc_warning_args = {
+    "0.0.0": 
+        "-Wselector",
+    ,
+    "3.3": 
+        "-Wundeclared-selector",
+    ,
+    "4.1.0": 
+        "-Wassign-intercept",
+        "-Wstrict-selector-match",
+    ,
+}  # type: T.Dictstr, T.Liststr
+
 
 @functools.lru_cache(maxsize=None)
 def gnulike_default_include_dirs(compiler: T.Tuplestr, ..., lang: str) -> 'ImmutableListProtocolstr':
@@ -183,7 +417,7 @@
         return gnulike_instruction_set_args.get(instruction_set, None)
 
     def get_default_include_dirs(self) -> T.Liststr:
-        return gnulike_default_include_dirs(tuple(self.exelist), self.language).copy()
+        return gnulike_default_include_dirs(tuple(self.get_exelist(ccache=False)), self.language).copy()
 
     @abc.abstractmethod
     def openmp_flags(self) -> T.Liststr:
@@ -211,7 +445,7 @@
         return '-fprofile-generate'
 
     def get_profile_use_args(self) -> T.Liststr:
-        return '-fprofile-use', '-fprofile-correction'
+        return '-fprofile-use'
 
     def get_gui_app_args(self, value: bool) -> T.Liststr:
         return '-mwindows' if value else '-mconsole'
@@ -317,6 +551,12 @@
     def get_coverage_args(self) -> T.Liststr:
         return '--coverage'
 
+    def get_preprocess_to_file_args(self) -> T.Liststr:
+        # We want to allow preprocessing files with any extension, such as
+        # foo.c.in. In that case we need to tell GCC/CLANG to treat them as
+        # assembly file.
+        return self.get_preprocess_only_args() + '-x', 'assembler-with-cpp'
+
 
 class GnuCompiler(GnuLikeCompiler):
     """
@@ -344,6 +584,13 @@
             argsargs.index('-Wpedantic') = '-pedantic'
         return args
 
+    def supported_warn_args(self, warn_args_by_version: T.Dictstr, T.Liststr) -> T.Liststr:
+        result = 
+        for version, warn_args in warn_args_by_version.items():
+            if mesonlib.version_compare(self.version, '>=' + version):
+                result += warn_args
+        return result
+
     def has_builtin_define(self, define: str) -> bool:
         return define in self.defines
 
@@ -397,3 +644,6 @@
         if linker == 'mold' and mesonlib.version_compare(version, '>=12.0.1'):
             return '-fuse-ld=mold'
         return super().use_linker_args(linker, version)
+
+    def get_profile_use_args(self) -> T.Liststr:
+        return super().get_profile_use_args() + '-fprofile-correction'

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/compilers/mixins/intel.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/compilers/mixins/intel.py Changed

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/compilers/mixins/islinker.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/compilers/mixins/islinker.py Changed

@@ -11,6 +11,7 @@
 # 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.
+from __future__ import annotations
 
 """Mixins for compilers that *are* linkers.
 
@@ -48,7 +49,8 @@
     def sanitizer_link_args(self, value: str) -> T.Liststr:
         return 
 
-    def get_lto_link_args(self, *, threads: int = 0, mode: str = 'default') -> T.Liststr:
+    def get_lto_link_args(self, *, threads: int = 0, mode: str = 'default',
+                          thinlto_cache_dir: T.Optionalstr = None) -> T.Liststr:
         return 
 
     def can_linker_accept_rsp(self) -> bool:
@@ -57,7 +59,7 @@
     def get_linker_exelist(self) -> T.Liststr:
         return self.exelist.copy()
 
-    def get_linker_output_args(self, output: str) -> T.Liststr:
+    def get_linker_output_args(self, outputname: str) -> T.Liststr:
         return 
 
     def get_linker_always_args(self) -> T.Liststr:
@@ -118,7 +120,7 @@
     def get_buildtype_linker_args(self, buildtype: str) -> T.Liststr:
         return 
 
-    def get_link_debugfile_name(self, target: str) -> str:
+    def get_link_debugfile_name(self, targetfile: str) -> str:
         return ''
 
     def thread_flags(self, env: 'Environment') -> T.Liststr:

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/compilers/mixins/pgi.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/compilers/mixins/pgi.py Changed

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/compilers/mixins/ti.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/compilers/mixins/ti.py Changed

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/compilers/mixins/visualstudio.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/compilers/mixins/visualstudio.py Changed

@@ -11,6 +11,7 @@
 # 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.
+from __future__ import annotations
 
 """Abstractions to simplify compilers that implement an MSVC compatible
 interface.
@@ -62,6 +63,7 @@
 }  # T.Dicststr, T.OptionalT.Liststr
 
 msvc_optimization_args = {
+    'plain': ,
     '0': '/Od',
     'g': , # No specific flag to optimize debugging, /Zi or /ZI will create debug information
     '1': '/O1',
@@ -103,12 +105,15 @@
     # See: https://ninja-build.org/manual.html#_deps
     # Assume UTF-8 sources by default, but self.unix_args_to_native() removes it
     # if `/source-charset` is set too.
+    # It is also dropped if Visual Studio 2013 or earlier is used, since it would
+    # not be supported in that case.
     always_args = '/nologo', '/showIncludes', '/utf-8'
     warn_args = {
         '0': ,
         '1': '/W2',
         '2': '/W3',
         '3': '/W4',
+        'everything': '/Wall',
     }  # type: T.Dictstr, T.Liststr
 
     INVOKES_LINKER = False
@@ -135,7 +140,8 @@
 
     # Override CCompiler.get_always_args
     def get_always_args(self) -> T.Liststr:
-        return self.always_args
+        # TODO: use ImmutableListProtocolstr here instead
+        return self.always_args.copy()
 
     def get_pch_suffix(self) -> str:
         return 'pch'
@@ -158,6 +164,9 @@
     def get_preprocess_only_args(self) -> T.Liststr:
         return '/EP'
 
+    def get_preprocess_to_file_args(self) -> T.Liststr:
+        return '/EP', '/P'
+
     def get_compile_only_args(self) -> T.Liststr:
         return '/c'
 
@@ -172,6 +181,8 @@
         return '/fsanitize=address'
 
     def get_output_args(self, target: str) -> T.Liststr:
+        if self.mode == 'PREPROCESSOR':
+            return '/Fi' + target
         if target.endswith('.exe'):
             return '/Fe' + target
         return '/Fo' + target
@@ -221,7 +232,7 @@
         for i in args:
             # -mms-bitfields is specific to MinGW-GCC
             # -pthread is only valid for GCC
-            if i in ('-mms-bitfields', '-pthread'):
+            if i in {'-mms-bitfields', '-pthread'}:
                 continue
             if i.startswith('-LIBPATH:'):
                 i = '/LIBPATH:' + i9:
@@ -253,7 +264,9 @@
                 continue
             # cl.exe does not allow specifying both, so remove /utf-8 that we
             # added automatically in the case the user overrides it manually.
-            elif i.startswith('/source-charset:') or i.startswith('/execution-charset:'):
+            elif (i.startswith('/source-charset:')
+                    or i.startswith('/execution-charset:')
+                    or i == '/validate-charset-'):
                 try:
                     result.remove('/utf-8')
                 except ValueError:
@@ -299,7 +312,7 @@
         with self._build_wrapper(code, env, extra_args=args, mode=mode) as p:
             if p.returncode != 0:
                 return False, p.cached
-            return not(warning_text in p.stderr or warning_text in p.stdout), p.cached
+            return not (warning_text in p.stderr or warning_text in p.stdout), p.cached
 
     def get_compile_debugfile_args(self, rel_obj: str, pch: bool = False) -> T.Liststr:
         pdbarr = rel_obj.split('.'):-1
@@ -354,7 +367,7 @@
     def get_crt_compile_args(self, crt_val: str, buildtype: str) -> T.Liststr:
         if crt_val in self.crt_args:
             return self.crt_argscrt_val
-        assert crt_val in 'from_buildtype', 'static_from_buildtype'
+        assert crt_val in {'from_buildtype', 'static_from_buildtype'}
         dbg = 'mdd'
         rel = 'md'
         if crt_val == 'static_from_buildtype':
@@ -378,7 +391,7 @@
     def has_func_attribute(self, name: str, env: 'Environment') -> T.Tuplebool, bool:
         # MSVC doesn't have __attribute__ like Clang and GCC do, so just return
         # false without compiling anything
-        return name in 'dllimport', 'dllexport', False
+        return name in {'dllimport', 'dllexport'}, False
 
     def get_argument_syntax(self) -> str:
         return 'msvc'
@@ -407,6 +420,15 @@
 
     id = 'msvc'
 
+    def __init__(self, target: str):
+        super().__init__(target)
+
+        # Visual Studio 2013 and erlier don't support the /utf-8 argument.
+        # We want to remove it. We also want to make an explicit copy so we
+        # don't mutate class constant state
+        if mesonlib.version_compare(self.version, '<19.00') and '/utf-8' in self.always_args:
+            self.always_args = r for r in self.always_args if r != '/utf-8'
+
     def get_compile_debugfile_args(self, rel_obj: str, pch: bool = False) -> T.Liststr:
         args = super().get_compile_debugfile_args(rel_obj, pch)
         # When generating a PDB file with PCH, all compile commands write
@@ -419,6 +441,11 @@
             args = '/FS' + args
         return args
 
+    # Override CCompiler.get_always_args
+    # We want to drop '/utf-8' for Visual Studio 2013 and earlier
+    def get_always_args(self) -> T.Liststr:
+        return self.always_args
+
     def get_instruction_set_args(self, instruction_set: str) -> T.OptionalT.Liststr:
         if self.version.split('.')0 == '16' and instruction_set == 'avx':
             # VS documentation says that this exists and should work, but

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/compilers/mixins/xc16.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/compilers/mixins/xc16.py Changed

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/compilers/objc.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/compilers/objc.py Changed

@@ -11,15 +11,16 @@
 # 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.
+from __future__ import annotations
 
 import typing as T
 
 from .. import coredata
-from ..mesonlib import MachineChoice, OptionKey
+from ..mesonlib import OptionKey
 
 from .compilers import Compiler
 from .mixins.clike import CLikeCompiler
-from .mixins.gnu import GnuCompiler
+from .mixins.gnu import GnuCompiler, gnu_common_warning_args, gnu_objc_warning_args
 from .mixins.clang import ClangCompiler
 
 if T.TYPE_CHECKING:
@@ -27,18 +28,19 @@
     from ..envconfig import MachineInfo
     from ..environment import Environment
     from ..linkers import DynamicLinker
+    from ..mesonlib import MachineChoice
 
 
 class ObjCCompiler(CLikeCompiler, Compiler):
 
     language = 'objc'
 
-    def __init__(self, exelist: T.Liststr, version: str, for_machine: MachineChoice,
+    def __init__(self, ccache: T.Liststr, exelist: T.Liststr, version: str, for_machine: MachineChoice,
                  is_cross: bool, info: 'MachineInfo',
                  exe_wrap: T.Optional'ExternalProgram',
                  linker: T.Optional'DynamicLinker' = None,
                  full_version: T.Optionalstr = None):
-        Compiler.__init__(self, exelist, version, for_machine, info,
+        Compiler.__init__(self, ccache, exelist, version, for_machine, info,
                           is_cross=is_cross, full_version=full_version,
                           linker=linker)
         CLikeCompiler.__init__(self, exe_wrap)
@@ -53,37 +55,41 @@
 
 
 class GnuObjCCompiler(GnuCompiler, ObjCCompiler):
-    def __init__(self, exelist: T.Liststr, version: str, for_machine: MachineChoice,
+    def __init__(self, ccache: T.Liststr, exelist: T.Liststr, version: str, for_machine: MachineChoice,
                  is_cross: bool, info: 'MachineInfo',
                  exe_wrapper: T.Optional'ExternalProgram' = None,
                  defines: T.OptionalT.Dictstr, str = None,
                  linker: T.Optional'DynamicLinker' = None,
                  full_version: T.Optionalstr = None):
-        ObjCCompiler.__init__(self, exelist, version, for_machine, is_cross,
+        ObjCCompiler.__init__(self, ccache, exelist, version, for_machine, is_cross,
                               info, exe_wrapper, linker=linker, full_version=full_version)
         GnuCompiler.__init__(self, defines)
         default_warn_args = '-Wall', '-Winvalid-pch'
         self.warn_args = {'0': ,
                           '1': default_warn_args,
                           '2': default_warn_args + '-Wextra',
-                          '3': default_warn_args + '-Wextra', '-Wpedantic'}
+                          '3': default_warn_args + '-Wextra', '-Wpedantic',
+                          'everything': (default_warn_args + '-Wextra', '-Wpedantic' +
+                                         self.supported_warn_args(gnu_common_warning_args) +
+                                         self.supported_warn_args(gnu_objc_warning_args))}
 
 
 class ClangObjCCompiler(ClangCompiler, ObjCCompiler):
-    def __init__(self, exelist: T.Liststr, version: str, for_machine: MachineChoice,
+    def __init__(self, ccache: T.Liststr, exelist: T.Liststr, version: str, for_machine: MachineChoice,
                  is_cross: bool, info: 'MachineInfo',
                  exe_wrapper: T.Optional'ExternalProgram' = None,
                  defines: T.OptionalT.Dictstr, str = None,
                  linker: T.Optional'DynamicLinker' = None,
                  full_version: T.Optionalstr = None):
-        ObjCCompiler.__init__(self, exelist, version, for_machine, is_cross,
+        ObjCCompiler.__init__(self, ccache, exelist, version, for_machine, is_cross,
                               info, exe_wrapper, linker=linker, full_version=full_version)
         ClangCompiler.__init__(self, defines)
         default_warn_args = '-Wall', '-Winvalid-pch'
         self.warn_args = {'0': ,
                           '1': default_warn_args,
                           '2': default_warn_args + '-Wextra',
-                          '3': default_warn_args + '-Wextra', '-Wpedantic'}
+                          '3': default_warn_args + '-Wextra', '-Wpedantic',
+                          'everything': '-Weverything'}
 
     def get_options(self) -> 'coredata.MutableKeyedOptionDictType':
         opts = super().get_options()

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/compilers/objcpp.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/compilers/objcpp.py Changed

@@ -11,15 +11,16 @@
 # 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.
+from __future__ import annotations
 
 import typing as T
 
 from .. import coredata
-from ..mesonlib import MachineChoice, OptionKey
+from ..mesonlib import OptionKey
 
 from .mixins.clike import CLikeCompiler
 from .compilers import Compiler
-from .mixins.gnu import GnuCompiler
+from .mixins.gnu import GnuCompiler, gnu_common_warning_args, gnu_objc_warning_args
 from .mixins.clang import ClangCompiler
 
 if T.TYPE_CHECKING:
@@ -27,17 +28,18 @@
     from ..envconfig import MachineInfo
     from ..environment import Environment
     from ..linkers import DynamicLinker
+    from ..mesonlib import MachineChoice
 
 class ObjCPPCompiler(CLikeCompiler, Compiler):
 
     language = 'objcpp'
 
-    def __init__(self, exelist: T.Liststr, version: str, for_machine: MachineChoice,
+    def __init__(self, ccache: T.Liststr, exelist: T.Liststr, version: str, for_machine: MachineChoice,
                  is_cross: bool, info: 'MachineInfo',
                  exe_wrap: T.Optional'ExternalProgram',
                  linker: T.Optional'DynamicLinker' = None,
                  full_version: T.Optionalstr = None):
-        Compiler.__init__(self, exelist, version, for_machine, info,
+        Compiler.__init__(self, ccache, exelist, version, for_machine, info,
                           is_cross=is_cross, full_version=full_version,
                           linker=linker)
         CLikeCompiler.__init__(self, exe_wrap)
@@ -52,38 +54,42 @@
 
 
 class GnuObjCPPCompiler(GnuCompiler, ObjCPPCompiler):
-    def __init__(self, exelist: T.Liststr, version: str, for_machine: MachineChoice,
+    def __init__(self, ccache: T.Liststr, exelist: T.Liststr, version: str, for_machine: MachineChoice,
                  is_cross: bool, info: 'MachineInfo',
                  exe_wrapper: T.Optional'ExternalProgram' = None,
                  defines: T.OptionalT.Dictstr, str = None,
                  linker: T.Optional'DynamicLinker' = None,
                  full_version: T.Optionalstr = None):
-        ObjCPPCompiler.__init__(self, exelist, version, for_machine, is_cross,
+        ObjCPPCompiler.__init__(self, ccache, exelist, version, for_machine, is_cross,
                                 info, exe_wrapper, linker=linker, full_version=full_version)
         GnuCompiler.__init__(self, defines)
-        default_warn_args = '-Wall', '-Winvalid-pch', '-Wnon-virtual-dtor'
+        default_warn_args = '-Wall', '-Winvalid-pch'
         self.warn_args = {'0': ,
                           '1': default_warn_args,
                           '2': default_warn_args + '-Wextra',
-                          '3': default_warn_args + '-Wextra', '-Wpedantic'}
+                          '3': default_warn_args + '-Wextra', '-Wpedantic',
+                          'everything': (default_warn_args + '-Wextra', '-Wpedantic' +
+                                         self.supported_warn_args(gnu_common_warning_args) +
+                                         self.supported_warn_args(gnu_objc_warning_args))}
 
 
 class ClangObjCPPCompiler(ClangCompiler, ObjCPPCompiler):
 
-    def __init__(self, exelist: T.Liststr, version: str, for_machine: MachineChoice,
+    def __init__(self, ccache: T.Liststr, exelist: T.Liststr, version: str, for_machine: MachineChoice,
                  is_cross: bool, info: 'MachineInfo',
                  exe_wrapper: T.Optional'ExternalProgram' = None,
                  defines: T.OptionalT.Dictstr, str = None,
                  linker: T.Optional'DynamicLinker' = None,
                  full_version: T.Optionalstr = None):
-        ObjCPPCompiler.__init__(self, exelist, version, for_machine, is_cross,
+        ObjCPPCompiler.__init__(self, ccache, exelist, version, for_machine, is_cross,
                                 info, exe_wrapper, linker=linker, full_version=full_version)
         ClangCompiler.__init__(self, defines)
-        default_warn_args = '-Wall', '-Winvalid-pch', '-Wnon-virtual-dtor'
+        default_warn_args = '-Wall', '-Winvalid-pch'
         self.warn_args = {'0': ,
                           '1': default_warn_args,
                           '2': default_warn_args + '-Wextra',
-                          '3': default_warn_args + '-Wextra', '-Wpedantic'}
+                          '3': default_warn_args + '-Wextra', '-Wpedantic',
+                          'everything': '-Weverything'}
 
     def get_options(self) -> 'coredata.MutableKeyedOptionDictType':
         opts = super().get_options()

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/compilers/rust.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/compilers/rust.py Changed

@@ -31,6 +31,7 @@
 
 
 rust_optimization_args = {
+    'plain': ,
     '0': ,
     'g': '-C', 'opt-level=0',
     '1': '-C', 'opt-level=1',
@@ -57,7 +58,7 @@
                  exe_wrapper: T.Optional'ExternalProgram' = None,
                  full_version: T.Optionalstr = None,
                  linker: T.Optional'DynamicLinker' = None):
-        super().__init__(exelist, version, for_machine, info,
+        super().__init__(, exelist, version, for_machine, info,
                          is_cross=is_cross, full_version=full_version,
                          linker=linker)
         self.exe_wrapper = exe_wrapper
@@ -109,9 +110,9 @@
         return rust_buildtype_argsbuildtype
 
     def get_sysroot(self) -> str:
-        cmd = self.exelist + '--print', 'sysroot'
+        cmd = self.get_exelist(ccache=False) + '--print', 'sysroot'
         p, stdo, stde = Popen_safe(cmd)
-        return stdo.split('\n')0
+        return stdo.split('\n', maxsplit=1)0
 
     def get_debug_args(self, is_debug: bool) -> T.Liststr:
         return clike_debug_argsis_debug

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/compilers/swift.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/compilers/swift.py Changed

@@ -11,11 +11,12 @@
 # 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.
+from __future__ import annotations
 
 import subprocess, os.path
 import typing as T
 
-from ..mesonlib import EnvironmentException, MachineChoice
+from ..mesonlib import EnvironmentException
 
 from .compilers import Compiler, swift_buildtype_args, clike_debug_args
 
@@ -23,8 +24,10 @@
     from ..envconfig import MachineInfo
     from ..environment import Environment
     from ..linkers import DynamicLinker
+    from ..mesonlib import MachineChoice
 
 swift_optimization_args = {
+    'plain': ,
     '0': ,
     'g': ,
     '1': '-O',
@@ -42,7 +45,7 @@
     def __init__(self, exelist: T.Liststr, version: str, for_machine: MachineChoice,
                  is_cross: bool, info: 'MachineInfo', full_version: T.Optionalstr = None,
                  linker: T.Optional'DynamicLinker' = None):
-        super().__init__(exelist, version, for_machine, info,
+        super().__init__(, exelist, version, for_machine, info,
                          is_cross=is_cross, full_version=full_version,
                          linker=linker)
         self.version = version
@@ -56,7 +59,7 @@
     def get_dependency_gen_args(self, outtarget: str, outfile: str) -> T.Liststr:
         return '-emit-dependencies'
 
-    def depfile_for_object(self, objfile: str) -> str:
+    def depfile_for_object(self, objfile: str) -> T.Optionalstr:
         return os.path.splitext(objfile)0 + '.' + self.get_depfile_suffix()
 
     def get_depfile_suffix(self) -> str:

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/compilers/vala.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/compilers/vala.py Changed

@@ -11,18 +11,20 @@
 # 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.
+from __future__ import annotations
 
 import os.path
 import typing as T
 
 from .. import mlog
-from ..mesonlib import EnvironmentException, MachineChoice, version_compare, OptionKey
+from ..mesonlib import EnvironmentException, version_compare, OptionKey
 
 from .compilers import Compiler, LibType
 
 if T.TYPE_CHECKING:
     from ..envconfig import MachineInfo
     from ..environment import Environment
+    from ..mesonlib import MachineChoice
 
 class ValaCompiler(Compiler):
 
@@ -31,7 +33,7 @@
 
     def __init__(self, exelist: T.Liststr, version: str, for_machine: MachineChoice,
                  is_cross: bool, info: 'MachineInfo'):
-        super().__init__(exelist, version, for_machine, info, is_cross=is_cross)
+        super().__init__(, exelist, version, for_machine, info, is_cross=is_cross)
         self.version = version
         self.base_options = {OptionKey('b_colorout')}

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/coredata.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/coredata.py Changed

@@ -11,6 +11,7 @@
 # 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.
+from __future__ import annotations
 
 from . import mlog, mparser
 import pickle, os, uuid
@@ -22,8 +23,10 @@
     HoldableObject,
     MesonException, EnvironmentException, MachineChoice, PerMachine,
     PerMachineDefaultable, default_libdir, default_libexecdir,
-    default_prefix, split_args, OptionKey, OptionType, stringlistify,
-    pickle_load
+    default_prefix, default_datadir, default_includedir, default_infodir,
+    default_localedir, default_mandir, default_sbindir, default_sysconfdir,
+    split_args, OptionKey, OptionType, stringlistify,
+    pickle_load, replace_if_different
 )
 from .wrap import WrapMode
 import ast
@@ -53,7 +56,7 @@
 #
 # Pip requires that RCs are named like this: '0.1.0.rc1'
 # But the corresponding Git tag needs to be '0.1.0rc1'
-version = '0.63.2'
+version = '1.0.1'
 
 backendlist = 'ninja', 'vs', 'vs2010', 'vs2012', 'vs2013', 'vs2015', 'vs2017', 'vs2019', 'vs2022', 'xcode'
 
@@ -693,7 +696,7 @@
         result = 
         value = self.optionsOptionKey('buildtype').value
         if value == 'plain':
-            opt = '0'
+            opt = 'plain'
             debug = False
         elif value == 'debug':
             opt = '0'
@@ -720,7 +723,7 @@
 
     def _set_others_from_buildtype(self, value: str) -> None:
         if value == 'plain':
-            opt = '0'
+            opt = 'plain'
             debug = False
         elif value == 'debug':
             opt = '0'
@@ -821,7 +824,7 @@
                 continue
             elif k in self.options:
                 self.set_option(k, v)
-            elif k.machine != MachineChoice.BUILD:
+            elif k.machine != MachineChoice.BUILD and k.type != OptionType.COMPILER:
                 unknown_options.append(k)
         if unknown_options:
             unknown_options_str = ', '.join(sorted(str(s) for s in unknown_options))
@@ -1035,9 +1038,9 @@
 def format_cmd_line_options(options: argparse.Namespace) -> str:
     cmdline = '-D{}={}'.format(str(k), v) for k, v in options.cmd_line_options.items()
     if options.cross_file:
-        cmdline += f'--cross-file {f}' for f in options.cross_file
+        cmdline += f'--cross-file={f}' for f in options.cross_file
     if options.native_file:
-        cmdline += f'--native-file {f}' for f in options.native_file
+        cmdline += f'--native-file={f}' for f in options.native_file
     return ' '.join(shlex.quote(x) for x in cmdline)
 
 def major_versions_differ(v1: str, v2: str) -> bool:
@@ -1066,7 +1069,7 @@
         pickle.dump(obj, f)
         f.flush()
         os.fsync(f.fileno())
-    os.replace(tempfilename, filename)
+    replace_if_different(filename, tempfilename)
     return filename
 
 
@@ -1193,17 +1196,17 @@
 BUILTIN_DIR_OPTIONS: 'MutableKeyedOptionDictType' = OrderedDict(
     (OptionKey('prefix'),          BuiltinOption(UserStringOption, 'Installation prefix', default_prefix())),
     (OptionKey('bindir'),          BuiltinOption(UserStringOption, 'Executable directory', 'bin')),
-    (OptionKey('datadir'),         BuiltinOption(UserStringOption, 'Data file directory', 'share')),
-    (OptionKey('includedir'),      BuiltinOption(UserStringOption, 'Header file directory', 'include')),
-    (OptionKey('infodir'),         BuiltinOption(UserStringOption, 'Info page directory', 'share/info')),
+    (OptionKey('datadir'),         BuiltinOption(UserStringOption, 'Data file directory', default_datadir())),
+    (OptionKey('includedir'),      BuiltinOption(UserStringOption, 'Header file directory', default_includedir())),
+    (OptionKey('infodir'),         BuiltinOption(UserStringOption, 'Info page directory', default_infodir())),
     (OptionKey('libdir'),          BuiltinOption(UserStringOption, 'Library directory', default_libdir())),
     (OptionKey('libexecdir'),      BuiltinOption(UserStringOption, 'Library executable directory', default_libexecdir())),
-    (OptionKey('localedir'),       BuiltinOption(UserStringOption, 'Locale data directory', 'share/locale')),
+    (OptionKey('localedir'),       BuiltinOption(UserStringOption, 'Locale data directory', default_localedir())),
     (OptionKey('localstatedir'),   BuiltinOption(UserStringOption, 'Localstate data directory', 'var')),
-    (OptionKey('mandir'),          BuiltinOption(UserStringOption, 'Manual page directory', 'share/man')),
-    (OptionKey('sbindir'),         BuiltinOption(UserStringOption, 'System executable directory', 'sbin')),
+    (OptionKey('mandir'),          BuiltinOption(UserStringOption, 'Manual page directory', default_mandir())),
+    (OptionKey('sbindir'),         BuiltinOption(UserStringOption, 'System executable directory', default_sbindir())),
     (OptionKey('sharedstatedir'),  BuiltinOption(UserStringOption, 'Architecture-independent data directory', 'com')),
-    (OptionKey('sysconfdir'),      BuiltinOption(UserStringOption, 'Sysconf data directory', 'etc')),
+    (OptionKey('sysconfdir'),      BuiltinOption(UserStringOption, 'Sysconf data directory', default_sysconfdir())),
 )
 
 BUILTIN_CORE_OPTIONS: 'MutableKeyedOptionDictType' = OrderedDict(
@@ -1217,13 +1220,13 @@
     (OptionKey('errorlogs'),       BuiltinOption(UserBooleanOption, "Whether to print the logs from failing tests", True)),
     (OptionKey('install_umask'),   BuiltinOption(UserUmaskOption, 'Default umask to apply on permissions of installed files', '022')),
     (OptionKey('layout'),          BuiltinOption(UserComboOption, 'Build directory layout', 'mirror', choices='mirror', 'flat')),
-    (OptionKey('optimization'),    BuiltinOption(UserComboOption, 'Optimization level', '0', choices='0', 'g', '1', '2', '3', 's')),
+    (OptionKey('optimization'),    BuiltinOption(UserComboOption, 'Optimization level', '0', choices='plain', '0', 'g', '1', '2', '3', 's')),
     (OptionKey('prefer_static'),   BuiltinOption(UserBooleanOption, 'Whether to try static linking before shared linking', False)),
     (OptionKey('stdsplit'),        BuiltinOption(UserBooleanOption, 'Split stdout and stderr in test logs', True)),
     (OptionKey('strip'),           BuiltinOption(UserBooleanOption, 'Strip targets on install', False)),
     (OptionKey('unity'),           BuiltinOption(UserComboOption, 'Unity build', 'off', choices='on', 'off', 'subprojects')),
     (OptionKey('unity_size'),      BuiltinOption(UserIntegerOption, 'Unity block size', (2, None, 4))),
-    (OptionKey('warning_level'),   BuiltinOption(UserComboOption, 'Compiler warning level to use', '1', choices='0', '1', '2', '3', yielding=False)),
+    (OptionKey('warning_level'),   BuiltinOption(UserComboOption, 'Compiler warning level to use', '1', choices='0', '1', '2', '3', 'everything', yielding=False)),
     (OptionKey('werror'),          BuiltinOption(UserBooleanOption, 'Treat warnings as errors', False, yielding=False)),
     (OptionKey('wrap_mode'),       BuiltinOption(UserComboOption, 'Wrap mode', 'default', choices='default', 'nofallback', 'nodownload', 'forcefallback', 'nopromote')),
     (OptionKey('force_fallback_for'), BuiltinOption(UserArrayOption, 'Force fallback for those subprojects', )),

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/dependencies/__init__.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/dependencies/__init__.py Changed

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/dependencies/base.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/dependencies/base.py Changed

@@ -46,6 +46,19 @@
     '''Exceptions raised while trying to find dependencies'''
 
 
+class MissingCompiler:
+    """Represent a None Compiler - when no tool chain is found.
+    replacing AttributeError with DependencyException"""
+
+    def __getattr__(self, item: str) -> T.Any:
+        if item.startswith('__'):
+            raise AttributeError()
+        raise DependencyException('no toolchain found')
+
+    def __bool__(self) -> bool:
+        return False
+
+
 class DependencyMethods(Enum):
     # Auto means to use whatever dependency checking mechanisms in whatever order meson thinks is best.
     AUTO = 'auto'
@@ -261,7 +274,7 @@
         assert isinstance(result, InternalDependency)
         memoid(self) = result
         for k, v in self.__dict__.items():
-            if k in 'libraries', 'whole_libraries':
+            if k in {'libraries', 'whole_libraries'}:
                 setattr(result, k, copy.copy(v))
             else:
                 setattr(result, k, copy.deepcopy(v, memo))
@@ -361,7 +374,7 @@
         HasNativeKwarg.__init__(self, kwargs)
         self.clib_compiler = detect_compiler(self.name, environment, self.for_machine, self.language)
 
-    def get_compiler(self) -> 'Compiler':
+    def get_compiler(self) -> T.Union'MissingCompiler', 'Compiler':
         return self.clib_compiler
 
     def get_partial_dependency(self, *, compile_args: bool = False,
@@ -387,7 +400,8 @@
     def log_info(self) -> str:
         return ''
 
-    def log_tried(self) -> str:
+    @staticmethod
+    def log_tried() -> str:
         return ''
 
     # Check if dependency version meets the requirements
@@ -405,7 +419,7 @@
                 mlog.log(*found_msg)
 
                 if self.required:
-                    m = f'Unknown version of dependency {self.name!r}, but need {self.version_reqs!r}.'
+                    m = f'Unknown version, but need {self.version_reqs!r}.'
                     raise DependencyException(m)
 
             else:
@@ -422,7 +436,7 @@
                     mlog.log(*found_msg)
 
                     if self.required:
-                        m = 'Invalid version of dependency, need {!r} {!r} found {!r}.'
+                        m = 'Invalid version, need {!r} {!r} found {!r}.'
                         raise DependencyException(m.format(self.name, not_found, self.version))
                     return
 
@@ -572,7 +586,7 @@
     return methods
 
 def detect_compiler(name: str, env: 'Environment', for_machine: MachineChoice,
-                    language: T.Optionalstr) -> T.Optional'Compiler':
+                    language: T.Optionalstr) -> T.Union'MissingCompiler', 'Compiler':
     """Given a language and environment find the compiler used."""
     compilers = env.coredata.compilersfor_machine
 
@@ -590,7 +604,7 @@
                 return compilerslang
             except KeyError:
                 continue
-    return None
+    return MissingCompiler()
 
 
 class SystemDependency(ExternalDependency):
@@ -602,7 +616,8 @@
         super().__init__(DependencyTypeName('system'), env, kwargs, language=language)
         self.name = name
 
-    def log_tried(self) -> str:
+    @staticmethod
+    def log_tried() -> str:
         return 'system'
 
 
@@ -615,5 +630,6 @@
         super().__init__(DependencyTypeName('builtin'), env, kwargs, language=language)
         self.name = name
 
-    def log_tried(self) -> str:
+    @staticmethod
+    def log_tried() -> str:
         return 'builtin'

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/dependencies/boost.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/dependencies/boost.py Changed

@@ -152,9 +152,9 @@
             self.version_lib = '{}_{}'.format(self.vers_raw0, self.vers_raw1)
 
         # Detecting library type
-        if self.nvsuffix in 'so', 'dll', 'dll.a', 'dll.lib', 'dylib':
+        if self.nvsuffix in {'so', 'dll', 'dll.a', 'dll.lib', 'dylib'}:
             self.static = False
-        elif self.nvsuffix in 'a', 'lib':
+        elif self.nvsuffix in {'a', 'lib'}:
             self.static = True
         else:
             raise UnknownFileException(self.path)
@@ -177,7 +177,7 @@
         for i in tags:
             if i == 'mt':
                 self.mt = True
-            elif len(i) == 3 and i1: in '32', '64':
+            elif len(i) == 3 and i1: in {'32', '64'}:
                 self.arch = i
             elif BoostLibraryFile.reg_abi_tag.match(i):
                 self.runtime_static = 's' in i
@@ -237,10 +237,10 @@
         return abitag
 
     def is_boost(self) -> bool:
-        return any(self.name.startswith(x) for x in 'libboost_', 'boost_')
+        return any(self.name.startswith(x) for x in 'libboost_', 'boost_')
 
     def is_python_lib(self) -> bool:
-        return any(self.mod_name.startswith(x) for x in BoostLibraryFile.boost_python_libs)
+        return any(self.mod_name.startswith(x) for x in BoostLibraryFile.boost_python_libs)
 
     def fix_python_name(self, tags: T.Liststr) -> T.Liststr:
         # Handle the boost_python naming madeness.
@@ -316,13 +316,13 @@
         # If no vscrt tag present, assume that it fits  '/MD', '/MDd', '/MT', '/MTd'
         if not vscrt:
             return True
-        if vscrt in '/MD', '-MD':
+        if vscrt in {'/MD', '-MD'}:
             return not self.runtime_static and not self.runtime_debug
-        elif vscrt in '/MDd', '-MDd':
+        elif vscrt in {'/MDd', '-MDd'}:
             return not self.runtime_static and self.runtime_debug
-        elif vscrt in '/MT', '-MT':
+        elif vscrt in {'/MT', '-MT'}:
             return (self.runtime_static or not self.static) and not self.runtime_debug
-        elif vscrt in '/MTd', '-MTd':
+        elif vscrt in {'/MTd', '-MTd'}:
             return (self.runtime_static or not self.static) and self.runtime_debug
 
         mlog.warning(f'Boost: unknown vscrt tag {vscrt}. This may cause the compilation to fail. Please consider reporting this as a bug.', once=True)
@@ -438,7 +438,7 @@
 
         raw_paths = mesonlib.stringlistify(rootdir)
         paths = Path(x) for x in raw_paths
-        if paths and any(not x.is_absolute() for x in paths):
+        if paths and any(not x.is_absolute() for x in paths):
             raise DependencyException('boost_root path given in machine file must be absolute')
 
         self.check_and_set_roots(paths, use_system=False)
@@ -574,13 +574,13 @@
         arch_list_64 = '64'
 
         raw_list = dirs + subdirs
-        no_arch = x for x in raw_list if not any(y in x.name for y in arch_list_32 + arch_list_64)
+        no_arch = x for x in raw_list if not any(y in x.name for y in arch_list_32 + arch_list_64)
 
         matching_arch =   # type: T.ListPath
         if '32' in self.arch:
-            matching_arch = x for x in raw_list if any(y in x.name for y in arch_list_32)
+            matching_arch = x for x in raw_list if any(y in x.name for y in arch_list_32)
         elif '64' in self.arch:
-            matching_arch = x for x in raw_list if any(y in x.name for y in arch_list_64)
+            matching_arch = x for x in raw_list if any(y in x.name for y in arch_list_64)
 
         return sorted(matching_arch) + sorted(no_arch)
 
@@ -626,7 +626,7 @@
         for i in libdir.iterdir():
             if not i.is_file():
                 continue
-            if not any(i.name.startswith(x) for x in 'libboost_', 'boost_'):
+            if not any(i.name.startswith(x) for x in 'libboost_', 'boost_'):
                 continue
             # Windows binaries from SourceForge ship with PDB files alongside
             # DLLs (#8325).  Ignore them.

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/dependencies/cmake.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/dependencies/cmake.py Changed

@@ -106,7 +106,7 @@
         # Store a copy of the CMake path on the object itself so it is
         # stored in the pickled coredata and recovered.
         self.cmakebin:  T.OptionalCMakeExecutor = None
-        self.cmakeinfo: T.OptionalCMakeInfo     = None
+        self.cmakeinfo: T.OptionalCMakeInfo = None
 
         # Where all CMake "build dirs" are located
         self.cmake_root_dir = environment.scratch_dir
@@ -272,7 +272,7 @@
                 content = self._cached_listdir(i)
                 candidates = 'Find{}.cmake', '{}Config.cmake', '{}-config.cmake'
                 candidates = x.format(name).lower() for x in candidates
-                if any(x1 in candidates for x in content):
+                if any(x1 in candidates for x in content):
                     return True
             return False
 
@@ -510,7 +510,7 @@
 
             # Try to use old style variables if no module is specified
             if len(libs) > 0:
-                self.compile_args = list(map(lambda x: f'-I{x}', incDirs)) + defs
+                self.compile_args = f'-I{x}' for x in incDirs + defs
                 self.link_args = 
                 for j in libs:
                     rtgt = resolve_cmake_trace_targets(j, self.traceparser, self.env, clib_compiler=self.clib_compiler)
@@ -548,12 +548,13 @@
                 self.found_modules += i
 
             rtgt = resolve_cmake_trace_targets(i, self.traceparser, self.env,
-                clib_compiler=self.clib_compiler,
-                not_found_warning=lambda x: mlog.warning('CMake: Dependency', mlog.bold(x), 'for', mlog.bold(name), 'was not found')
-            )
-            incDirs        += rtgt.include_directories
+                                               clib_compiler=self.clib_compiler,
+                                               not_found_warning=lambda x:
+                                                   mlog.warning('CMake: Dependency', mlog.bold(x), 'for', mlog.bold(name), 'was not found')
+                                               )
+            incDirs += rtgt.include_directories
             compileOptions += rtgt.public_compile_opts
-            libraries      += rtgt.libraries + rtgt.link_flags
+            libraries += rtgt.libraries + rtgt.link_flags
 
         # Make sure all elements in the lists are unique and sorted
         incDirs = sorted(set(incDirs))
@@ -616,8 +617,9 @@
         build_dir = self._setup_cmake_dir(cmake_file)
         return self.cmakebin.call(args, build_dir, env=env)
 
-    def log_tried(self) -> str:
-        return self.type_name
+    @staticmethod
+    def log_tried() -> str:
+        return 'cmake'
 
     def log_details(self) -> str:
         modules = self._original_module_name(x) for x in self.found_modules

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/dependencies/coarrays.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/dependencies/coarrays.py Changed

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/dependencies/configtool.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/dependencies/configtool.py Changed

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/dependencies/cuda.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/dependencies/cuda.py Changed

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/dependencies/detect.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/dependencies/detect.py Changed

@@ -11,6 +11,7 @@
 # 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.
+from __future__ import annotations
 
 from .base import ExternalDependency, DependencyException, DependencyMethods, NotFoundDependency
 from .cmake import CMakeDependency
@@ -52,8 +53,8 @@
         # 'default_options' is only used in fallback case
         # 'not_found_message' has no impact on the dependency lookup
         # 'include_type' is handled after the dependency lookup
-        if key in ('version', 'native', 'required', 'fallback', 'allow_fallback', 'default_options',
-                   'not_found_message', 'include_type'):
+        if key in {'version', 'native', 'required', 'fallback', 'allow_fallback', 'default_options',
+                   'not_found_message', 'include_type'}:
             continue
         # All keyword arguments are strings, ints, or lists (or lists of lists)
         if isinstance(value, list):
@@ -103,7 +104,7 @@
     candidates = _build_external_dependency_list(name, env, for_machine, kwargs)
 
     pkg_exc: T.ListDependencyException = 
-    pkgdep:  T.ListExternalDependency  = 
+    pkgdep:  T.ListExternalDependency = 
     details = ''
 
     for c in candidates:
@@ -113,8 +114,11 @@
             d._check_version()
             pkgdep.append(d)
         except DependencyException as e:
+            assert isinstance(c, functools.partial), 'for mypy'
+            bettermsg = f'Dependency lookup for {name} with method {c.func.log_tried()!r} failed: {e}'
+            mlog.debug(bettermsg)
+            e.args = (bettermsg,)
             pkg_exc.append(e)
-            mlog.debug(str(e))
         else:
             pkg_exc.append(None)
             details = d.log_details()
@@ -178,8 +182,7 @@
         if isinstance(packageslname, type):
             entry1 = T.cast('T.TypeExternalDependency', packageslname)  # mypy doesn't understand isinstance(..., type)
             if issubclass(entry1, ExternalDependency):
-                # TODO: somehow make mypy understand that entry1(env, kwargs) is OK...
-                func: T.Callable, 'ExternalDependency' = lambda: entry1(env, kwargs)  # type: ignore
+                func: T.Callable, 'ExternalDependency' = functools.partial(entry1, env, kwargs)
                 dep = func
         else:
             entry2 = T.cast('T.UnionDependencyFactory, WrappedFactoryFunc', packageslname)

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/dependencies/dev.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/dependencies/dev.py Changed

@@ -22,15 +22,15 @@
 import re
 import pathlib
 import shutil
+import subprocess
 import typing as T
 
 from mesonbuild.interpreterbase.decorators import FeatureDeprecated
 
 from .. import mesonlib, mlog
-from ..compilers import AppleClangCCompiler, AppleClangCPPCompiler, detect_compiler_for
 from ..environment import get_llvm_tool_names
 from ..mesonlib import version_compare, stringlistify, extract_as_list
-from .base import DependencyException, DependencyMethods, strip_system_libdirs, SystemDependency, ExternalDependency, DependencyTypeName
+from .base import DependencyException, DependencyMethods, detect_compiler, strip_system_libdirs, SystemDependency, ExternalDependency, DependencyTypeName
 from .cmake import CMakeDependency
 from .configtool import ConfigToolDependency
 from .factory import DependencyFactory
@@ -115,9 +115,6 @@
         else:
             return 'building self'
 
-    def log_tried(self) -> str:
-        return 'system'
-
 
 class GTestDependencyPC(PkgConfigDependency):
 
@@ -186,9 +183,6 @@
         else:
             return 'building self'
 
-    def log_tried(self) -> str:
-        return 'system'
-
 
 class GMockDependencyPC(PkgConfigDependency):
 
@@ -490,6 +484,8 @@
 
     def __init__(self, name: str, environment: 'Environment', kwargs: T.Dictstr, T.Any):
         super().__init__(name, environment, kwargs)
+        from ..compilers.c import AppleClangCCompiler
+        from ..compilers.cpp import AppleClangCPPCompiler
 
         m = self.env.machinesself.for_machine
 
@@ -504,13 +500,8 @@
             self.is_found = True
             self.link_args = '-lz'
         else:
-            # Without a clib_compiler we can't find zlib, so just give up.
-            if self.clib_compiler is None:
-                self.is_found = False
-                return
-
             if self.clib_compiler.get_argument_syntax() == 'msvc':
-                libs = 'zlib1' 'zlib'
+                libs = 'zlib1', 'zlib'
             else:
                 libs = 'z'
             for lib in libs:
@@ -529,14 +520,14 @@
 
 class JNISystemDependency(SystemDependency):
     def __init__(self, environment: 'Environment', kwargs: JNISystemDependencyKW):
-        super().__init__('jni', environment, T.cast(T.Dictstr, T.Any, kwargs))
+        super().__init__('jni', environment, T.cast('T.Dictstr, T.Any', kwargs))
 
         self.feature_since = ('0.62.0', '')
 
         m = self.env.machinesself.for_machine
 
         if 'java' not in environment.coredata.compilersself.for_machine:
-            detect_compiler_for(environment, 'java', self.for_machine)
+            detect_compiler(self.name, environment, self.for_machine, 'java')
         self.javac = environment.coredata.compilersself.for_machine'java'
         self.version = self.javac.version
 
@@ -556,6 +547,17 @@
         self.java_home = environment.propertiesself.for_machine.get_java_home()
         if not self.java_home:
             self.java_home = pathlib.Path(shutil.which(self.javac.exelist0)).resolve().parents1
+            if m.is_darwin():
+                problem_java_prefix = pathlib.Path('/System/Library/Frameworks/JavaVM.framework/Versions')
+                if problem_java_prefix in self.java_home.parents:
+                    res = subprocess.run('/usr/libexec/java_home', '--failfast', '--arch', m.cpu_family,
+                                         stdout=subprocess.PIPE)
+                    if res.returncode != 0:
+                        log = mlog.error if self.required else mlog.debug
+                        log('JAVA_HOME could not be discovered on the system. Please set it explicitly.')
+                        self.is_found = False
+                        return
+                    self.java_home = pathlib.Path(res.stdout.decode().strip())
 
         platform_include_dir = self.__machine_info_to_platform_include_dir(m)
         if platform_include_dir is None:
@@ -573,21 +575,11 @@
                 java_home_lib_server = java_home_lib
             else:
                 if version_compare(self.version, '<= 1.8.0'):
-                    # The JDK and Meson have a disagreement here, so translate it
-                    # over. In the event more translation needs to be done, add to
-                    # following dict.
-                    def cpu_translate(cpu: str) -> str:
-                        java_cpus = {
-                            'x86_64': 'amd64',
-                        }
-
-                        return java_cpus.get(cpu, cpu)
-
-                    java_home_lib = self.java_home / 'jre' / 'lib' / cpu_translate(m.cpu_family)
-                    java_home_lib_server = java_home_lib / "server"
+                    java_home_lib = self.java_home / 'jre' / 'lib' / self.__cpu_translate(m.cpu_family)
                 else:
                     java_home_lib = self.java_home / 'lib'
-                    java_home_lib_server = java_home_lib / "server"
+
+                java_home_lib_server = java_home_lib / 'server'
 
             if 'jvm' in modules:
                 jvm = self.clib_compiler.find_library('jvm', environment, extra_dirs=str(java_home_lib_server))
@@ -607,13 +599,25 @@
         self.is_found = True
 
     @staticmethod
+    def __cpu_translate(cpu: str) -> str:
+        '''
+        The JDK and Meson have a disagreement here, so translate it over. In the event more
+        translation needs to be done, add to following dict.
+        '''
+        java_cpus = {
+            'x86_64': 'amd64',
+        }
+
+        return java_cpus.get(cpu, cpu)
+
+    @staticmethod
     def __machine_info_to_platform_include_dir(m: 'MachineInfo') -> T.Optionalstr:
-        """Translates the machine information to the platform-dependent include directory
+        '''Translates the machine information to the platform-dependent include directory
 
         When inspecting a JDK release tarball or $JAVA_HOME, inside the `include/` directory is a
-        platform dependent folder that must be on the target's include path in addition to the
+        platform-dependent directory that must be on the target's include path in addition to the
         parent `include/` directory.
-        """
+        '''
         if m.is_linux():
             return 'linux'
         elif m.is_windows():
@@ -622,6 +626,14 @@
             return 'darwin'
         elif m.is_sunos():
             return 'solaris'
+        elif m.is_freebsd():
+            return 'freebsd'
+        elif m.is_netbsd():
+            return 'netbsd'
+        elif m.is_openbsd():
+            return 'openbsd'
+        elif m.is_dragonflybsd():
+            return 'dragonfly'
 
         return None

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/dependencies/dub.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/dependencies/dub.py Changed

@@ -11,14 +11,12 @@
 # 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.
+from __future__ import annotations
 
 from .base import ExternalDependency, DependencyException, DependencyTypeName
 from .pkgconfig import PkgConfigDependency
-from ..mesonlib import (Popen_safe, OptionKey)
-from ..mesonlib.universal import join_args
+from ..mesonlib import (Popen_safe, OptionKey, join_args)
 from ..programs import ExternalProgram
-from ..compilers import DCompiler
-from ..compilers.d import d_feature_args
 from .. import mlog
 import re
 import os
@@ -34,6 +32,7 @@
     def __init__(self, name: str, environment: 'Environment', kwargs: T.Dictstr, T.Any):
         super().__init__(DependencyTypeName('dub'), environment, kwargs, language='d')
         self.name = name
+        from ..compilers.d import DCompiler, d_feature_args
 
         _temp_comp = super().get_compiler()
         assert isinstance(_temp_comp, DCompiler)

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/dependencies/factory.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/dependencies/factory.py Changed

@@ -100,15 +100,15 @@
          = {
             # Just attach the correct name right now, either the generic name
             # or the method specific name.
-            DependencyMethods.EXTRAFRAMEWORK: lambda env, kwargs: framework_class(framework_name or name, env, kwargs),
-            DependencyMethods.PKGCONFIG:      lambda env, kwargs: pkgconfig_class(pkgconfig_name or name, env, kwargs),
-            DependencyMethods.CMAKE:          lambda env, kwargs: cmake_class(cmake_name or name, env, kwargs),
-            DependencyMethods.SYSTEM:         lambda env, kwargs: system_class(name, env, kwargs),
-            DependencyMethods.BUILTIN:        lambda env, kwargs: builtin_class(name, env, kwargs),
-            DependencyMethods.CONFIG_TOOL:    None,
+            DependencyMethods.EXTRAFRAMEWORK: functools.partial(framework_class, framework_name or name),
+            DependencyMethods.PKGCONFIG: functools.partial(pkgconfig_class, pkgconfig_name or name),
+            DependencyMethods.CMAKE: functools.partial(cmake_class, cmake_name or name),
+            DependencyMethods.SYSTEM: functools.partial(system_class, name),
+            DependencyMethods.BUILTIN: functools.partial(builtin_class, name),
+            DependencyMethods.CONFIG_TOOL: None,
         }
         if configtool_class is not None:
-            self.classesDependencyMethods.CONFIG_TOOL = lambda env, kwargs: configtool_class(name, env, kwargs)
+            self.classesDependencyMethods.CONFIG_TOOL = functools.partial(configtool_class, name)
 
     @staticmethod
     def _process_method(method: DependencyMethods, env: 'Environment', for_machine: MachineChoice) -> bool:

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/dependencies/framework.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/dependencies/framework.py Changed

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/dependencies/hdf5.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/dependencies/hdf5.py Changed

@@ -13,15 +13,16 @@
 # limitations under the License.
 
 # This file contains the detection logic for miscellaneous external dependencies.
+from __future__ import annotations
 
 import functools
 import os
 import re
-import shutil
 import subprocess
 from pathlib import Path
 
-from ..mesonlib import OrderedSet, join_args
+from ..mesonlib import Popen_safe, OrderedSet, join_args
+from ..programs import ExternalProgram
 from .base import DependencyException, DependencyMethods
 from .configtool import ConfigToolDependency
 from .pkgconfig import PkgConfigDependency
@@ -159,14 +160,14 @@
     if DependencyMethods.PKGCONFIG in methods:
         # Use an ordered set so that these remain the first tried pkg-config files
         pkgconfig_files = OrderedSet('hdf5', 'hdf5-serial')
-        # FIXME: This won't honor pkg-config paths, and cross-native files
-        PCEXE = shutil.which('pkg-config')
+        PCEXE = PkgConfigDependency._detect_pkgbin(False, env, for_machine)
+        pcenv = PkgConfigDependency.setup_env(os.environ, env, for_machine)
         if PCEXE:
+            assert isinstance(PCEXE, ExternalProgram)
             # some distros put hdf5-1.2.3.pc with version number in .pc filename.
-            ret = subprocess.run(PCEXE, '--list-all', stdout=subprocess.PIPE, stderr=subprocess.DEVNULL,
-                                 text=True)
+            ret, stdout, _ = Popen_safe(PCEXE.get_command() + '--list-all', stderr=subprocess.DEVNULL, env=pcenv)
             if ret.returncode == 0:
-                for pkg in ret.stdout.split('\n'):
+                for pkg in stdout.split('\n'):
                     if pkg.startswith('hdf5'):
                         pkgconfig_files.add(pkg.split(' ', 1)0)

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/dependencies/misc.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/dependencies/misc.py Changed

@@ -13,6 +13,7 @@
 # limitations under the License.
 
 # This file contains the detection logic for miscellaneous external dependencies.
+from __future__ import annotations
 
 from pathlib import Path
 import functools
@@ -145,7 +146,7 @@
         self.is_found = True
         # Happens if you are using a language with threads
         # concept without C, such as plain Cuda.
-        if self.clib_compiler is None:
+        if not self.clib_compiler:
             self.compile_args = 
             self.link_args = 
         else:
@@ -214,7 +215,7 @@
                 return None
         elif pyplat == 'win32':
             return '32'
-        elif pyplat in ('win64', 'win-amd64'):
+        elif pyplat in {'win64', 'win-amd64'}:
             return '64'
         mlog.log(f'Unknown Windows Python platform {pyplat!r}')
         return None
@@ -284,7 +285,8 @@
         self.version = sysconfig.get_config_var('py_version')
         self.is_found = True
 
-    def log_tried(self) -> str:
+    @staticmethod
+    def log_tried() -> str:
         return 'sysconfig'
 
 class PcapDependencyConfigTool(ConfigToolDependency):
@@ -292,13 +294,19 @@
     tools = 'pcap-config'
     tool_name = 'pcap-config'
 
+    # version 1.10.2 added error checking for invalid arguments
+    # version 1.10.3 will hopefully add actual support for --version
+    skip_version = '--help'
+
     def __init__(self, name: str, environment: 'Environment', kwargs: T.Dictstr, T.Any):
         super().__init__(name, environment, kwargs)
         if not self.is_found:
             return
         self.compile_args = self.get_config_value('--cflags', 'compile_args')
         self.link_args = self.get_config_value('--libs', 'link_args')
-        self.version = self.get_pcap_lib_version()
+        if self.version is None:
+            # older pcap-config versions don't support this
+            self.version = self.get_pcap_lib_version()
 
     def get_pcap_lib_version(self) -> T.Optionalstr:
         # Since we seem to need to run a program to discover the pcap version,
@@ -393,9 +401,6 @@
 
                 break
 
-    def log_tried(self) -> str:
-        return 'system'
-
 
 class CursesConfigToolDependency(ConfigToolDependency):

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/dependencies/mpi.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/dependencies/mpi.py Changed

@@ -11,6 +11,7 @@
 # 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.
+from __future__ import annotations
 
 import functools
 import typing as T
@@ -40,7 +41,7 @@
 
     candidates: T.List'DependencyGenerator' = 
     compiler = detect_compiler('mpi', env, for_machine, language)
-    if compiler is None:
+    if not compiler:
         return 
     compiler_is_intel = compiler.get_id() in {'intel', 'intel-cl'}
 
@@ -102,7 +103,7 @@
 
 class _MPIConfigToolDependency(ConfigToolDependency):
 
-    def _filter_compile_args(self, args: T.Sequencestr) -> T.Liststr:
+    def _filter_compile_args(self, args: T.Liststr) -> T.Liststr:
         """
         MPI wrappers return a bunch of garbage args.
         Drop -O2 and everything that is not needed.
@@ -126,7 +127,7 @@
                 result.append(f)
         return result
 
-    def _filter_link_args(self, args: T.Sequencestr) -> T.Liststr:
+    def _filter_link_args(self, args: T.Liststr) -> T.Liststr:
         """
         MPI wrappers return a bunch of garbage args.
         Drop -O2 and everything that is not needed.
@@ -136,7 +137,7 @@
         for f in args:
             if self._is_link_arg(f):
                 result.append(f)
-                if f in ('-L', '-Xlinker'):
+                if f in {'-L', '-Xlinker'}:
                     include_next = True
             elif include_next:
                 include_next = False

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/dependencies/pkgconfig.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/dependencies/pkgconfig.py Changed

@@ -47,36 +47,7 @@
         self.is_libtool = False
         # Store a copy of the pkg-config path on the object itself so it is
         # stored in the pickled coredata and recovered.
-        self.pkgbin: T.UnionNone, bool, ExternalProgram = None
-
-        # Only search for pkg-config for each machine the first time and store
-        # the result in the class definition
-        if PkgConfigDependency.class_pkgbinself.for_machine is False:
-            mlog.debug(f'Pkg-config binary for {self.for_machine} is cached as not found.')
-        elif PkgConfigDependency.class_pkgbinself.for_machine is not None:
-            mlog.debug(f'Pkg-config binary for {self.for_machine} is cached.')
-        else:
-            assert PkgConfigDependency.class_pkgbinself.for_machine is None
-            mlog.debug(f'Pkg-config binary for {self.for_machine} is not cached.')
-            for potential_pkgbin in find_external_program(
-                    self.env, self.for_machine, 'pkgconfig', 'Pkg-config',
-                    environment.default_pkgconfig, allow_default_for_cross=False):
-                version_if_ok = self.check_pkgconfig(potential_pkgbin)
-                if not version_if_ok:
-                    continue
-                if not self.silent:
-                    mlog.log('Found pkg-config:', mlog.bold(potential_pkgbin.get_path()),
-                             f'({version_if_ok})')
-                PkgConfigDependency.class_pkgbinself.for_machine = potential_pkgbin
-                break
-            else:
-                if not self.silent:
-                    mlog.log('Found Pkg-config:', mlog.red('NO'))
-                # Set to False instead of None to signify that we've already
-                # searched for it and not found it
-                PkgConfigDependency.class_pkgbinself.for_machine = False
-
-        self.pkgbin = PkgConfigDependency.class_pkgbinself.for_machine
+        self.pkgbin = self._detect_pkgbin(self.silent, self.env, self.for_machine)
         if self.pkgbin is False:
             self.pkgbin = None
             msg = f'Pkg-config binary for machine {self.for_machine} not found. Giving up.'
@@ -115,13 +86,49 @@
         return s.format(self.__class__.__name__, self.name, self.is_found,
                         self.version_reqs)
 
+    @classmethod
+    def _detect_pkgbin(cls, silent: bool, env: Environment,
+                       for_machine: MachineChoice) -> T.UnionNone, bool, ExternalProgram:
+        # Only search for pkg-config for each machine the first time and store
+        # the result in the class definition
+        if cls.class_pkgbinfor_machine is False:
+            mlog.debug(f'Pkg-config binary for {for_machine} is cached as not found.')
+        elif cls.class_pkgbinfor_machine is not None:
+            mlog.debug(f'Pkg-config binary for {for_machine} is cached.')
+        else:
+            assert cls.class_pkgbinfor_machine is None, 'for mypy'
+            mlog.debug(f'Pkg-config binary for {for_machine} is not cached.')
+            for potential_pkgbin in find_external_program(
+                    env, for_machine, 'pkgconfig', 'Pkg-config',
+                    env.default_pkgconfig, allow_default_for_cross=False):
+                version_if_ok = cls.check_pkgconfig(env, potential_pkgbin)
+                if not version_if_ok:
+                    continue
+                if not silent:
+                    mlog.log('Found pkg-config:', mlog.bold(potential_pkgbin.get_path()),
+                             f'({version_if_ok})')
+                cls.class_pkgbinfor_machine = potential_pkgbin
+                break
+            else:
+                if not silent:
+                    mlog.log('Found Pkg-config:', mlog.red('NO'))
+                # Set to False instead of None to signify that we've already
+                # searched for it and not found it
+                cls.class_pkgbinfor_machine = False
+
+        return cls.class_pkgbinfor_machine
+
     def _call_pkgbin_real(self, args: T.Liststr, env: T.Dictstr, str) -> T.Tupleint, str, str:
         assert isinstance(self.pkgbin, ExternalProgram)
         cmd = self.pkgbin.get_command() + args
         p, out, err = Popen_safe(cmd, env=env)
         rc, out, err = p.returncode, out.strip(), err.strip()
         call = ' '.join(cmd)
-        mlog.debug(f"Called `{call}` -> {rc}\n{out}")
+        mlog.debug(f"Called `{call}` -> {rc}")
+        if out:
+            mlog.debug(f'stdout:\n{out}\n-----------')
+        if err:
+            mlog.debug(f'stderr:\n{err}\n-----------')
         return rc, out, err
 
     @staticmethod
@@ -419,7 +426,8 @@
         mlog.debug(f'Got pkgconfig variable {variable_name} : {variable}')
         return variable
 
-    def check_pkgconfig(self, pkgbin: ExternalProgram) -> T.Optionalstr:
+    @staticmethod
+    def check_pkgconfig(env: Environment, pkgbin: ExternalProgram) -> T.Optionalstr:
         if not pkgbin.found():
             mlog.log(f'Did not find pkg-config by name {pkgbin.name!r}')
             return None
@@ -438,7 +446,7 @@
             return None
         except PermissionError:
             msg = f'Found pkg-config {command_as_string!r} but didn\'t have permissions to run it.'
-            if not self.env.machines.build.is_windows():
+            if not env.machines.build.is_windows():
                 msg += '\n\nOn Unix-like systems this is often caused by scripts that are not executable.'
             mlog.warning(msg)
             return None
@@ -479,8 +487,9 @@
         # a path rather than the raw dlname
         return os.path.basename(dlname)
 
-    def log_tried(self) -> str:
-        return self.type_name
+    @staticmethod
+    def log_tried() -> str:
+        return 'pkgconfig'
 
     def get_variable(self, *, cmake: T.Optionalstr = None, pkgconfig: T.Optionalstr = None,
                      configtool: T.Optionalstr = None, internal: T.Optionalstr = None,

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/dependencies/platform.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/dependencies/platform.py Changed

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/dependencies/qt.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/dependencies/qt.py Changed

@@ -13,6 +13,7 @@
 # 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.
+from __future__ import annotations
 
 """Dependency finders for the Qt framework."""
 
@@ -33,6 +34,7 @@
     from ..compilers import Compiler
     from ..envconfig import MachineInfo
     from ..environment import Environment
+    from ..dependencies import MissingCompiler
 
 
 def _qt_get_private_includes(mod_inc_dir: str, module: str, mod_version: str) -> T.Liststr:
@@ -122,7 +124,7 @@
     """Mixin class for shared components between PkgConfig and Qmake."""
 
     link_args: T.Liststr
-    clib_compiler: 'Compiler'
+    clib_compiler: T.Union'MissingCompiler', 'Compiler'
     env: 'Environment'
     libexecdir: T.Optionalstr = None
 
@@ -145,15 +147,18 @@
         if not isinstance(self.qtmain, bool):
             raise DependencyException('"main" argument must be a boolean')
 
-    def _link_with_qtmain(self, is_debug: bool, libdir: T.Unionstr, T.Liststr) -> bool:
+    def _link_with_qt_winmain(self, is_debug: bool, libdir: T.Unionstr, T.Liststr) -> bool:
         libdir = mesonlib.listify(libdir)  # TODO: shouldn't be necessary
-        base_name = 'qtmaind' if is_debug else 'qtmain'
-        qtmain = self.clib_compiler.find_library(base_name, self.env, libdir)
-        if qtmain:
-            self.link_args.append(qtmain0)
+        base_name = self.get_qt_winmain_base_name(is_debug)
+        qt_winmain = self.clib_compiler.find_library(base_name, self.env, libdir)
+        if qt_winmain:
+            self.link_args.append(qt_winmain0)
             return True
         return False
 
+    def get_qt_winmain_base_name(self, is_debug: bool) -> str:
+        return 'qtmaind' if is_debug else 'qtmain'
+
     def get_exe_args(self, compiler: 'Compiler') -> T.Liststr:
         # Originally this was -fPIE but nowadays the default
         # for upstream and distros seems to be -reduce-relocations
@@ -212,7 +217,7 @@
                     is_debug = True
                     break
             libdir = self.get_pkgconfig_variable('libdir', , None)
-            if not self._link_with_qtmain(is_debug, libdir):
+            if not self._link_with_qt_winmain(is_debug, libdir):
                 self.is_found = False
                 return
 
@@ -332,7 +337,7 @@
             self.link_args.append(libfile)
 
         if self.env.machinesself.for_machine.is_windows() and self.qtmain:
-            if not self._link_with_qtmain(is_debug, libdir):
+            if not self._link_with_qt_winmain(is_debug, libdir):
                 self.is_found = False
 
     def _sanitize_version(self, version: str) -> str:
@@ -375,6 +380,12 @@
         return 'qmake'
 
 
+class Qt6WinMainMixin:
+
+    def get_qt_winmain_base_name(self, is_debug: bool) -> str:
+        return 'Qt6EntryPointd' if is_debug else 'Qt6EntryPoint'
+
+
 class Qt4ConfigToolDependency(QmakeQtDependency):
 
     def get_private_includes(self, mod_inc_dir: str, module: str) -> T.Liststr:
@@ -387,7 +398,7 @@
         return _qt_get_private_includes(mod_inc_dir, module, self.version)
 
 
-class Qt6ConfigToolDependency(QmakeQtDependency):
+class Qt6ConfigToolDependency(Qt6WinMainMixin, QmakeQtDependency):
 
     def get_private_includes(self, mod_inc_dir: str, module: str) -> T.Liststr:
         return _qt_get_private_includes(mod_inc_dir, module, self.version)
@@ -431,7 +442,7 @@
         return _qt_get_private_includes(mod_inc_dir, module, self.version)
 
 
-class Qt6PkgConfigDependency(QtPkgConfigDependency):
+class Qt6PkgConfigDependency(Qt6WinMainMixin, QtPkgConfigDependency):
 
     def __init__(self, name: str, env: 'Environment', kwargs: T.Dictstr, T.Any):
         super().__init__(name, env, kwargs)

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/dependencies/scalapack.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/dependencies/scalapack.py Changed

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/dependencies/ui.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/dependencies/ui.py Changed

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/depfile.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/depfile.py Changed

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/envconfig.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/envconfig.py Changed

@@ -11,6 +11,7 @@
 # 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.
+from __future__ import annotations
 
 from dataclasses import dataclass
 import subprocess
@@ -90,7 +91,7 @@
 
 
 # Map from language identifiers to environment variables.
-ENV_VAR_PROG_MAP: T.Mappingstr, str = {
+ENV_VAR_COMPILER_MAP: T.Mappingstr, str = {
     # Compilers
     'c': 'CC',
     'cpp': 'CXX',
@@ -101,6 +102,7 @@
     'objcpp': 'OBJCXX',
     'rust': 'RUSTC',
     'vala': 'VALAC',
+    'nasm': 'NASM',
 
     # Linkers
     'c_ld': 'CC_LD',
@@ -110,7 +112,10 @@
     'objc_ld': 'OBJC_LD',
     'objcpp_ld': 'OBJCXX_LD',
     'rust_ld': 'RUSTC_LD',
+}
 
+# Map from utility names to environment variables.
+ENV_VAR_TOOL_MAP: T.Mappingstr, str = {
     # Binutils
     'ar': 'AR',
     'as': 'AS',
@@ -132,8 +137,11 @@
     'pkg-config': 'PKG_CONFIG',
     'make': 'MAKE',
     'vapigen': 'VAPIGEN',
+    'llvm-config': 'LLVM_CONFIG',
 }
 
+ENV_VAR_PROG_MAP = {**ENV_VAR_COMPILER_MAP, **ENV_VAR_TOOL_MAP}
+
 # Deprecated environment variables mapped from the new variable to the old one
 # Deprecated in 0.54.0
 DEPRECATED_ENV_PROG_MAP: T.Mappingstr, str = {

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/environment.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/environment.py Changed

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/interpreter/compiler.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/interpreter/compiler.py Changed

@@ -1,9 +1,11 @@
 # SPDX-Licnese-Identifier: Apache-2.0
 # Copyright 2012-2021 The Meson development team
 # Copyright © 2021 Intel Corporation
+from __future__ import annotations
 
 import enum
 import functools
+import os
 import typing as T
 
 from .. import build
@@ -79,6 +81,11 @@
         header_prefix: str
         header_required: T.Unionbool, coredata.UserFeatureOption
 
+    class PreprocessKW(TypedDict):
+        output: str
+        compile_args: T.Liststr
+        include_directories: T.Listbuild.IncludeDirs
+
 
 class _TestMode(enum.Enum):
 
@@ -136,7 +143,13 @@
     default=,
     listify=True,
 )
-_PREFIX_KW = KwargInfo('prefix', str, default='')
+_PREFIX_KW: KwargInfostr = KwargInfo(
+    'prefix',
+    (str, ContainerTypeInfo(list, str)),
+    default='',
+    since_values={list: '1.0.0'},
+    convertor=lambda x: '\n'.join(x) if isinstance(x, list) else x)
+
 _NO_BUILTIN_ARGS_KW = KwargInfo('no_builtin_args', bool, default=False)
 _NAME_KW = KwargInfo('name', str, default='')
 
@@ -184,19 +197,16 @@
                              'first_supported_link_argument': self.first_supported_link_argument_method,
                              'symbols_have_underscore_prefix': self.symbols_have_underscore_prefix_method,
                              'get_argument_syntax': self.get_argument_syntax_method,
+                             'preprocess': self.preprocess_method,
                              })
 
     @property
     def compiler(self) -> 'Compiler':
         return self.held_object
 
-    def _dep_msg(self, deps: T.List'dependencies.Dependency', endl: str) -> str:
+    def _dep_msg(self, deps: T.List'dependencies.Dependency', compile_only: bool, endl: str) -> str:
         msg_single = 'with dependency {}'
         msg_many = 'with dependencies {}'
-        if not deps:
-            return endl
-        if endl is None:
-            endl = ''
         names = 
         for d in deps:
             if isinstance(d, dependencies.InternalDependency):
@@ -204,13 +214,17 @@
                                       location=self.current_node)
                 continue
             if isinstance(d, dependencies.ExternalLibrary):
+                if compile_only:
+                    continue
                 name = '-l' + d.name
             else:
                 name = d.name
             names.append(name)
         if not names:
-            return None
+            return endl
         tpl = msg_many if len(names) > 1 else msg_single
+        if endl is None:
+            endl = ''
         return tpl.format(', '.join(names)) + endl
 
     @noPosargs
@@ -239,9 +253,9 @@
         args.extend(extra_args)
         return args
 
-    def _determine_dependencies(self, deps: T.List'dependencies.Dependency', endl: str = ':') -> T.TupleT.List'dependencies.Dependency', str:
+    def _determine_dependencies(self, deps: T.List'dependencies.Dependency', compile_only: bool = False, endl: str = ':') -> T.TupleT.List'dependencies.Dependency', str:
         deps = dependencies.get_leaf_external_dependencies(deps)
-        return deps, self._dep_msg(deps, endl)
+        return deps, self._dep_msg(deps, compile_only, endl)
 
     @typed_pos_args('compiler.alignment', str)
     @typed_kwargs(
@@ -252,7 +266,7 @@
     )
     def alignment_method(self, args: T.Tuplestr, kwargs: 'AlignmentKw') -> int:
         typename = args0
-        deps, msg = self._determine_dependencies(kwargs'dependencies')
+        deps, msg = self._determine_dependencies(kwargs'dependencies', compile_only=self.compiler.is_cross)
         result = self.compiler.alignment(typename, kwargs'prefix', self.environment,
                                          extra_args=kwargs'args',
                                          dependencies=deps)
@@ -269,7 +283,7 @@
                 code.rel_to_builddir(self.environment.source_dir))
         testname = kwargs'name'
         extra_args = functools.partial(self._determine_args, kwargs'no_builtin_args', kwargs'include_directories', kwargs'args')
-        deps, msg = self._determine_dependencies(kwargs'dependencies', endl=None)
+        deps, msg = self._determine_dependencies(kwargs'dependencies', compile_only=False, endl=None)
         result = self.compiler.run(code, self.environment, extra_args=extra_args,
                                    dependencies=deps)
         if testname:
@@ -346,7 +360,7 @@
     def has_function_method(self, args: T.Tuplestr, kwargs: 'CommonKW') -> bool:
         funcname = args0
         extra_args = self._determine_args(kwargs'no_builtin_args', kwargs'include_directories', kwargs'args')
-        deps, msg = self._determine_dependencies(kwargs'dependencies')
+        deps, msg = self._determine_dependencies(kwargs'dependencies', compile_only=False)
         had, cached = self.compiler.has_function(funcname, kwargs'prefix', self.environment,
                                                  extra_args=extra_args,
                                                  dependencies=deps)
@@ -386,7 +400,7 @@
     def compute_int_method(self, args: T.Tuplestr, kwargs: 'CompupteIntKW') -> int:
         expression = args0
         extra_args = functools.partial(self._determine_args, kwargs'no_builtin_args', kwargs'include_directories', kwargs'args')
-        deps, msg = self._determine_dependencies(kwargs'dependencies')
+        deps, msg = self._determine_dependencies(kwargs'dependencies', compile_only=self.compiler.is_cross)
         res = self.compiler.compute_int(expression, kwargs'low', kwargs'high',
                                         kwargs'guess', kwargs'prefix',
                                         self.environment, extra_args=extra_args,
@@ -399,7 +413,7 @@
     def sizeof_method(self, args: T.Tuplestr, kwargs: 'CommonKW') -> int:
         element = args0
         extra_args = functools.partial(self._determine_args, kwargs'no_builtin_args', kwargs'include_directories', kwargs'args')
-        deps, msg = self._determine_dependencies(kwargs'dependencies')
+        deps, msg = self._determine_dependencies(kwargs'dependencies', compile_only=self.compiler.is_cross)
         esize = self.compiler.sizeof(element, kwargs'prefix', self.environment,
                                      extra_args=extra_args, dependencies=deps)
         mlog.log('Checking for size of', mlog.bold(element, True), msg, esize)
@@ -465,7 +479,7 @@
 
         testname = kwargs'name'
         extra_args = functools.partial(self._determine_args, kwargs'no_builtin_args', kwargs'include_directories', kwargs'args')
-        deps, msg = self._determine_dependencies(kwargs'dependencies')
+        deps, msg = self._determine_dependencies(kwargs'dependencies', compile_only=False)
         result, cached = self.compiler.links(code, self.environment,
                                              compiler=compiler,
                                              extra_args=extra_args,
@@ -734,3 +748,34 @@
     @noKwargs
     def get_argument_syntax_method(self, args: T.List'TYPE_var', kwargs: 'TYPE_kwargs') -> str:
         return self.compiler.get_argument_syntax()
+
+    @FeatureNew('compiler.preprocess', '0.64.0')
+    @typed_pos_args('compiler.preprocess', varargs=(mesonlib.File, str), min_varargs=1)
+    @typed_kwargs(
+        'compiler.preprocess',
+        KwargInfo('output', str, default='@PLAINNAME@.i'),
+        KwargInfo('compile_args', ContainerTypeInfo(list, str), listify=True, default=),
+        _INCLUDE_DIRS_KW,
+    )
+    def preprocess_method(self, args: T.TupleT.List'mesonlib.FileOrString', kwargs: 'PreprocessKW') -> T.Listbuild.CustomTargetIndex:
+        compiler = self.compiler.get_preprocessor()
+        sources = self.interpreter.source_strings_to_files(args0)
+        tg_kwargs = {
+            f'{self.compiler.language}_args': kwargs'compile_args',
+            'build_by_default': False,
+            'include_directories': kwargs'include_directories',
+        }
+        tg = build.CompileTarget(
+            'preprocessor',
+            self.interpreter.subdir,
+            self.subproject,
+            self.environment,
+            sources,
+            kwargs'output',
+            compiler,
+            tg_kwargs)
+        self.interpreter.add_target(tg.name, tg)
+        # Expose this target as list of its outputs, so user can pass them to
+        # other targets, list outputs, etc.
+        private_dir = os.path.relpath(self.interpreter.backend.get_target_private_dir(tg), self.interpreter.subdir)
+        return build.CustomTargetIndex(tg, os.path.join(private_dir, o)) for o in tg.outputs

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/interpreter/dependencyfallbacks.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/interpreter/dependencyfallbacks.py Changed

@@ -66,14 +66,6 @@
         self._subproject_impl(subp_name, varname)
 
     def _subproject_impl(self, subp_name: str, varname: str) -> None:
-        if not varname:
-            # If no variable name is specified, check if the wrap file has one.
-            # If the wrap file has a variable name, better use it because the
-            # subproject most probably is not using meson.override_dependency().
-            for name in self.names:
-                varname = self.wrap_resolver.get_varname(subp_name, name)
-                if varname:
-                    break
         assert self.subproject_name is None
         self.subproject_name = subp_name
         self.subproject_varname = varname
@@ -175,6 +167,14 @@
         # Legacy: Use the variable name if provided instead of relying on the
         # subproject to override one of our dependency names
         if not varname:
+            # If no variable name is specified, check if the wrap file has one.
+            # If the wrap file has a variable name, better use it because the
+            # subproject most probably is not using meson.override_dependency().
+            for name in self.names:
+                varname = self.wrap_resolver.get_varname(subp_name, name)
+                if varname:
+                    break
+        if not varname:
             mlog.warning(f'Subproject {subp_name!r} did not override {self._display_name!r} dependency and no variable name specified')
             mlog.log('Dependency', mlog.bold(self._display_name), 'from subproject',
                      mlog.bold(subproject.subdir), 'found:', mlog.red('NO'))

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/interpreter/interpreter.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/interpreter/interpreter.py Changed

@@ -10,8 +10,8 @@
 # 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.
-
 from __future__ import annotations
+
 from .. import mparser
 from .. import environment
 from .. import coredata
@@ -79,13 +79,13 @@
     INSTALL_TAG_KW,
     LANGUAGE_KW,
     NATIVE_KW,
+    PRESERVE_PATH_KW,
     REQUIRED_KW,
     SOURCES_KW,
     VARIABLES_KW,
+    TEST_KWS,
     NoneType,
     in_set_validator,
-    variables_validator,
-    variables_convertor,
     env_convertor_with_method
 )
 from . import primitives as P_OBJ
@@ -108,7 +108,7 @@
 
     from typing_extensions import Literal
 
-    from . import kwargs
+    from . import kwargs as kwtypes
     from ..backend.backends import Backend
     from ..interpreterbase.baseobjects import InterpreterObject, TYPE_var, TYPE_kwargs
     from ..programs import OverrideProgram
@@ -166,11 +166,14 @@
                 elif isinstance(i, (ExternalProgram, Dependency)):
                     FeatureNew.single_use('dependency or external program in summary', '0.57.0', subproject)
                     formatted_values.append(i.summary_value())
+                elif isinstance(i, Disabler):
+                    FeatureNew.single_use('disabler in summary', '0.64.0', subproject)
+                    formatted_values.append(mlog.red('NO'))
                 elif isinstance(i, coredata.UserOption):
                     FeatureNew.single_use('feature option in summary', '0.58.0', subproject)
                     formatted_values.append(i.printable_value())
                 else:
-                    m = 'Summary value in section {!r}, key {!r}, must be string, integer, boolean, dependency or external program'
+                    m = 'Summary value in section {!r}, key {!r}, must be string, integer, boolean, dependency, disabler, or external program'
                     raise InterpreterException(m.format(section, k))
             self.sectionssectionk = (formatted_values, list_sep)
             self.max_key_len = max(self.max_key_len, len(k))
@@ -221,25 +224,6 @@
     {'target_type'}
 )
 
-TEST_KWARGS: T.ListKwargInfo = 
-    KwargInfo('args', ContainerTypeInfo(list, (str, mesonlib.File, build.BuildTarget, build.CustomTarget, build.CustomTargetIndex)),
-              listify=True, default=),
-    KwargInfo('should_fail', bool, default=False),
-    KwargInfo('timeout', int, default=30),
-    KwargInfo('workdir', (str, NoneType), default=None,
-              validator=lambda x: 'must be an absolute path' if not os.path.isabs(x) else None),
-    KwargInfo('protocol', str,
-              default='exitcode',
-              validator=in_set_validator({'exitcode', 'tap', 'gtest', 'rust'}),
-              since_values={'gtest': '0.55.0', 'rust': '0.57.0'}),
-    KwargInfo('priority', int, default=0, since='0.52.0'),
-    # TODO: env needs reworks of the way the environment variable holder itself works probably
-    ENV_KW,
-    DEPENDS_KW.evolve(since='0.46.0'),
-    KwargInfo('suite', ContainerTypeInfo(list, str), listify=True, default=''),  # yes, a list of empty string
-    KwargInfo('verbose', bool, default=False, since='0.62.0'),
-
-
 class InterpreterRuleRelaxation(Enum):
     ''' Defines specific relaxations of the Meson rules.
 
@@ -446,6 +430,7 @@
             str: P_OBJ.StringHolder,
             P_OBJ.MesonVersionString: P_OBJ.MesonVersionStringHolder,
             P_OBJ.DependencyVariableString: P_OBJ.DependencyVariableStringHolder,
+            P_OBJ.OptionString: P_OBJ.OptionStringHolder,
 
             # Meson types
             mesonlib.File: OBJ.FileHolder,
@@ -598,22 +583,6 @@
                 dep = df.lookup(kwargs, force_fallback=True)
                 self.build.stdlibsfor_machinel = dep
 
-    def _import_module(self, modname: str, required: bool) -> NewExtensionModule:
-        if modname in self.modules:
-            return self.modulesmodname
-        try:
-            module = importlib.import_module('mesonbuild.modules.' + modname)
-        except ImportError:
-            if required:
-                raise InvalidArguments(f'Module "{modname}" does not exist')
-            ext_module = NotFoundExtensionModule()
-        else:
-            ext_module = module.initialize(self)
-            assert isinstance(ext_module, (ExtensionModule, NewExtensionModule))
-            self.build.modules.append(modname)
-        self.modulesmodname = ext_module
-        return ext_module
-
     @typed_pos_args('import', str)
     @typed_kwargs(
         'import',
@@ -622,54 +591,71 @@
     )
     @disablerIfNotFound
     def func_import(self, node: mparser.BaseNode, args: T.Tuplestr,
-                    kwargs: 'kwargs.FuncImportModule') -> T.UnionExtensionModule, NewExtensionModule, NotFoundExtensionModule:
+                    kwargs: 'kwtypes.FuncImportModule') -> T.UnionExtensionModule, NewExtensionModule, NotFoundExtensionModule:
         modname = args0
         disabled, required, _ = extract_required_kwarg(kwargs, self.subproject)
         if disabled:
-            return NotFoundExtensionModule()
+            return NotFoundExtensionModule(modname)
 
-        if modname.startswith('unstable-'):
-            plainname = modname.split('-', 1)1
-            try:
-                # check if stable module exists
-                mod = self._import_module(plainname, required)
-                # XXX: this is actually not helpful, since it doesn't do a version check
-                mlog.warning(f'Module {modname} is now stable, please use the {plainname} module instead.')
-                return mod
-            except InvalidArguments:
-                mlog.warning(f'Module {modname} has no backwards or forwards compatibility and might not exist in future releases.', location=node)
-                modname = 'unstable_' + plainname
-        return self._import_module(modname, required)
+        expect_unstable = False
+        # Some tests use "unstable_" instead of "unstable-", and that happens to work because
+        # of implementation details
+        if modname.startswith(('unstable-', 'unstable_')):
+            if modname.startswith('unstable_'):
+                mlog.deprecation(f'Importing unstable modules as "{modname}" instead of "{modname.replace("_", "-", 1)}"',
+                                 location=node)
+            real_modname = modnamelen('unstable') + 1:  # + 1 to handle the - or _
+            expect_unstable = True
+        else:
+            real_modname = modname
+
+        if real_modname in self.modules:
+            return self.modulesreal_modname
+        try:
+            module = importlib.import_module(f'mesonbuild.modules.{real_modname}')
+        except ImportError:
+            if required:
+                raise InvalidArguments(f'Module "{modname}" does not exist')
+            ext_module = NotFoundExtensionModule(real_modname)
+        else:
+            ext_module = module.initialize(self)
+            assert isinstance(ext_module, (ExtensionModule, NewExtensionModule))
+            self.build.modules.append(real_modname)
+        if ext_module.INFO.added:
+            FeatureNew.single_use(f'module {ext_module.INFO.name}', ext_module.INFO.added, self.subproject, location=node)
+        if ext_module.INFO.deprecated:
+            FeatureDeprecated.single_use(f'module {ext_module.INFO.name}', ext_module.INFO.deprecated, self.subproject, location=node)
+        if expect_unstable and not ext_module.INFO.unstable and ext_module.INFO.stabilized is None:
+            raise InvalidArguments(f'Module {ext_module.INFO.name} has never been unstable, remove "unstable-" prefix.')
+        if ext_module.INFO.stabilized is not None:
+            if expect_unstable:
+                FeatureDeprecated.single_use(
+                    f'module {ext_module.INFO.name} has been stabilized',
+                    ext_module.INFO.stabilized, self.subproject,
+                    'drop "unstable-" prefix from the module name',
+                    location=node)
+            else:
+                FeatureNew.single_use(
+                    f'module {ext_module.INFO.name} as stable module',
+                    ext_module.INFO.stabilized, self.subproject,
+                    f'Consider either adding "unstable-" to the module name, or updating the meson required version to ">= {ext_module.INFO.stabilized}"',
+                    location=node)
+        elif ext_module.INFO.unstable:
+            if not expect_unstable:
+                if required:
+                    raise InvalidArguments(f'Module "{ext_module.INFO.name}" has not been stabilized, and must be imported as unstable-{ext_module.INFO.name}')
+                ext_module = NotFoundExtensionModule(real_modname)
+            else:
+                mlog.warning(f'Module {ext_module.INFO.name} has no backwards or forwards compatibility and might not exist in future releases.', location=node, fatal=False)
+
+        self.modulesreal_modname = ext_module
+        return ext_module
 
     @typed_pos_args('files', varargs=str)
     @noKwargs
     def func_files(self, node: mparser.FunctionNode, args: T.TupleT.Liststr, kwargs: 'TYPE_kwargs') -> T.Listmesonlib.File:
         return self.source_strings_to_files(args0)
 
-    # Used by pkgconfig.generate()
-    def extract_variables(self, kwargs: T.Dictstr, T.UnionT.Dictstr, str, T.Liststr, str,
-                          argname: str = 'variables', list_new: bool = False,
-                          dict_new: bool = False) -> T.Dictstr, str:
-        variables = kwargs.get(argname, {})
-        if isinstance(variables, dict):
-            if dict_new and variables:
-                FeatureNew.single_use(f'{argname} as dictionary', '0.56.0', self.subproject, location=self.current_node)
-        else:
-            variables = mesonlib.stringlistify(variables)
-            if list_new:
-                FeatureNew.single_use(f'{argname} as list of strings', '0.56.0', self.subproject, location=self.current_node)
-
-        invalid_msg = variables_validator(variables)
-        if invalid_msg is not None:
-            raise InterpreterException(invalid_msg)
-
-        variables = variables_convertor(variables)
-        for k, v in variables.items():
-            if not isinstance(v, str):
-                raise InterpreterException('variables values must be strings.')
-
-        return variables
-
     @noPosargs
     @typed_kwargs(
         'declare_dependency',
@@ -760,14 +746,14 @@
     def func_run_command(self, node: mparser.BaseNode,
                          args: T.TupleT.Unionbuild.Executable, ExternalProgram, compilers.Compiler, mesonlib.File, str,
                                        T.ListT.Unionbuild.Executable, ExternalProgram, compilers.Compiler, mesonlib.File, str,
-                         kwargs: 'kwargs.RunCommand') -> RunProcess:
+                         kwargs: 'kwtypes.RunCommand') -> RunProcess:
         return self.run_command_impl(node, args, kwargs)
 
     def run_command_impl(self,
                          node: mparser.BaseNode,
                          args: T.TupleT.Unionbuild.Executable, ExternalProgram, compilers.Compiler, mesonlib.File, str,
                                        T.ListT.Unionbuild.Executable, ExternalProgram, compilers.Compiler, mesonlib.File, str,
-                         kwargs: 'kwargs.RunCommand',
+                         kwargs: 'kwtypes.RunCommand',
                          in_builddir: bool = False) -> RunProcess:
         cmd, cargs = args
         capture = kwargs'capture'
@@ -853,11 +839,11 @@
         DEFAULT_OPTIONS.evolve(since='0.38.0'),
         KwargInfo('version', ContainerTypeInfo(list, str), default=, listify=True),
     )
-    def func_subproject(self, nodes: mparser.BaseNode, args: T.Tuplestr, kwargs_: kwargs.Subproject) -> SubprojectHolder:
-        kw: kwargs.DoSubproject = {
-            'required': kwargs_'required',
-            'default_options': kwargs_'default_options',
-            'version': kwargs_'version',
+    def func_subproject(self, nodes: mparser.BaseNode, args: T.Tuplestr, kwargs: kwtypes.Subproject) -> SubprojectHolder:
+        kw: kwtypes.DoSubproject = {
+            'required': kwargs'required',
+            'default_options': kwargs'default_options',
+            'version': kwargs'version',
             'options': None,
             'cmake_options': ,
         }
@@ -870,7 +856,7 @@
         self.subprojectssubp_name = sub
         return sub
 
-    def do_subproject(self, subp_name: str, method: Literal'meson', 'cmake', kwargs: kwargs.DoSubproject) -> SubprojectHolder:
+    def do_subproject(self, subp_name: str, method: Literal'meson', 'cmake', kwargs: kwtypes.DoSubproject) -> SubprojectHolder:
         disabled, required, feature = extract_required_kwarg(kwargs, self.subproject)
         if disabled:
             mlog.log('Subproject', mlog.bold(subp_name), ':', 'skipped: feature', mlog.bold(feature), 'disabled')
@@ -946,7 +932,7 @@
 
     def _do_subproject_meson(self, subp_name: str, subdir: str,
                              default_options: T.DictOptionKey, str,
-                             kwargs: kwargs.DoSubproject,
+                             kwargs: kwtypes.DoSubproject,
                              ast: T.Optionalmparser.CodeBlockNode = None,
                              build_def_files: T.OptionalT.Liststr = None,
                              is_translated: bool = False,
@@ -997,7 +983,7 @@
 
     def _do_subproject_cmake(self, subp_name: str, subdir: str, subdir_abs: str,
                              default_options: T.DictOptionKey, str,
-                             kwargs: kwargs.DoSubproject) -> SubprojectHolder:
+                             kwargs: kwtypes.DoSubproject) -> SubprojectHolder:
         with mlog.nested(subp_name):
             new_build = self.build.copy()
             prefix = self.coredata.optionsOptionKey('prefix').value
@@ -1093,6 +1079,8 @@
             opt.name = optname
             return opt
         elif isinstance(opt, coredata.UserOption):
+            if isinstance(opt.value, str):
+                return P_OBJ.OptionString(opt.value, f'{{{optname}}}')
             return opt.value
         return opt
 
@@ -1147,7 +1135,7 @@
         KwargInfo('license', ContainerTypeInfo(list, str), default='unknown', listify=True),
         KwargInfo('subproject_dir', str, default='subprojects'),
     )
-    def func_project(self, node: mparser.FunctionNode, args: T.Tuplestr, T.Liststr, kwargs: 'kwargs.Project') -> None:
+    def func_project(self, node: mparser.FunctionNode, args: T.Tuplestr, T.Liststr, kwargs: 'kwtypes.Project') -> None:
         proj_name, proj_langs = args
         if ':' in proj_name:
             raise InvalidArguments(f"Project name {proj_name!r} must not contain ':'")
@@ -1263,7 +1251,7 @@
 
     @typed_kwargs('add_languages', KwargInfo('native', (bool, NoneType), since='0.54.0'), REQUIRED_KW)
     @typed_pos_args('add_languages', varargs=str)
-    def func_add_languages(self, node: mparser.FunctionNode, args: T.TupleT.Liststr, kwargs: 'kwargs.FuncAddLanguages') -> bool:
+    def func_add_languages(self, node: mparser.FunctionNode, args: T.TupleT.Liststr, kwargs: 'kwtypes.FuncAddLanguages') -> bool:
         langs = args0
         disabled, required, feature = extract_required_kwarg(kwargs, self.subproject)
         native = kwargs'native'
@@ -1287,7 +1275,7 @@
 
     @noArgsFlattening
     @noKwargs
-    def func_message(self, node, args, kwargs):
+    def func_message(self, node: mparser.BaseNode, args, kwargs):
         if len(args) > 1:
             FeatureNew.single_use('message with more than one argument', '0.54.0', self.subproject, location=node)
         args_str = stringifyUserArguments(i) for i in args
@@ -1306,7 +1294,7 @@
         KwargInfo('list_sep', (str, NoneType), since='0.54.0')
     )
     def func_summary(self, node: mparser.BaseNode, args: T.TupleT.Unionstr, T.Dictstr, T.Any, T.OptionalT.Any,
-                     kwargs: 'kwargs.Summary') -> None:
+                     kwargs: 'kwtypes.Summary') -> None:
         if args1 is None:
             if not isinstance(args0, dict):
                 raise InterpreterException('Summary first argument must be dictionary.')
@@ -1317,7 +1305,7 @@
             values = {args0: args1}
         self.summary_impl(kwargs'section', values, kwargs)
 
-    def summary_impl(self, section: str, values, kwargs: 'kwargs.Summary') -> None:
+    def summary_impl(self, section: str, values, kwargs: 'kwtypes.Summary') -> None:
         if self.subproject not in self.summary:
             self.summaryself.subproject = Summary(self.active_projectname, self.project_version)
         self.summaryself.subproject.add_section(
@@ -1339,7 +1327,7 @@
             self.summary_impl('Subprojects', all_subprojects,
                               {'bool_yn': True,
                                'list_sep': ' ',
-                              })
+                               })
         # Add automatic section with all user defined options
         if self.user_defined_options:
             values = collections.OrderedDict()
@@ -1387,9 +1375,9 @@
     @noKwargs
     @noPosargs
     def func_exception(self, node, args, kwargs):
-        raise Exception()
+        raise RuntimeError('unit test traceback :)')
 
-    def add_languages(self, args: T.Sequencestr, required: bool, for_machine: MachineChoice) -> bool:
+    def add_languages(self, args: T.Liststr, required: bool, for_machine: MachineChoice) -> bool:
         success = self.add_languages_for(args, required, for_machine)
         if not self.coredata.is_cross_build():
             self.coredata.copy_build_options_from_regular_ones()
@@ -1419,6 +1407,8 @@
         if 'vala' in langs and 'c' not in langs:
             FeatureNew.single_use('Adding Vala language without C', '0.59.0', self.subproject, location=self.current_node)
             args.append('c')
+        if 'nasm' in langs:
+            FeatureNew.single_use('Adding NASM language', '0.64.0', self.subproject, location=self.current_node)
 
         success = True
         for lang in sorted(args, key=compilers.sort_clink):
@@ -1476,7 +1466,9 @@
             if not isinstance(p, str):
                 raise InterpreterException('Executable name must be a string')
             prog = ExternalProgram.from_bin_list(self.environment, for_machine, p)
-            if prog.found():
+            # if the machine file specified something, it may be a regular
+            # not-found program but we still want to return that
+            if not isinstance(prog, NonExistingExternalProgram):
                 return prog
         return None
 
@@ -1623,7 +1615,7 @@
                               ) -> T.OptionalT.UnionExternalProgram, build.Executable, OverrideProgram:
         mlog.log('Fallback to subproject', mlog.bold(fallback), 'which provides program',
                  mlog.bold(' '.join(args)))
-        sp_kwargs: kwargs.DoSubproject = {
+        sp_kwargs: kwtypes.DoSubproject = {
             'required': required,
             'default_options': ,
             'version': ,
@@ -1644,7 +1636,7 @@
     )
     @disablerIfNotFound
     def func_find_program(self, node: mparser.BaseNode, args: T.TupleT.Listmesonlib.FileOrString,
-                          kwargs: 'kwargs.FindProgram',
+                          kwargs: 'kwtypes.FindProgram',
                           ) -> T.Union'build.Executable', ExternalProgram, 'OverrideProgram':
         disabled, required, feature = extract_required_kwarg(kwargs, self.subproject)
         if disabled:
@@ -1674,7 +1666,7 @@
     @disablerIfNotFound
     @permittedKwargs(permitted_dependency_kwargs)
     @typed_pos_args('dependency', varargs=str, min_varargs=1)
-    def func_dependency(self, node, args, kwargs):
+    def func_dependency(self, node: mparser.BaseNode, args: T.TupleT.Liststr, kwargs) -> Dependency:
         # Replace '' by empty list of names
         names = n for n in args0 if n
         if len(names) > 1:
@@ -1698,7 +1690,6 @@
         assert isinstance(d, Dependency)
         if not d.found() and not_found_message:
             self.message_impl(not_found_message)
-            self.message_impl(not_found_message)
         # Ensure the correct include type
         if 'include_type' in kwargs:
             wanted = kwargs'include_type'
@@ -1796,7 +1787,7 @@
         KwargInfo('fallback', (str, NoneType)),
         KwargInfo('replace_string', str, default='@VCS_TAG@'),
     )
-    def func_vcs_tag(self, node: mparser.BaseNode, args: T.List'TYPE_var', kwargs: 'kwargs.VcsTag') -> build.CustomTarget:
+    def func_vcs_tag(self, node: mparser.BaseNode, args: T.List'TYPE_var', kwargs: 'kwtypes.VcsTag') -> build.CustomTarget:
         if kwargs'fallback' is None:
             FeatureNew.single_use('Optional fallback in vcs_tag', '0.41.0', self.subproject, location=node)
         fallback = kwargs'fallback' or self.project_version
@@ -1825,20 +1816,22 @@
 
         self._validate_custom_target_outputs(len(kwargs'input') > 1, kwargs'output', "vcs_tag")
 
+        cmd = self.environment.get_build_command() + \
+            '--internal',
+             'vcstagger',
+             '@INPUT0@',
+             '@OUTPUT0@',
+             fallback,
+             source_dir,
+             replace_string,
+             regex_selector + vcs_cmd
+
         tg = build.CustomTarget(
             kwargs'output'0,
             self.subdir,
             self.subproject,
             self.environment,
-            self.environment.get_build_command() +
-                '--internal',
-                'vcstagger',
-                '@INPUT0@',
-                '@OUTPUT0@',
-                fallback,
-                source_dir,
-                replace_string,
-                regex_selector + vcs_cmd,
+            cmd,
             self.source_strings_to_files(kwargs'input'),
             kwargs'output',
             build_by_default=True,
@@ -1850,7 +1843,7 @@
     @FeatureNew('subdir_done', '0.46.0')
     @noPosargs
     @noKwargs
-    def func_subdir_done(self, node, args, kwargs):
+    def func_subdir_done(self, node: mparser.BaseNode, args: TYPE_var, kwargs: TYPE_kwargs) -> T.NoReturn:
         raise SubdirDoneRequest()
 
     @staticmethod
@@ -1862,7 +1855,7 @@
         """
         for out in outputs:
             if has_multi_in and ('@PLAINNAME@' in out or '@BASENAME@' in out):
-                raise InvalidArguments(f'{name}: output cannot containe "@PLAINNAME@" or "@BASENAME@" '
+                raise InvalidArguments(f'{name}: output cannot contain "@PLAINNAME@" or "@BASENAME@" '
                                        'when there is more than one input (we can\'t know which to use)')
 
     @typed_pos_args('custom_target', optargs=str)
@@ -1887,9 +1880,10 @@
         KwargInfo('console', bool, default=False, since='0.48.0'),
     )
     def func_custom_target(self, node: mparser.FunctionNode, args: T.Tuplestr,
-                           kwargs: 'kwargs.CustomTarget') -> build.CustomTarget:
+                           kwargs: 'kwtypes.CustomTarget') -> build.CustomTarget:
         if kwargs'depfile' and ('@BASENAME@' in kwargs'depfile' or '@PLAINNAME@' in kwargs'depfile'):
             FeatureNew.single_use('substitutions in custom_target depfile', '0.47.0', self.subproject, location=node)
+        install_mode = self._warn_kwarg_install_mode_sticky(kwargs'install_mode')
 
         # Don't mutate the kwargs
 
@@ -1972,7 +1966,7 @@
             feed=kwargs'feed',
             install=kwargs'install',
             install_dir=kwargs'install_dir',
-            install_mode=kwargs'install_mode',
+            install_mode=install_mode,
             install_tag=kwargs'install_tag',
             backend=self.backend)
         self.add_target(tg.name, tg)
@@ -1986,7 +1980,7 @@
         ENV_KW.evolve(since='0.57.0'),
     )
     def func_run_target(self, node: mparser.FunctionNode, args: T.Tuplestr,
-                        kwargs: 'kwargs.RunTarget') -> build.RunTarget:
+                        kwargs: 'kwtypes.RunTarget') -> build.RunTarget:
         all_args = kwargs'command'.copy()
 
         for i in listify(all_args):
@@ -1998,9 +1992,6 @@
         tg = build.RunTarget(name, all_args, kwargs'depends', self.subdir, self.subproject, self.environment,
                              kwargs'env')
         self.add_target(name, tg)
-        full_name = (self.subproject, name)
-        assert full_name not in self.build.run_target_names
-        self.build.run_target_names.add(full_name)
         return tg
 
     @FeatureNew('alias_target', '0.52.0')
@@ -2024,7 +2015,7 @@
     )
     def func_generator(self, node: mparser.FunctionNode,
                        args: T.TupleT.Unionbuild.Executable, ExternalProgram,
-                       kwargs: 'kwargs.FuncGenerator') -> build.Generator:
+                       kwargs: 'kwtypes.FuncGenerator') -> build.Generator:
         for rule in kwargs'output':
             if '@BASENAME@' not in rule and '@PLAINNAME@' not in rule:
                 raise InvalidArguments('Every element of "output" must contain @BASENAME@ or @PLAINNAME@.')
@@ -2040,17 +2031,17 @@
         return gen
 
     @typed_pos_args('benchmark', str, (build.Executable, build.Jar, ExternalProgram, mesonlib.File))
-    @typed_kwargs('benchmark', *TEST_KWARGS)
+    @typed_kwargs('benchmark', *TEST_KWS)
     def func_benchmark(self, node: mparser.BaseNode,
                        args: T.Tuplestr, T.Unionbuild.Executable, build.Jar, ExternalProgram, mesonlib.File,
-                       kwargs: 'kwargs.FuncBenchmark') -> None:
+                       kwargs: 'kwtypes.FuncBenchmark') -> None:
         self.add_test(node, args, kwargs, False)
 
     @typed_pos_args('test', str, (build.Executable, build.Jar, ExternalProgram, mesonlib.File))
-    @typed_kwargs('test', *TEST_KWARGS, KwargInfo('is_parallel', bool, default=True))
+    @typed_kwargs('test', *TEST_KWS, KwargInfo('is_parallel', bool, default=True))
     def func_test(self, node: mparser.BaseNode,
                   args: T.Tuplestr, T.Unionbuild.Executable, build.Jar, ExternalProgram, mesonlib.File,
-                  kwargs: 'kwargs.FuncTest') -> None:
+                  kwargs: 'kwtypes.FuncTest') -> None:
         self.add_test(node, args, kwargs, True)
 
     def unpack_env_kwarg(self, kwargs: T.Unionbuild.EnvironmentVariables, T.Dictstr, 'TYPE_var', T.List'TYPE_var', str) -> build.EnvironmentVariables:
@@ -2064,7 +2055,7 @@
 
     def make_test(self, node: mparser.BaseNode,
                   args: T.Tuplestr, T.Unionbuild.Executable, build.Jar, ExternalProgram, mesonlib.File,
-                  kwargs: 'kwargs.BaseTest') -> Test:
+                  kwargs: 'kwtypes.BaseTest') -> Test:
         name = args0
         if ':' in name:
             mlog.deprecation(f'":" is not allowed in test name "{name}", it has been replaced with "_"',
@@ -2117,14 +2108,15 @@
     @typed_pos_args('install_headers', varargs=(str, mesonlib.File))
     @typed_kwargs(
         'install_headers',
-        KwargInfo('preserve_path', bool, default=False, since='0.63.0'),
+        PRESERVE_PATH_KW,
         KwargInfo('subdir', (str, NoneType)),
         INSTALL_MODE_KW.evolve(since='0.47.0'),
         INSTALL_DIR_KW,
     )
     def func_install_headers(self, node: mparser.BaseNode,
                              args: T.TupleT.List'mesonlib.FileOrString',
-                             kwargs: 'kwargs.FuncInstallHeaders') -> build.Headers:
+                             kwargs: 'kwtypes.FuncInstallHeaders') -> build.Headers:
+        install_mode = self._warn_kwarg_install_mode_sticky(kwargs'install_mode')
         source_files = self.source_strings_to_files(args0)
         install_subdir = kwargs'subdir'
         if install_subdir is not None:
@@ -2146,7 +2138,7 @@
 
         for childdir in dirs:
             h = build.Headers(dirschilddir, os.path.join(install_subdir, childdir), kwargs'install_dir',
-                              kwargs'install_mode', self.subproject)
+                              install_mode, self.subproject)
             ret_headers.append(h)
             self.build.headers.append(h)
 
@@ -2161,7 +2153,8 @@
     )
     def func_install_man(self, node: mparser.BaseNode,
                          args: T.TupleT.List'mesonlib.FileOrString',
-                         kwargs: 'kwargs.FuncInstallMan') -> build.Man:
+                         kwargs: 'kwtypes.FuncInstallMan') -> build.Man:
+        install_mode = self._warn_kwarg_install_mode_sticky(kwargs'install_mode')
         # We just need to narrow this, because the input is limited to files and
         # Strings as inputs, so only Files will be returned
         sources = self.source_strings_to_files(args0)
@@ -2173,7 +2166,7 @@
             if not 1 <= num <= 9:
                 raise InvalidArguments('Man file must have a file extension of a number between 1 and 9')
 
-        m = build.Man(sources, kwargs'install_dir', kwargs'install_mode',
+        m = build.Man(sources, kwargs'install_dir', install_mode,
                       self.subproject, kwargs'locale')
         self.build.man.append(m)
 
@@ -2250,7 +2243,7 @@
             listify=True,
         ),
     )
-    def func_subdir(self, node: mparser.BaseNode, args: T.Tuplestr, kwargs: 'kwargs.Subdir') -> None:
+    def func_subdir(self, node: mparser.BaseNode, args: T.Tuplestr, kwargs: 'kwtypes.Subdir') -> None:
         mesonlib.check_direntry_issues(args)
         if '..' in args0:
             raise InvalidArguments('Subdir contains ..')
@@ -2317,6 +2310,20 @@
                                    'permissions arg to be a string or false')
         return FileMode(*install_mode)
 
+    # This is either ignored on basically any OS nowadays, or silently gets
+    # ignored (Solaris) or triggers an "illegal operation" error (FreeBSD).
+    # It was likely added "because it exists", but should never be used. In
+    # theory it is useful for directories, but we never apply modes to
+    # directories other than in install_emptydir.
+    def _warn_kwarg_install_mode_sticky(self, mode: FileMode) -> None:
+        if mode.perms > 0 and mode.perms & stat.S_ISVTX:
+            mlog.deprecation('install_mode with the sticky bit on a file does not do anything and will '
+                             'be ignored since Meson 0.64.0', location=self.current_node)
+            perms = stat.filemode(mode.perms - stat.S_ISVTX)1:
+            return FileMode(perms, mode.owner, mode.group)
+        else:
+            return mode
+
     @typed_pos_args('install_data', varargs=(str, mesonlib.File))
     @typed_kwargs(
         'install_data',
@@ -2325,10 +2332,11 @@
         INSTALL_MODE_KW.evolve(since='0.38.0'),
         INSTALL_TAG_KW.evolve(since='0.60.0'),
         INSTALL_DIR_KW,
+        PRESERVE_PATH_KW.evolve(since='0.64.0'),
     )
     def func_install_data(self, node: mparser.BaseNode,
                           args: T.TupleT.List'mesonlib.FileOrString',
-                          kwargs: 'kwargs.FuncInstallData') -> build.Data:
+                          kwargs: 'kwtypes.FuncInstallData') -> build.Data:
         sources = self.source_strings_to_files(args0 + kwargs'sources')
         rename = kwargs'rename' or None
         if rename:
@@ -2337,26 +2345,39 @@
                     '"rename" and "sources" argument lists must be the same length if "rename" is given. '
                     f'Rename has {len(rename)} elements and sources has {len(sources)}.')
 
-        install_dir_name = kwargs'install_dir'
-        if install_dir_name:
-            if not os.path.isabs(install_dir_name):
-                install_dir_name = os.path.join('{datadir}', install_dir_name)
-        else:
-            install_dir_name = '{datadir}'
-        return self.install_data_impl(sources, kwargs'install_dir', kwargs'install_mode',
-                                      rename, kwargs'install_tag', install_dir_name)
+        install_mode = self._warn_kwarg_install_mode_sticky(kwargs'install_mode')
+        return self.install_data_impl(sources, kwargs'install_dir', install_mode,
+                                      rename, kwargs'install_tag',
+                                      preserve_path=kwargs'preserve_path')
 
-    def install_data_impl(self, sources: T.Listmesonlib.File, install_dir: str,
+    def install_data_impl(self, sources: T.Listmesonlib.File, install_dir: T.Optionalstr,
                           install_mode: FileMode, rename: T.Optionalstr,
                           tag: T.Optionalstr,
                           install_dir_name: T.Optionalstr = None,
-                          install_data_type: T.Optionalstr = None) -> build.Data:
+                          install_data_type: T.Optionalstr = None,
+                          preserve_path: bool = False) -> build.Data:
 
         """Just the implementation with no validation."""
-        data = build.Data(sources, install_dir, install_dir_name or install_dir, install_mode,
-                          self.subproject, rename, tag, install_data_type)
-        self.build.data.append(data)
-        return data
+        idir = install_dir or ''
+        idir_name = install_dir_name or idir or '{datadir}'
+        if isinstance(idir_name, P_OBJ.OptionString):
+            idir_name = idir_name.optname
+        dirs = collections.defaultdict(list)
+        ret_data = 
+        if preserve_path:
+            for file in sources:
+                dirname = os.path.dirname(file.fname)
+                dirsdirname.append(file)
+        else:
+            dirs''.extend(sources)
+
+        for childdir, files in dirs.items():
+            d = build.Data(files, os.path.join(idir, childdir), os.path.join(idir_name, childdir),
+                           install_mode, self.subproject, rename, tag, install_data_type)
+            ret_data.append(d)
+
+        self.build.data.extend(ret_data)
+        return ret_data
 
     @typed_pos_args('install_subdir', str)
     @typed_kwargs(
@@ -2373,7 +2394,7 @@
         INSTALL_TAG_KW.evolve(since='0.60.0'),
     )
     def func_install_subdir(self, node: mparser.BaseNode, args: T.Tuplestr,
-                            kwargs: 'kwargs.FuncInstallSubdir') -> build.InstallDir:
+                            kwargs: 'kwtypes.FuncInstallSubdir') -> build.InstallDir:
         exclude = (set(kwargs'exclude_files'), set(kwargs'exclude_directories'))
 
         srcdir = os.path.join(self.environment.source_dir, self.subdir, args0)
@@ -2381,12 +2402,18 @@
             FeatureNew.single_use('install_subdir with empty directory', '0.47.0', self.subproject, location=node)
             FeatureDeprecated.single_use('install_subdir with empty directory', '0.60.0', self.subproject,
                                          'It worked by accident and is buggy. Use install_emptydir instead.', node)
+        install_mode = self._warn_kwarg_install_mode_sticky(kwargs'install_mode')
+
+        idir_name = kwargs'install_dir'
+        if isinstance(idir_name, P_OBJ.OptionString):
+            idir_name = idir_name.optname
 
         idir = build.InstallDir(
             self.subdir,
             args0,
             kwargs'install_dir',
-            kwargs'install_mode',
+            idir_name,
+            install_mode,
             exclude,
             kwargs'strip_directory',
             self.subproject,
@@ -2410,7 +2437,10 @@
             'configuration',
             (ContainerTypeInfo(dict, (str, int, bool)), build.ConfigurationData, NoneType),
         ),
-        KwargInfo('copy', bool, default=False, since='0.47.0'),
+        KwargInfo(
+            'copy', bool, default=False, since='0.47.0',
+            deprecated='0.64.0', deprecated_message='Use fs.copyfile instead',
+        ),
         KwargInfo('encoding', str, default='utf-8', since='0.47.0'),
         KwargInfo('format', str, default='meson', since='0.46.0',
                   validator=in_set_validator({'meson', 'cmake', 'cmake@'})),
@@ -2429,8 +2459,8 @@
                   validator=in_set_validator({'c', 'nasm'})),
     )
     def func_configure_file(self, node: mparser.BaseNode, args: T.ListTYPE_var,
-                            kwargs: kwargs.ConfigureFile):
-        actions = sorted(x for x in {'configuration', 'command', 'copy'}
+                            kwargs: kwtypes.ConfigureFile):
+        actions = sorted(x for x in 'configuration', 'command', 'copy'
                          if kwargsx not in None, False)
         num_actions = len(actions)
         if num_actions == 0:
@@ -2449,6 +2479,8 @@
         if kwargs'capture' and not kwargs'command':
             raise InvalidArguments('configure_file: "capture" keyword requires "command" keyword.')
 
+        install_mode = self._warn_kwarg_install_mode_sticky(kwargs'install_mode')
+
         fmt = kwargs'format'
         output_format = kwargs'output_format'
         depfile = kwargs'depfile'
@@ -2503,7 +2535,7 @@
                     mesonlib.do_conf_file(inputs_abs0, ofile_abs, conf,
                                           fmt, file_encoding)
                 if missing_variables:
-                    var_list = ", ".join(map(repr, sorted(missing_variables)))
+                    var_list = ", ".join(repr(m) for m in sorted(missing_variables))
                     mlog.warning(
                         f"The variable(s) {var_list} in the input file '{inputs0}' are not "
                         "present in the given configuration data.", location=node)
@@ -2570,15 +2602,24 @@
             if not idir:
                 raise InterpreterException(
                     '"install_dir" must be specified when "install" in a configure_file is true')
+            idir_name = idir
+            if isinstance(idir_name, P_OBJ.OptionString):
+                idir_name = idir_name.optname
             cfile = mesonlib.File.from_built_file(ofile_path, ofile_fname)
-            install_mode = kwargs'install_mode'
             install_tag = kwargs'install_tag'
-            self.build.data.append(build.Data(cfile, idir, idir, install_mode, self.subproject,
+            self.build.data.append(build.Data(cfile, idir, idir_name, install_mode, self.subproject,
                                               install_tag=install_tag, data_type='configure'))
         return mesonlib.File.from_built_file(self.subdir, output)
 
     def extract_incdirs(self, kwargs, key: str = 'include_directories'):
         prospectives = extract_as_list(kwargs, key)
+        if key == 'include_directories':
+            for i in prospectives:
+                if isinstance(i, str):
+                    FeatureNew.single_use('include_directories kwarg of type string', '0.50.0', self.subproject,
+                                          f'Use include_directories({i!r}) instead', location=self.current_node)
+                    break
+
         result = 
         for p in prospectives:
             if isinstance(p, build.IncludeDirs):
@@ -2592,7 +2633,7 @@
     @typed_pos_args('include_directories', varargs=str)
     @typed_kwargs('include_directories', KwargInfo('is_system', bool, default=False))
     def func_include_directories(self, node: mparser.BaseNode, args: T.TupleT.Liststr,
-                                 kwargs: 'kwargs.FuncIncludeDirectories') -> build.IncludeDirs:
+                                 kwargs: 'kwtypes.FuncIncludeDirectories') -> build.IncludeDirs:
         return self.build_incdir_object(args0, kwargs'is_system')
 
     def build_incdir_object(self, incdir_strings: T.Liststr, is_system: bool = False) -> build.IncludeDirs:
@@ -2606,8 +2647,9 @@
         for a in incdir_strings:
             if a.startswith(src_root):
                 raise InvalidArguments(textwrap.dedent('''\
-                    Tried to form an absolute path to a source dir.
-                    You should not do that but use relative paths instead.
+                    Tried to form an absolute path to a dir in the source tree.
+                    You should not do that but use relative paths instead, for
+                    directories that are part of your project.
 
                     To get include path to any directory relative to the current dir do
 
@@ -2622,6 +2664,10 @@
                     put in the include directories by default so you only need to do
                     include_directories('.') if you intend to use the result in a
                     different subdirectory.
+
+                    Note that this error message can also be triggered by
+                    external dependencies being installed within your source
+                    tree - it's not recommended to do this.
                     '''))
             else:
                 try:
@@ -2667,7 +2713,7 @@
         KwargInfo('is_default', bool, default=False, since='0.49.0'),
         ENV_KW,
     )
-    def func_add_test_setup(self, node: mparser.BaseNode, args: T.Tuplestr, kwargs: 'kwargs.AddTestSetup') -> None:
+    def func_add_test_setup(self, node: mparser.BaseNode, args: T.Tuplestr, kwargs: 'kwtypes.AddTestSetup') -> None:
         setup_name = args0
         if re.fullmatch('(_a-zA-Z_0-9a-zA-Z*:)?_a-zA-Z_0-9a-zA-Z*', setup_name) is None:
             raise InterpreterException('Setup name may only contain alphanumeric characters.')
@@ -2697,28 +2743,28 @@
 
     @typed_pos_args('add_global_arguments', varargs=str)
     @typed_kwargs('add_global_arguments', NATIVE_KW, LANGUAGE_KW)
-    def func_add_global_arguments(self, node: mparser.FunctionNode, args: T.TupleT.Liststr, kwargs: 'kwargs.FuncAddProjectArgs') -> None:
+    def func_add_global_arguments(self, node: mparser.FunctionNode, args: T.TupleT.Liststr, kwargs: 'kwtypes.FuncAddProjectArgs') -> None:
         self._add_global_arguments(node, self.build.global_argskwargs'native', args0, kwargs)
 
     @typed_pos_args('add_global_link_arguments', varargs=str)
     @typed_kwargs('add_global_arguments', NATIVE_KW, LANGUAGE_KW)
-    def func_add_global_link_arguments(self, node: mparser.FunctionNode, args: T.TupleT.Liststr, kwargs: 'kwargs.FuncAddProjectArgs') -> None:
+    def func_add_global_link_arguments(self, node: mparser.FunctionNode, args: T.TupleT.Liststr, kwargs: 'kwtypes.FuncAddProjectArgs') -> None:
         self._add_global_arguments(node, self.build.global_link_argskwargs'native', args0, kwargs)
 
     @typed_pos_args('add_project_arguments', varargs=str)
     @typed_kwargs('add_project_arguments', NATIVE_KW, LANGUAGE_KW)
-    def func_add_project_arguments(self, node: mparser.FunctionNode, args: T.TupleT.Liststr, kwargs: 'kwargs.FuncAddProjectArgs') -> None:
+    def func_add_project_arguments(self, node: mparser.FunctionNode, args: T.TupleT.Liststr, kwargs: 'kwtypes.FuncAddProjectArgs') -> None:
         self._add_project_arguments(node, self.build.projects_argskwargs'native', args0, kwargs)
 
     @typed_pos_args('add_project_link_arguments', varargs=str)
     @typed_kwargs('add_global_arguments', NATIVE_KW, LANGUAGE_KW)
-    def func_add_project_link_arguments(self, node: mparser.FunctionNode, args: T.TupleT.Liststr, kwargs: 'kwargs.FuncAddProjectArgs') -> None:
+    def func_add_project_link_arguments(self, node: mparser.FunctionNode, args: T.TupleT.Liststr, kwargs: 'kwtypes.FuncAddProjectArgs') -> None:
         self._add_project_arguments(node, self.build.projects_link_argskwargs'native', args0, kwargs)
 
     @FeatureNew('add_project_dependencies', '0.63.0')
     @typed_pos_args('add_project_dependencies', varargs=dependencies.Dependency)
     @typed_kwargs('add_project_dependencies', NATIVE_KW, LANGUAGE_KW)
-    def func_add_project_dependencies(self, node: mparser.FunctionNode, args: T.TupleT.Listdependencies.Dependency, kwargs: 'kwargs.FuncAddProjectArgs') -> None:
+    def func_add_project_dependencies(self, node: mparser.FunctionNode, args: T.TupleT.Listdependencies.Dependency, kwargs: 'kwtypes.FuncAddProjectArgs') -> None:
         for_machine = kwargs'native'
         for lang in kwargs'language':
             if lang not in self.compilersfor_machine:
@@ -2764,7 +2810,7 @@
                              location=self.current_node)
 
     def _add_global_arguments(self, node: mparser.FunctionNode, argsdict: T.Dictstr, T.Liststr,
-                              args: T.Liststr, kwargs: 'kwargs.FuncAddProjectArgs') -> None:
+                              args: T.Liststr, kwargs: 'kwtypes.FuncAddProjectArgs') -> None:
         if self.is_subproject():
             msg = f'Function \'{node.func_name}\' cannot be used in subprojects because ' \
                   'there is no way to make that reliable.\nPlease only call ' \
@@ -2777,14 +2823,14 @@
         self._add_arguments(node, argsdict, frozen, args, kwargs)
 
     def _add_project_arguments(self, node: mparser.FunctionNode, argsdict: T.Dictstr, T.Dictstr, T.Liststr,
-                               args: T.Liststr, kwargs: 'kwargs.FuncAddProjectArgs') -> None:
+                               args: T.Liststr, kwargs: 'kwtypes.FuncAddProjectArgs') -> None:
         if self.subproject not in argsdict:
             argsdictself.subproject = {}
         self._add_arguments(node, argsdictself.subproject,
                             self.project_args_frozen, args, kwargs)
 
     def _add_arguments(self, node: mparser.FunctionNode, argsdict: T.Dictstr, T.Liststr,
-                       args_frozen: bool, args: T.Liststr, kwargs: 'kwargs.FuncAddProjectArgs') -> None:
+                       args_frozen: bool, args: T.Liststr, kwargs: 'kwtypes.FuncAddProjectArgs') -> None:
         if args_frozen:
             msg = f'Tried to use \'{node.func_name}\' after a build target has been declared.\n' \
                   'This is not permitted. Please declare all arguments before your targets.'
@@ -2819,6 +2865,9 @@
         ret = os.path.join(*parts).replace('\\', '/')
         if isinstance(parts0, P_OBJ.DependencyVariableString) and '..' not in other:
             return P_OBJ.DependencyVariableString(ret)
+        elif isinstance(parts0, P_OBJ.OptionString):
+            name = os.path.join(parts0.optname, other)
+            return P_OBJ.OptionString(ret, name)
         else:
             return ret
 
@@ -2993,6 +3042,7 @@
     @FeatureNew('both_libraries', '0.46.0')
     def build_both_libraries(self, node, args, kwargs):
         shared_lib = self.build_target(node, args, kwargs, build.SharedLibrary)
+        static_lib = self.build_target(node, args, kwargs, build.StaticLibrary)
 
         # Check if user forces non-PIC static library.
         pic = True
@@ -3014,16 +3064,16 @@
             reuse_object_files = pic
 
         if reuse_object_files:
-            # Exclude sources from args and kwargs to avoid building them twice
-            static_args = args0
-            static_kwargs = kwargs.copy()
-            static_kwargs'sources' = 
-            static_kwargs'objects' = shared_lib.extract_all_objects()
-        else:
-            static_args = args
-            static_kwargs = kwargs
-
-        static_lib = self.build_target(node, static_args, static_kwargs, build.StaticLibrary)
+            # Replace sources with objects from the shared library to avoid
+            # building them twice. We post-process the static library instead of
+            # removing sources from args because sources could also come from
+            # any InternalDependency, see BuildTarget.add_deps().
+            static_lib.objects.append(build.ExtractedObjects(shared_lib, shared_lib.sources, shared_lib.generated, ))
+            static_lib.sources = 
+            static_lib.generated = 
+            # Compilers with no corresponding sources confuses the backend.
+            # Keep only compilers used for linking
+            static_lib.compilers = {k: v for k, v in static_lib.compilers.items() if k in compilers.clink_langs}
 
         return build.BothLibraries(shared_lib, static_lib)
 
@@ -3041,7 +3091,7 @@
     def build_target(self, node: mparser.BaseNode, args, kwargs, targetclass):
         @FeatureNewKwargs('build target', '0.42.0', 'rust_crate_type', 'build_rpath', 'implicit_include_directories')
         @FeatureNewKwargs('build target', '0.41.0', 'rust_args')
-        @FeatureNewKwargs('build target', '0.40.0', 'build_by_default')
+        @FeatureNewKwargs('build target', '0.38.0', 'build_by_default')
         @FeatureNewKwargs('build target', '0.48.0', 'gnu_symbol_visibility')
         def build_target_decorator_caller(self, node, args, kwargs):
             return True

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/interpreter/interpreterobjects.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/interpreter/interpreterobjects.py Changed

@@ -81,7 +81,7 @@
             continue
         if not d.is_absolute():
             raise InvalidCode(f'Search directory {d} is not an absolute path.')
-    return list(map(str, search_dirs))
+    return str(s) for s in search_dirs
 
 class FeatureOptionHolder(ObjectHoldercoredata.UserFeatureOption):
     def __init__(self, option: coredata.UserFeatureOption, interpreter: 'Interpreter'):
@@ -200,7 +200,7 @@
         child_env.update(menv)
         child_env = env.get_env(child_env)
         stdout = subprocess.PIPE if self.capture else subprocess.DEVNULL
-        mlog.debug('Running command:', ' '.join(command_array))
+        mlog.debug('Running command:', mesonlib.join_args(command_array))
         try:
             p, o, e = Popen_safe(command_array, stdout=stdout, env=child_env, cwd=cwd)
             if self.capture:
@@ -214,11 +214,11 @@
             mlog.debug('')
 
             if check and p.returncode != 0:
-                raise InterpreterException('Command "{}" failed with status {}.'.format(' '.join(command_array), p.returncode))
+                raise InterpreterException('Command `{}` failed with status {}.'.format(mesonlib.join_args(command_array), p.returncode))
 
             return p.returncode, o, e
         except FileNotFoundError:
-            raise InterpreterException('Could not execute command "%s".' % ' '.join(command_array))
+            raise InterpreterException('Could not execute command `%s`.' % mesonlib.join_args(command_array))
 
     @noPosargs
     @noKwargs
@@ -323,7 +323,7 @@
     @typed_kwargs('configuration_data.set10', _CONF_DATA_SET_KWS)
     def set10_method(self, args: T.Tuplestr, T.Unionint, bool, kwargs: 'kwargs.ConfigurationDataSet') -> None:
         self.__check_used()
-        # bool is a subclass of int, so we need to check for bool excplicitly.
+        # bool is a subclass of int, so we need to check for bool explicitly.
         # We already have typed_pos_args checking that this is either a bool or
         # an int.
         if not isinstance(args1, bool):

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/interpreter/kwargs.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/interpreter/kwargs.py Changed

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/interpreter/primitives/__init__.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/interpreter/primitives/__init__.py Changed

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/interpreter/primitives/range.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/interpreter/primitives/range.py Changed

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/interpreter/primitives/string.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/interpreter/primitives/string.py Changed

@@ -64,6 +64,8 @@
         self.operators.update({
             MesonOperator.DIV: self.op_div,
             MesonOperator.INDEX: self.op_index,
+            MesonOperator.IN: self.op_in,
+            MesonOperator.NOT_IN: self.op_notin,
         })
 
     def display_name(self) -> str:
@@ -157,10 +159,14 @@
     def version_compare_method(self, args: T.Tuplestr, kwargs: TYPE_kwargs) -> bool:
         return version_compare(self.held_object, args0)
 
+    @staticmethod
+    def _op_div(this: str, other: str) -> str:
+        return os.path.join(this, other).replace('\\', '/')
+
     @FeatureNew('/ with string arguments', '0.49.0')
     @typed_operator(MesonOperator.DIV, str)
     def op_div(self, other: str) -> str:
-        return os.path.join(self.held_object, other).replace('\\', '/')
+        return self._op_div(self.held_object, other)
 
     @typed_operator(MesonOperator.INDEX, int)
     def op_index(self, other: int) -> str:
@@ -169,6 +175,16 @@
         except IndexError:
             raise InvalidArguments(f'Index {other} out of bounds of string of size {len(self.held_object)}.')
 
+    @FeatureNew('"in" string operator', '1.0.0')
+    @typed_operator(MesonOperator.IN, str)
+    def op_in(self, other: str) -> bool:
+        return other in self.held_object
+
+    @FeatureNew('"not in" string operator', '1.0.0')
+    @typed_operator(MesonOperator.NOT_IN, str)
+    def op_notin(self, other: str) -> bool:
+        return other not in self.held_object
+
 
 class MesonVersionString(str):
     pass
@@ -194,3 +210,24 @@
         if '..' in other:
             return ret
         return DependencyVariableString(ret)
+
+
+class OptionString(str):
+    optname: str
+
+    def __new__(cls, value: str, name: str) -> 'OptionString':
+        obj = str.__new__(cls, value)
+        obj.optname = name
+        return obj
+
+    def __getnewargs__(self) -> T.Tuplestr, str: # type: ignore # because the entire point of this is to diverge
+        return (str(self), self.optname)
+
+
+class OptionStringHolder(StringHolder):
+    held_object: OptionString
+
+    def op_div(self, other: str) -> T.Unionstr, OptionString:
+        ret = super().op_div(other)
+        name = self._op_div(self.held_object.optname, other)
+        return OptionString(ret, name)

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/interpreter/type_checking.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/interpreter/type_checking.py Changed

@@ -8,13 +8,15 @@
 import typing as T
 
 from .. import compilers
-from ..build import (EnvironmentVariables, EnvInitValueType, CustomTarget, BuildTarget,
+from ..build import (CustomTarget, BuildTarget,
                      CustomTargetIndex, ExtractedObjects, GeneratedList, IncludeDirs,
                      BothLibraries, SharedLibrary, StaticLibrary, Jar, Executable)
 from ..coredata import UserFeatureOption
 from ..dependencies import Dependency, InternalDependency
+from ..interpreterbase import FeatureNew
 from ..interpreterbase.decorators import KwargInfo, ContainerTypeInfo
-from ..mesonlib import File, FileMode, MachineChoice, listify, has_path_sep, OptionKey
+from ..mesonlib import (File, FileMode, MachineChoice, listify, has_path_sep,
+                        OptionKey, EnvironmentVariables)
 from ..programs import ExternalProgram
 
 # Helper definition for type checks that are `OptionalT`
@@ -24,6 +26,11 @@
     from typing_extensions import Literal
 
     from ..interpreterbase import TYPE_var
+    from ..interpreterbase.decorators import FeatureCheckBase
+    from ..mesonlib import EnvInitValueType
+
+    _FullEnvInitValueType = T.UnionEnvironmentVariables, T.Liststr, T.ListT.Liststr, EnvInitValueType, str, None
+
 
 def in_set_validator(choices: T.Setstr) -> T.Callablestr, T.Optionalstr:
     """Check that the choice given was one of the given set."""
@@ -109,7 +116,9 @@
     return i.lower() for i in input
 
 
-def variables_validator(contents: T.UnionT.Liststr, T.Dictstr, str) -> T.Optionalstr:
+def variables_validator(contents: T.Unionstr, T.Liststr, T.Dictstr, str) -> T.Optionalstr:
+    if isinstance(contents, str):
+        contents = contents
     if isinstance(contents, dict):
         variables = contents
     else:
@@ -130,7 +139,9 @@
     return None
 
 
-def variables_convertor(contents: T.UnionT.Liststr, T.Dictstr, str) -> T.Dictstr, str:
+def variables_convertor(contents: T.Unionstr, T.Liststr, T.Dictstr, str) -> T.Dictstr, str:
+    if isinstance(contents, str):
+        contents = contents
     if isinstance(contents, dict):
         return contents
     variables = {}
@@ -213,8 +224,6 @@
     a, b = input.split('=', 1)
     return (a, b)
 
-_FullEnvInitValueType = T.UnionEnvironmentVariables, T.Liststr, T.ListT.Liststr, EnvInitValueType, str, None
-
 # Split _env_convertor() and env_convertor_with_method() to make mypy happy.
 # It does not want extra arguments in KwargInfo convertor callable.
 def env_convertor_with_method(value: _FullEnvInitValueType,
@@ -367,6 +376,13 @@
     default=,
 )
 
+def include_dir_string_new(val: T.ListT.Unionstr, IncludeDirs) -> T.IterableFeatureCheckBase:
+    strs = v for v in val if isinstance(v, str)
+    if strs:
+        str_msg = ", ".join(f"'{s}'" for s in strs)
+        yield FeatureNew('include_directories kwarg of type string', '1.0.0',
+                         f'Use include_directories({str_msg}) instead')
+
 # for cases like default_options and override_options
 DEFAULT_OPTIONS: KwargInfoT.Liststr = KwargInfo(
     'default_options',
@@ -377,7 +393,7 @@
 )
 
 ENV_METHOD_KW = KwargInfo('method', str, default='set', since='0.62.0',
-    validator=in_set_validator({'set', 'prepend', 'append'}))
+                          validator=in_set_validator({'set', 'prepend', 'append'}))
 
 ENV_SEPARATOR_KW = KwargInfo('separator', str, default=os.pathsep)
 
@@ -405,7 +421,7 @@
     ContainerTypeInfo(list, (BothLibraries, SharedLibrary, StaticLibrary, CustomTarget, CustomTargetIndex, Jar, Executable, Dependency)),
     listify=True,
     default=,
-    validator=lambda x: _link_with_error if isinstance(x, Dependency) else None,
+    validator=lambda x: _link_with_error if any(isinstance(i, Dependency) for i in x) else None,
 )
 
 def link_whole_validator(values: T.ListT.UnionStaticLibrary, CustomTarget, CustomTargetIndex, Dependency) -> T.Optionalstr:
@@ -433,8 +449,31 @@
 
 VARIABLES_KW: KwargInfoT.Dictstr, str = KwargInfo(
     'variables',
-    (ContainerTypeInfo(list, str), ContainerTypeInfo(dict, str)),
+    # str is listified by validator/convertor, cannot use listify=True here because
+    # that would listify dict too.
+    (str, ContainerTypeInfo(list, str), ContainerTypeInfo(dict, str)), # type: ignore
     validator=variables_validator,
     convertor=variables_convertor,
     default={},
 )
+
+PRESERVE_PATH_KW: KwargInfobool = KwargInfo('preserve_path', bool, default=False, since='0.63.0')
+
+TEST_KWS: T.ListKwargInfo = 
+    KwargInfo('args', ContainerTypeInfo(list, (str, File, BuildTarget, CustomTarget, CustomTargetIndex)),
+              listify=True, default=),
+    KwargInfo('should_fail', bool, default=False),
+    KwargInfo('timeout', int, default=30),
+    KwargInfo('workdir', (str, NoneType), default=None,
+              validator=lambda x: 'must be an absolute path' if not os.path.isabs(x) else None),
+    KwargInfo('protocol', str,
+              default='exitcode',
+              validator=in_set_validator({'exitcode', 'tap', 'gtest', 'rust'}),
+              since_values={'gtest': '0.55.0', 'rust': '0.57.0'}),
+    KwargInfo('priority', int, default=0, since='0.52.0'),
+    # TODO: env needs reworks of the way the environment variable holder itself works probably
+    ENV_KW,
+    DEPENDS_KW.evolve(since='0.46.0'),
+    KwargInfo('suite', ContainerTypeInfo(list, str), listify=True, default=''),  # yes, a list of empty string
+    KwargInfo('verbose', bool, default=False, since='0.62.0'),
+

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/interpreterbase/baseobjects.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/interpreterbase/baseobjects.py Changed

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/interpreterbase/decorators.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/interpreterbase/decorators.py Changed

@@ -382,6 +382,7 @@
         added in.
     :param not_set_warning: A warning message that is logged if the kwarg is not
         set by the user.
+    :param feature_validator: A callable returning an iterable of FeatureNew | FeatureDeprecated objects.
     """
     def __init__(self, name: str,
                  types: T.UnionT.Type_T, T.TupleT.UnionT.Type_T, ContainerTypeInfo, ..., ContainerTypeInfo,
@@ -389,10 +390,11 @@
                  default: T.Optional_T = None,
                  since: T.Optionalstr = None,
                  since_message: T.Optionalstr = None,
-                 since_values: T.OptionalT.Dict_T, T.Unionstr, T.Tuplestr, str = None,
+                 since_values: T.OptionalT.DictT.Union_T, T.TypeT.List, T.TypeT.Dict, T.Unionstr, T.Tuplestr, str = None,
                  deprecated: T.Optionalstr = None,
                  deprecated_message: T.Optionalstr = None,
-                 deprecated_values: T.OptionalT.Dict_T, T.Unionstr, T.Tuplestr, str = None,
+                 deprecated_values: T.OptionalT.DictT.Union_T, T.TypeT.List, T.TypeT.Dict, T.Unionstr, T.Tuplestr, str = None,
+                 feature_validator: T.OptionalT.Callable_T, T.IterableFeatureCheckBase = None,
                  validator: T.OptionalT.CallableT.Any, T.Optionalstr = None,
                  convertor: T.OptionalT.Callable_T, object = None,
                  not_set_warning: T.Optionalstr = None):
@@ -404,6 +406,7 @@
         self.since = since
         self.since_message = since_message
         self.since_values = since_values
+        self.feature_validator = feature_validator
         self.deprecated = deprecated
         self.deprecated_message = deprecated_message
         self.deprecated_values = deprecated_values
@@ -418,10 +421,11 @@
                default: T.Union_T, None, _NULL_T = _NULL,
                since: T.Unionstr, None, _NULL_T = _NULL,
                since_message: T.Unionstr, None, _NULL_T = _NULL,
-               since_values: T.UnionT.Dict_T, T.Unionstr, T.Tuplestr, str, None, _NULL_T = _NULL,
+               since_values: T.UnionT.DictT.Union_T, T.TypeT.List, T.TypeT.Dict, T.Unionstr, T.Tuplestr, str, None, _NULL_T = _NULL,
                deprecated: T.Unionstr, None, _NULL_T = _NULL,
                deprecated_message: T.Unionstr, None, _NULL_T = _NULL,
-               deprecated_values: T.UnionT.Dict_T, T.Unionstr, T.Tuplestr, str, None, _NULL_T = _NULL,
+               deprecated_values: T.UnionT.DictT.Union_T, T.TypeT.List, T.TypeT.Dict, T.Unionstr, T.Tuplestr, str, None, _NULL_T = _NULL,
+               feature_validator: T.UnionT.Callable_T, T.IterableFeatureCheckBase, None, _NULL_T = _NULL,
                validator: T.UnionT.Callable_T, T.Optionalstr, None, _NULL_T = _NULL,
                convertor: T.UnionT.Callable_T, TYPE_var, None, _NULL_T = _NULL) -> 'KwargInfo':
         """Create a shallow copy of this KwargInfo, with modifications.
@@ -447,12 +451,13 @@
             deprecated=deprecated if not isinstance(deprecated, _NULL_T) else self.deprecated,
             deprecated_message=deprecated_message if not isinstance(deprecated_message, _NULL_T) else self.deprecated_message,
             deprecated_values=deprecated_values if not isinstance(deprecated_values, _NULL_T) else self.deprecated_values,
+            feature_validator=feature_validator if not isinstance(feature_validator, _NULL_T) else self.feature_validator,
             validator=validator if not isinstance(validator, _NULL_T) else self.validator,
             convertor=convertor if not isinstance(convertor, _NULL_T) else self.convertor,
         )
 
 
-def typed_kwargs(name: str, *types: KwargInfo) -> T.Callable..., T.Any:
+def typed_kwargs(name: str, *types: KwargInfo, allow_unknown: bool = False) -> T.Callable..., T.Any:
     """Decorator for type checking keyword arguments.
 
     Used to wrap a meson DSL implementation function, where it checks various
@@ -529,11 +534,12 @@
             # Cast here, as the convertor function may place something other than a TYPE_var in the kwargs
             kwargs = T.cast('T.Dictstr, object', _kwargs)
 
-            all_names = {t.name for t in types}
-            unknowns = set(kwargs).difference(all_names)
-            if unknowns:
-                ustr = ', '.join(f'"{u}"' for u in sorted(unknowns))
-                raise InvalidArguments(f'{name} got unknown keyword arguments {ustr}')
+            if not allow_unknown:
+                all_names = {t.name for t in types}
+                unknowns = set(kwargs).difference(all_names)
+                if unknowns:
+                    ustr = ', '.join(f'"{u}"' for u in sorted(unknowns))
+                    raise InvalidArguments(f'{name} got unknown keyword arguments {ustr}')
 
             for info in types:
                 types_tuple = info.types if isinstance(info.types, tuple) else (info.types,)
@@ -556,6 +562,10 @@
                         if msg is not None:
                             raise InvalidArguments(f'{name} keyword argument "{info.name}" {msg}')
 
+                    if info.feature_validator is not None:
+                        for each in info.feature_validator(value):
+                            each.use(subproject, node)
+
                     if info.deprecated_values is not None:
                         emit_feature_change(info.deprecated_values, FeatureDeprecated)

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/interpreterbase/helpers.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/interpreterbase/helpers.py Changed

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/interpreterbase/interpreterbase.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/interpreterbase/interpreterbase.py Changed

@@ -27,8 +27,6 @@
     ObjectHolder,
     IterableObject,
 
-    TYPE_var,
-
     HoldableTypes,
 )
 
@@ -52,26 +50,26 @@
 import textwrap
 
 if T.TYPE_CHECKING:
-    from .baseobjects import SubProject, TYPE_kwargs
+    from .baseobjects import SubProject, TYPE_kwargs, TYPE_var
     from ..interpreter import Interpreter
 
-HolderMapType = T.Dict
-    T.Union
-        T.Typemesonlib.HoldableObject,
-        T.Typeint,
-        T.Typebool,
-        T.Typestr,
-        T.Typelist,
-        T.Typedict,
-    ,
-    # For some reason, this has to be a callable and can't just be ObjectHolderInterpreterObjectTypeVar
-    T.CallableInterpreterObjectTypeVar, 'Interpreter', ObjectHolderInterpreterObjectTypeVar
-
-
-FunctionType = T.Dict
-    str,
-    T.Callablemparser.BaseNode, T.ListTYPE_var, T.Dictstr, TYPE_var, TYPE_var
-
+    HolderMapType = T.Dict
+        T.Union
+            T.Typemesonlib.HoldableObject,
+            T.Typeint,
+            T.Typebool,
+            T.Typestr,
+            T.Typelist,
+            T.Typedict,
+        ,
+        # For some reason, this has to be a callable and can't just be ObjectHolderInterpreterObjectTypeVar
+        T.CallableInterpreterObjectTypeVar, 'Interpreter', ObjectHolderInterpreterObjectTypeVar
+    
+
+    FunctionType = T.Dict
+        str,
+        T.Callablemparser.BaseNode, T.ListTYPE_var, T.Dictstr, TYPE_var, TYPE_var
+    
 
 class InterpreterBase:
     def __init__(self, source_root: str, subdir: str, subproject: 'SubProject'):
@@ -469,9 +467,10 @@
         invokable = node.source_object
         obj: T.OptionalInterpreterObject
         if isinstance(invokable, mparser.IdNode):
-            object_name = invokable.value
-            obj = self.get_variable(object_name)
+            object_display_name = f'variable "{invokable.value}"'
+            obj = self.get_variable(invokable.value)
         else:
+            object_display_name = invokable.__class__.__name__
             obj = self.evaluate_statement(invokable)
         method_name = node.name
         (h_args, h_kwargs) = self.reduce_arguments(node.args)
@@ -479,13 +478,13 @@
         if is_disabled(args, kwargs):
             return Disabler()
         if not isinstance(obj, InterpreterObject):
-            raise InvalidArguments(f'Variable "{object_name}" is not callable.')
+            raise InvalidArguments(f'{object_display_name} is not callable.')
         # TODO: InterpreterBase **really** shouldn't be in charge of checking this
         if method_name == 'extract_objects':
             if isinstance(obj, ObjectHolder):
                 self.validate_extraction(obj.held_object)
             elif not isinstance(obj, Disabler):
-                raise InvalidArguments(f'Invalid operation "extract_objects" on variable "{object_name}" of type {type(obj).__name__}')
+                raise InvalidArguments(f'Invalid operation "extract_objects" on {object_display_name} of type {type(obj).__name__}')
         obj.current_node = node
         res = obj.method_call(method_name, args, kwargs)
         return self._holderify(res) if res is not None else None
@@ -576,7 +575,6 @@
         if isinstance(value, MutableInterpreterObject):
             value = copy.deepcopy(value)
         self.set_variable(var_name, value)
-        return None
 
     def set_variable(self, varname: str, variable: T.UnionTYPE_var, InterpreterObject, *, holderify: bool = False) -> None:
         if variable is None:

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/linkers/__init__.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/linkers/__init__.py Changed

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/linkers/detect.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/linkers/detect.py Changed

@@ -21,6 +21,7 @@
 )
 from .linkers import (
     AppleDynamicLinker,
+    LLVMLD64DynamicLinker,
     GnuGoldDynamicLinker,
     GnuBFDDynamicLinker,
     MoldDynamicLinker,
@@ -83,7 +84,7 @@
         check_args.extend(extra_args)
 
     p, o, _ = Popen_safe(compiler + check_args)
-    if 'LLD' in o.split('\n')0:
+    if 'LLD' in o.split('\n', maxsplit=1)0:
         if '(compatible with GNU linkers)' in o:
             return LLVMDynamicLinker(
                 compiler, for_machine, comp_class.LINKER_PREFIX,
@@ -98,13 +99,13 @@
         # We've already hanedled the non-direct case above
 
     p, o, e = Popen_safe(compiler + check_args)
-    if 'LLD' in o.split('\n')0:
+    if 'LLD' in o.split('\n', maxsplit=1)0:
         return ClangClDynamicLinker(
             for_machine, ,
             prefix=comp_class.LINKER_PREFIX if use_linker_prefix else ,
             exelist=compiler, version=search_version(o), direct=invoked_directly)
     elif 'OPTLINK' in o:
-        # Opltink's stdout *may* beging with a \r character.
+        # Optlink's stdout *may* begin with a \r character.
         return OptlinkDynamicLinker(compiler, for_machine, version=search_version(o))
     elif o.startswith('Microsoft') or e.startswith('Microsoft'):
         out = o or e
@@ -164,8 +165,24 @@
 
     v = search_version(o + e)
     linker: DynamicLinker
-    if 'LLD' in o.split('\n')0:
-        linker = LLVMDynamicLinker(
+    if 'LLD' in o.split('\n', maxsplit=1)0:
+        if isinstance(comp_class.LINKER_PREFIX, str):
+            cmd = compiler + override + comp_class.LINKER_PREFIX + '-v' + extra_args
+        else:
+            cmd = compiler + override + comp_class.LINKER_PREFIX + '-v' + extra_args
+        mlog.debug('-----')
+        mlog.debug(f'Detecting LLD linker via: {join_args(cmd)}')
+        _, newo, newerr = Popen_safe(cmd)
+        mlog.debug(f'linker stdout:\n{newo}')
+        mlog.debug(f'linker stderr:\n{newerr}')
+
+        lld_cls: T.TypeDynamicLinker
+        if 'ld64.lld' in newerr:
+            lld_cls = LLVMLD64DynamicLinker
+        else:
+            lld_cls = LLVMDynamicLinker
+
+        linker = lld_cls(
             compiler, for_machine, comp_class.LINKER_PREFIX, override, version=v)
     elif 'Snapdragon' in e and 'LLVM' in e:
         linker = QualcommLLVMDynamicLinker(
@@ -208,16 +225,16 @@
             __failed_to_detect_linker(compiler, check_args, o, e)
         linker = AppleDynamicLinker(compiler, for_machine, comp_class.LINKER_PREFIX, override, version=v)
     elif 'GNU' in o or 'GNU' in e:
-        cls: T.TypeGnuDynamicLinker
+        gnu_cls: T.TypeGnuDynamicLinker
         # this is always the only thing on stdout, except for swift
         # which may or may not redirect the linker stdout to stderr
         if o.startswith('GNU gold') or e.startswith('GNU gold'):
-            cls = GnuGoldDynamicLinker
+            gnu_cls = GnuGoldDynamicLinker
         elif o.startswith('mold') or e.startswith('mold'):
-            cls = MoldDynamicLinker
+            gnu_cls = MoldDynamicLinker
         else:
-            cls = GnuBFDDynamicLinker
-        linker = cls(compiler, for_machine, comp_class.LINKER_PREFIX, override, version=v)
+            gnu_cls = GnuBFDDynamicLinker
+        linker = gnu_cls(compiler, for_machine, comp_class.LINKER_PREFIX, override, version=v)
     elif 'Solaris' in e or 'Solaris' in o:
         for line in (o+e).split('\n'):
             if 'ld: Software Generation Utilities' in line:

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/linkers/linkers.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/linkers/linkers.py Changed

@@ -11,6 +11,7 @@
 # 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.
+from __future__ import annotations
 
 import abc
 import enum
@@ -66,7 +67,7 @@
         return 
 
     def get_output_args(self, target: str) -> T.Liststr:
-        return
+        return 
 
     def get_coverage_link_args(self) -> T.Liststr:
         return 
@@ -137,12 +138,12 @@
 
     @classmethod
     def unix_args_to_native(cls, args: T.Liststr) -> T.Liststr:
-        from ..compilers import VisualStudioCCompiler
+        from ..compilers.c import VisualStudioCCompiler
         return VisualStudioCCompiler.unix_args_to_native(args)
 
     @classmethod
     def native_args_to_unix(cls, args: T.Liststr) -> T.Liststr:
-        from ..compilers import VisualStudioCCompiler
+        from ..compilers.c import VisualStudioCCompiler
         return VisualStudioCCompiler.native_args_to_unix(args)
 
     def rsp_file_syntax(self) -> RSPFileSyntax:
@@ -208,13 +209,24 @@
         return self.can_rsp
 
     def get_std_link_args(self, env: 'Environment', is_thin: bool) -> T.Liststr:
-        # FIXME: osx ld rejects this: "file built for unknown-unsupported file format"
-        if is_thin and not env.machinesself.for_machine.is_darwin():
+        # Thin archives are a GNU extension not supported by the system linkers
+        # on Mac OS X, Solaris, or illumos, so don't build them on those OSes.
+        # OS X ld rejects with: "file built for unknown-unsupported file format"
+        # illumos/Solaris ld rejects with: "unknown file type"
+        if is_thin and not env.machinesself.for_machine.is_darwin() \
+          and not env.machinesself.for_machine.is_sunos():
             return self.std_thin_args
         else:
             return self.std_args
 
 
+class AppleArLinker(ArLinker):
+
+    # mostly this is used to determine that we need to call ranlib
+
+    id = 'applear'
+
+
 class ArmarLinker(ArLikeLinker):
     id = 'armar'
 
@@ -449,6 +461,9 @@
     def get_lto_args(self) -> T.Liststr:
         return 
 
+    def get_thinlto_cache_args(self, path: str) -> T.Liststr:
+        return 
+
     def sanitizer_args(self, value: str) -> T.Liststr:
         return 
 
@@ -573,6 +588,18 @@
         'custom': ,
     }  # type: T.Dictstr, T.Liststr
 
+    _SUBSYSTEMS = {
+        "native": "1",
+        "windows": "windows",
+        "console": "console",
+        "posix": "7",
+        "efi_application": "10",
+        "efi_boot_service_driver": "11",
+        "efi_runtime_driver": "12",
+        "efi_rom": "13",
+        "boot_application": "16",
+    }  # type: T.Dictstr, str
+
     def get_buildtype_args(self, buildtype: str) -> T.Liststr:
         # We can override these in children by just overriding the
         # _BUILDTYPE_ARGS value.
@@ -706,21 +733,10 @@
         # as well, and is always accepted, so we manually map the
         # other types here. List of all types:
         # https://github.com/wine-mirror/wine/blob/3ded60bd1654dc689d24a23305f4a93acce3a6f2/include/winnt.h#L2492-L2507
-        subsystems = {
-            "native": "1",
-            "windows": "windows",
-            "console": "console",
-            "posix": "7",
-            "efi_application": "10",
-            "efi_boot_service_driver": "11",
-            "efi_runtime_driver": "12",
-            "efi_rom": "13",
-            "boot_application": "16",
-        }
         versionsuffix = None
         if ',' in value:
             value, versionsuffix = value.split(',', 1)
-        newvalue = subsystems.get(value)
+        newvalue = self._SUBSYSTEMS.get(value)
         if newvalue is not None:
             if versionsuffix is not None:
                 newvalue += f':{versionsuffix}'
@@ -806,6 +822,14 @@
 
         return (args, set())
 
+    def get_thinlto_cache_args(self, path: str) -> T.Liststr:
+        return "-Wl,-cache_path_lto," + path
+
+
+class LLVMLD64DynamicLinker(AppleDynamicLinker):
+
+    id = 'ld64.lld'
+
 
 class GnuDynamicLinker(GnuLikeDynamicLinkerMixin, PosixDynamicLinkerMixin, DynamicLinker):
 
@@ -819,6 +843,9 @@
 
     id = 'ld.gold'
 
+    def get_thinlto_cache_args(self, path: str) -> T.Liststr:
+        return '-Wl,-plugin-opt,cache-dir=' + path
+
 
 class GnuBFDDynamicLinker(GnuDynamicLinker):
 
@@ -829,6 +856,9 @@
 
     id = 'ld.mold'
 
+    def get_thinlto_cache_args(self, path: str) -> T.Liststr:
+        return '-Wl,--thinlto-cache-dir=' + path
+
 
 class LLVMDynamicLinker(GnuLikeDynamicLinkerMixin, PosixDynamicLinkerMixin, DynamicLinker):
 
@@ -846,7 +876,7 @@
         super().__init__(exelist, for_machine, prefix_arg, always_args, version=version)
 
         # Some targets don't seem to support this argument (windows, wasm, ...)
-        _, _, e = mesonlib.Popen_safe(self.exelist + self._apply_prefix('--allow-shlib-undefined'))
+        _, _, e = mesonlib.Popen_safe(self.exelist + always_args + self._apply_prefix('--allow-shlib-undefined'))
         # Versions < 9 do not have a quoted argument
         self.has_allow_shlib_undefined = ('unknown argument: --allow-shlib-undefined' not in e) and ("unknown argument: '--allow-shlib-undefined'" not in e)
 
@@ -855,6 +885,21 @@
             return self._apply_prefix('--allow-shlib-undefined')
         return 
 
+    def get_thinlto_cache_args(self, path: str) -> T.Liststr:
+        return '-Wl,--thinlto-cache-dir=' + path
+
+    def get_win_subsystem_args(self, value: str) -> T.Liststr:
+        # lld does not support a numeric subsystem value
+        version = None
+        if ',' in value:
+            value, version = value.split(',', 1)
+        if value in self._SUBSYSTEMS:
+            if version is not None:
+                value += f':{version}'
+            return self._apply_prefix(f'--subsystem,{value}')
+        else:
+            raise mesonlib.MesonBugException(f'win_subsystem: {value} not handled in lld linker. This should not be possible.')
+
 
 class WASMDynamicLinker(GnuLikeDynamicLinkerMixin, PosixDynamicLinkerMixin, DynamicLinker):
 
@@ -863,10 +908,10 @@
     id = 'ld.wasm'
 
     def get_allow_undefined_args(self) -> T.Liststr:
-        return '-s', 'ERROR_ON_UNDEFINED_SYMBOLS=0'
+        return '-sERROR_ON_UNDEFINED_SYMBOLS=0'
 
     def no_undefined_args(self) -> T.Liststr:
-        return '-s', 'ERROR_ON_UNDEFINED_SYMBOLS=1'
+        return '-sERROR_ON_UNDEFINED_SYMBOLS=1'
 
     def get_soname_args(self, env: 'Environment', prefix: str, shlib_name: str,
                         suffix: str, soversion: str, darwin_versions: T.Tuplestr, str) -> T.Liststr:
@@ -1119,7 +1164,7 @@
         return 
 
     def get_std_shared_lib_args(self) -> T.Liststr:
-        from ..compilers import NAGFortranCompiler
+        from ..compilers.fortran import NAGFortranCompiler
         return NAGFortranCompiler.get_nagfor_quiet(self.version) + '-Wl,-shared'
 
 
@@ -1297,6 +1342,9 @@
     def get_win_subsystem_args(self, value: str) -> T.Liststr:
         return self._apply_prefix(f'/SUBSYSTEM:{value.upper()}')
 
+    def get_thinlto_cache_args(self, path: str) -> T.Liststr:
+        return "/lldltocache:" + path
+
 
 class XilinkDynamicLinker(VisualStudioLikeLinkerMixin, DynamicLinker):
 
@@ -1398,6 +1446,12 @@
     def get_allow_undefined_args(self) -> T.Liststr:
         return self._apply_prefix('-berok')
 
+    def get_link_whole_for(self, args: T.Liststr) -> T.Liststr:
+        # AIX's linker always links the whole archive: "The ld command
+        # processes all input files in the same manner, whether they are
+        # archives or not."
+        return args
+
     def build_rpath_args(self, env: 'Environment', build_dir: str, from_dir: str,
                          rpath_paths: T.Tuplestr, ..., build_rpath: str,
                          install_rpath: str) -> T.TupleT.Liststr, T.Setbytes:
@@ -1435,7 +1489,7 @@
 
     def __init__(self, exelist: T.Liststr, for_machine: mesonlib.MachineChoice,
                  *, version: str = 'unknown version'):
-        # Use optlink instead of link so we don't interfer with other link.exe
+        # Use optlink instead of link so we don't interfere with other link.exe
         # implementations.
         super().__init__(exelist, for_machine, '', , version=version)
 
@@ -1468,7 +1522,7 @@
         # Built on Sun_Sep_30_21:09:22_CDT_2018
         # Cuda compilation tools, release 10.0, V10.0.166
         # we need the most verbose version output. Luckily starting with V
-        return out.strip().split('V')-1
+        return out.strip().rsplit('V', maxsplit=1)-1
 
     def get_accepts_rsp(self) -> bool:
         # nvcc does not support response files
@@ -1488,7 +1542,7 @@
         #
         #   nvcc fatal : Don't know what to do with 'subprojects/foo/libbar.so.0.1.2'
         #
-        from ..compilers import CudaCompiler
+        from ..compilers.cuda import CudaCompiler
         return CudaCompiler.LINKER_PREFIX
 
     def fatal_warnings(self) -> T.Liststr:

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/mcompile.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/mcompile.py Changed

@@ -11,6 +11,7 @@
 # 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.
+from __future__ import annotations
 
 """Entrypoint script for backend agnostic compile."""
 
@@ -26,7 +27,7 @@
 from . import mlog
 from . import mesonlib
 from . import coredata
-from .mesonlib import MesonException, RealPathAction, setup_vsenv
+from .mesonlib import MesonException, RealPathAction, join_args, setup_vsenv
 from mesonbuild.environment import detect_ninja
 from mesonbuild.coredata import UserArrayOption
 from mesonbuild import build
@@ -124,7 +125,7 @@
             t = i'type'.replace(' ', '_')
             suggestions.append(f'- ./{p}:{t}')
         suggestions_str = '\n'.join(suggestions)
-        raise MesonException(f'Can\'t invoke target `{target.full_name}`: ambiguous name.' \
+        raise MesonException(f'Can\'t invoke target `{target.full_name}`: ambiguous name.'
                              f'Add target type and/or path:\n{suggestions_str}')
 
     return found_targets0
@@ -190,11 +191,9 @@
 
     if options.targets:
         intro_data = parse_introspect_data(builddir)
-        has_run_target = any(map(
-            lambda t:
-                get_target_from_intro_data(ParsedTargetName(t), builddir, intro_data)'type' == 'run',
-            options.targets
-        ))
+        has_run_target = any(
+            get_target_from_intro_data(ParsedTargetName(t), builddir, intro_data)'type' == 'run'
+            for t in options.targets)
 
         if has_run_target:
             # `run` target can't be used the same way as other targets on `vs` backend.
@@ -336,13 +335,16 @@
 
     cdata = coredata.load(options.wd)
     b = build.load(options.wd)
-    setup_vsenv(b.need_vsenv)
+    vsenv_active = setup_vsenv(b.need_vsenv)
+    if vsenv_active:
+        mlog.log(mlog.green('INFO:'), 'automatically activated MSVC compiler environment')
 
     cmd =     # type: T.Liststr
     env = None  # type: T.OptionalT.Dictstr, str
 
     backend = cdata.get_option(mesonlib.OptionKey('backend'))
     assert isinstance(backend, str)
+    mlog.log(mlog.green('INFO:'), 'autodetecting backend as', backend)
     if backend == 'ninja':
         cmd, env = get_parsed_args_ninja(options, bdir)
     elif backend.startswith('vs'):
@@ -353,6 +355,7 @@
         raise MesonException(
             f'Backend `{backend}` is not yet supported by `compile`. Use generated project files directly instead.')
 
+    mlog.log(mlog.green('INFO:'), 'calculating backend command to run:', join_args(cmd))
     p, *_ = mesonlib.Popen_safe(cmd, stdout=sys.stdout.buffer, stderr=sys.stderr.buffer, env=env)
 
     return p.returncode

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/mconf.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/mconf.py Changed

@@ -11,6 +11,7 @@
 # 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.
+from __future__ import annotations
 
 import itertools
 import shutil
@@ -36,12 +37,17 @@
     parser.add_argument('builddir', nargs='?', default='.')
     parser.add_argument('--clearcache', action='store_true', default=False,
                         help='Clear cached state (e.g. found dependencies)')
+    parser.add_argument('--no-pager', action='store_false', dest='pager',
+                        help='Do not redirect output to a pager')
 
-def make_lower_case(val: T.Any) -> T.Unionstr, T.ListT.Any:  # T.Any because of recursion...
+def stringify(val: T.Any) -> T.Unionstr, T.ListT.Any:  # T.Any because of recursion...
     if isinstance(val, bool):
         return str(val).lower()
     elif isinstance(val, list):
-        return make_lower_case(i) for i in val
+        s = ', '.join(stringify(i) for i in val)
+        return f'{s}'
+    elif val is None:
+        return ''
     else:
         return str(val)
 
@@ -61,8 +67,6 @@
         self.value_col = 
         self.choices_col = 
         self.descr_col = 
-        # XXX: is there a case where this can actually remain false?
-        self.has_choices = False
         self.all_subprojects: T.Setstr = set()
 
         if os.path.isdir(os.path.join(self.build_dir, 'meson-private')):
@@ -93,7 +97,6 @@
         # Do nothing when using introspection
         if self.default_values_only:
             return
-        # Only called if something has changed so overwrite unconditionally.
         coredata.save(self.coredata, self.build_dir)
         # We don't write the build file because any changes to it
         # are erased when Meson is executed the next time, i.e. when
@@ -112,42 +115,41 @@
         """
         total_width = shutil.get_terminal_size(fallback=(160, 0))0
         _col = max(total_width // 5, 20)
-        last_column = total_width - (3 * _col)
+        last_column = total_width - (3 * _col) - 3
         four_column = (_col, _col, _col, last_column if last_column > 1 else _col)
-        # In this case we don't have the choices field, so we can redistribute
-        # the extra 40 characters to val and desc
-        three_column = (_col, _col * 2, total_width // 2)
 
         for line in zip(self.name_col, self.value_col, self.choices_col, self.descr_col):
             if not any(line):
-                print('')
+                mlog.log('')
                 continue
 
             # This is a header, like `Subproject foo:`,
             # We just want to print that and get on with it
             if line0 and not any(line1:):
-                print(line0)
+                mlog.log(line0)
                 continue
 
+            def wrap_text(text, width):
+                raw = text.text if isinstance(text, mlog.AnsiDecorator) else text
+                indent = ' ' if raw.startswith('') else ''
+                wrapped = textwrap.wrap(raw, width, subsequent_indent=indent)
+                if isinstance(text, mlog.AnsiDecorator):
+                    wrapped = mlog.AnsiDecorator(i, text.code) for i in wrapped
+                # Add padding here to get even rows, as `textwrap.wrap()` will
+                # only shorten, not lengthen each item
+                return str(i) + ' ' * (width - len(i)) for i in wrapped
+
             # wrap will take a long string, and create a list of strings no
             # longer than the size given. Then that list can be zipped into, to
             # print each line of the output, such the that columns are printed
             # to the right width, row by row.
-            if self.has_choices:
-                name = textwrap.wrap(line0, four_column0)
-                val = textwrap.wrap(line1, four_column1)
-                choice = textwrap.wrap(line2, four_column2)
-                desc = textwrap.wrap(line3, four_column3)
-                for l in itertools.zip_longest(name, val, choice, desc, fillvalue=''):
-                    # We must use the length modifier here to get even rows, as
-                    # `textwrap.wrap` will only shorten, not lengthen each item
-                    print('{:{widths0}} {:{widths1}} {:{widths2}} {}'.format(*l, widths=four_column))
-            else:
-                name = textwrap.wrap(line0, three_column0)
-                val = textwrap.wrap(line1, three_column1)
-                desc = textwrap.wrap(line3, three_column2)
-                for l in itertools.zip_longest(name, val, desc, fillvalue=''):
-                    print('{:{widths0}} {:{widths1}} {}'.format(*l, widths=three_column))
+            name = wrap_text(line0, four_column0)
+            val = wrap_text(line1, four_column1)
+            choice = wrap_text(line2, four_column2)
+            desc = wrap_text(line3, four_column3)
+            for l in itertools.zip_longest(name, val, choice, desc, fillvalue=''):
+                items = li if li else ' ' * four_columni for i in range(4)
+                mlog.log(*items)
 
     def split_options_per_subproject(self, options: 'coredata.KeyedOptionDictType') -> T.Dictstr, 'coredata.KeyedOptionDictType':
         result: T.Dictstr, 'coredata.KeyedOptionDictType' = {}
@@ -157,54 +159,34 @@
             result.setdefault(k.subproject, {})k = o
         return result
 
-    def _add_line(self, name: OptionKey, value, choices, descr) -> None:
-        self.name_col.append(' ' * self.print_margin + str(name))
+    def _add_line(self, name, value, choices, descr) -> None:
+        if isinstance(name, mlog.AnsiDecorator):
+            name.text = ' ' * self.print_margin + name.text
+        else:
+            name = ' ' * self.print_margin + name
+        self.name_col.append(name)
         self.value_col.append(value)
         self.choices_col.append(choices)
         self.descr_col.append(descr)
 
     def add_option(self, name, descr, value, choices):
-        if isinstance(value, list):
-            value = '{}'.format(', '.join(make_lower_case(value)))
-        else:
-            value = make_lower_case(value)
-
-        if choices:
-            self.has_choices = True
-            if isinstance(choices, list):
-                choices_list = make_lower_case(choices)
-                current = ''
-                while choices_list:
-                    i = choices_list.pop(0)
-                    if len(current) + len(i) >= self.max_choices_line_length:
-                        self._add_line(name, value, current + ',', descr)
-                        name = ''
-                        value = ''
-                        descr = ''
-                        current = ' '
-                    if len(current) > 1:
-                        current += ', '
-                    current += i
-                choices = current + ''
-            else:
-                choices = make_lower_case(choices)
-        else:
-            choices = ''
-
-        self._add_line(name, value, choices, descr)
+        value = stringify(value)
+        choices = stringify(choices)
+        self._add_line(mlog.green(name), mlog.yellow(value), mlog.blue(choices), descr)
 
     def add_title(self, title):
-        titles = {'descr': 'Description', 'value': 'Current Value', 'choices': 'Possible Values'}
-        if self.default_values_only:
-            titles'value' = 'Default Value'
+        title = mlog.cyan(title)
+        descr = mlog.cyan('Description')
+        value = mlog.cyan('Default Value' if self.default_values_only else 'Current Value')
+        choices = mlog.cyan('Possible Values')
         self._add_line('', '', '', '')
-        self._add_line(title, titles'value', titles'choices', titles'descr')
-        self._add_line('-' * len(title), '-' * len(titles'value'), '-' * len(titles'choices'), '-' * len(titles'descr'))
+        self._add_line(title, value, choices, descr)
+        self._add_line('-' * len(title), '-' * len(value), '-' * len(choices), '-' * len(descr))
 
     def add_section(self, section):
         self.print_margin = 0
         self._add_line('', '', '', '')
-        self._add_line(section + ':', '', '', '')
+        self._add_line(mlog.normal_yellow(section + ':'), '', '', '')
         self.print_margin = 2
 
     def print_options(self, title: str, options: 'coredata.KeyedOptionDictType') -> None:
@@ -212,26 +194,32 @@
             return
         if title:
             self.add_title(title)
+        auto = T.cast('coredata.UserFeatureOption', self.coredata.optionsOptionKey('auto_features'))
         for k, o in sorted(options.items()):
             printable_value = o.printable_value()
             root = k.as_root()
             if o.yielding and k.subproject and root in self.coredata.options:
                 printable_value = '<inherited from main project>'
+            if isinstance(o, coredata.UserFeatureOption) and o.is_auto():
+                printable_value = auto.printable_value()
             self.add_option(str(root), o.description, printable_value, o.choices)
 
-    def print_conf(self):
+    def print_conf(self, pager: bool):
+        if pager:
+            mlog.start_pager()
+
         def print_default_values_warning():
             mlog.warning('The source directory instead of the build directory was specified.')
             mlog.warning('Only the default values for the project are printed, and all command line parameters are ignored.')
 
         if self.default_values_only:
             print_default_values_warning()
-            print('')
+            mlog.log('')
 
-        print('Core properties:')
-        print('  Source dir', self.source_dir)
+        mlog.log('Core properties:')
+        mlog.log('  Source dir', self.source_dir)
         if not self.default_values_only:
-            print('  Build dir ', self.build_dir)
+            mlog.log('  Build dir ', self.build_dir)
 
         dir_option_names = set(coredata.BUILTIN_DIR_OPTIONS)
         test_option_names = {OptionKey('errorlogs'),
@@ -294,7 +282,7 @@
 
         # Print the warning twice so that the user shouldn't be able to miss it
         if self.default_values_only:
-            print('')
+            mlog.log('')
             print_default_values_warning()
 
         self.print_nondefault_buildtype_options()
@@ -303,10 +291,10 @@
         mismatching = self.coredata.get_nondefault_buildtype_args()
         if not mismatching:
             return
-        print("\nThe following option(s) have a different value than the build type default\n")
-        print('               current   default')
+        mlog.log("\nThe following option(s) have a different value than the build type default\n")
+        mlog.log('               current   default')
         for m in mismatching:
-            print(f'{m0:21}{m1:10}{m2:10}')
+            mlog.log(f'{m0:21}{m1:10}{m2:10}')
 
 def run(options):
     coredata.parse_cmd_line_options(options)
@@ -315,7 +303,7 @@
     try:
         c = Conf(builddir)
         if c.default_values_only:
-            c.print_conf()
+            c.print_conf(options.pager)
             return 0
 
         save = False
@@ -327,14 +315,17 @@
             c.clear_cache()
             save = True
         else:
-            c.print_conf()
+            c.print_conf(options.pager)
         if save:
             c.save()
             mintro.update_build_options(c.coredata, c.build.environment.info_dir)
             mintro.write_meson_info_file(c.build, )
     except ConfException as e:
-        print('Meson configurator encountered an error:')
+        mlog.log('Meson configurator encountered an error:')
         if c is not None and c.build is not None:
             mintro.write_meson_info_file(c.build, e)
         raise e
+    except BrokenPipeError:
+        # Pager quit before we wrote everything.
+        pass
     return 0

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/mdevenv.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/mdevenv.py Changed

@@ -1,3 +1,5 @@
+from __future__ import annotations
+
 import os, subprocess
 import argparse
 import tempfile
@@ -6,27 +8,37 @@
 
 from pathlib import Path
 from . import build, minstall, dependencies
-from .mesonlib import MesonException, RealPathAction, is_windows, setup_vsenv, OptionKey, quote_arg, get_wine_shortpath
+from .mesonlib import (MesonException, is_windows, setup_vsenv, OptionKey,
+                       get_wine_shortpath, MachineChoice)
 from . import mlog
 
 import typing as T
 if T.TYPE_CHECKING:
     from .backends import InstallData
 
+POWERSHELL_EXES = {'pwsh.exe', 'powershell.exe'}
+
 def add_arguments(parser: argparse.ArgumentParser) -> None:
-    parser.add_argument('-C', dest='wd', action=RealPathAction,
-                        help='Directory to cd into before running')
+    parser.add_argument('-C', dest='builddir', type=Path, default='.',
+                        help='Path to build directory')
+    parser.add_argument('--workdir', '-w', type=Path, default=None,
+                        help='Directory to cd into before running (default: builddir, Since 1.0.0)')
     parser.add_argument('--dump', action='store_true',
                         help='Only print required environment (Since 0.62.0)')
-    parser.add_argument('command', nargs=argparse.REMAINDER,
+    parser.add_argument('devcmd', nargs=argparse.REMAINDER, metavar='command',
                         help='Command to run in developer environment (default: interactive shell)')
 
-def get_windows_shell() -> str:
+def get_windows_shell() -> T.Optionalstr:
     mesonbuild = Path(__file__).parent
     script = mesonbuild / 'scripts' / 'cmd_or_ps.ps1'
-    command = 'powershell.exe', '-noprofile', '-executionpolicy', 'bypass', '-file', str(script)
-    result = subprocess.check_output(command)
-    return result.decode().strip()
+    for shell in POWERSHELL_EXES:
+        try:
+            command = shell, '-noprofile', '-executionpolicy', 'bypass', '-file', str(script)
+            result = subprocess.check_output(command)
+            return result.decode().strip()
+        except (subprocess.CalledProcessError, OSError):
+            pass
+    return None
 
 def reduce_winepath(env: T.Dictstr, str) -> None:
     winepath = env.get('WINEPATH')
@@ -38,15 +50,19 @@
     env'WINEPATH' = get_wine_shortpath(winecmd, winepath.split(';'))
     mlog.log('Meson detected wine and has set WINEPATH accordingly')
 
-def get_env(b: build.Build) -> T.TupleT.Dictstr, str, T.Setstr:
+def get_env(b: build.Build, dump: bool) -> T.TupleT.Dictstr, str, T.Setstr:
     extra_env = build.EnvironmentVariables()
     extra_env.set('MESON_DEVENV', '1')
     extra_env.set('MESON_PROJECT_NAME', b.project_name)
 
-    env = os.environ.copy()
+    sysroot = b.environment.propertiesMachineChoice.HOST.get_sys_root()
+    if sysroot:
+        extra_env.set('QEMU_LD_PREFIX', sysroot)
+
+    env = {} if dump else os.environ.copy()
     varnames = set()
     for i in itertools.chain(b.devenv, {extra_env}):
-        env = i.get_env(env)
+        env = i.get_env(env, dump)
         varnames |= i.get_names()
 
     reduce_winepath(env)
@@ -83,7 +99,7 @@
     except (FileExistsError, shutil.SameFileError):
         pass
 
-def write_gdb_script(privatedir: Path, install_data: 'InstallData') -> None:
+def write_gdb_script(privatedir: Path, install_data: 'InstallData', workdir: Path) -> None:
     if not shutil.which('gdb'):
         return
     bdir = privatedir.parent
@@ -113,30 +129,47 @@
             gdbinit_path.write_text(gdbinit_line, encoding='utf-8')
             first_time = True
         if first_time:
-            mlog.log('Meson detected GDB helpers and added config in', mlog.bold(str(gdbinit_path)))
+            gdbinit_path = gdbinit_path.resolve()
+            workdir_path = workdir.resolve()
+            rel_path = gdbinit_path.relative_to(workdir_path)
+            mlog.log('Meson detected GDB helpers and added config in', mlog.bold(str(rel_path)))
+            mlog.log('To load it automatically you might need to:')
+            mlog.log(' - Add', mlog.bold(f'add-auto-load-safe-path {gdbinit_path.parent}'),
+                     'in', mlog.bold('~/.gdbinit'))
+            if gdbinit_path.parent != workdir_path:
+                mlog.log(' - Change current workdir to', mlog.bold(str(rel_path.parent)),
+                         'or use', mlog.bold(f'--init-command {rel_path}'))
 
 def run(options: argparse.Namespace) -> int:
-    privatedir = Path(options.wd) / 'meson-private'
+    privatedir = Path(options.builddir) / 'meson-private'
     buildfile = privatedir / 'build.dat'
     if not buildfile.is_file():
-        raise MesonException(f'Directory {options.wd!r} does not seem to be a Meson build directory.')
-    b = build.load(options.wd)
+        raise MesonException(f'Directory {options.builddir!r} does not seem to be a Meson build directory.')
+    b = build.load(options.builddir)
+    workdir = options.workdir or options.builddir
 
-    devenv, varnames = get_env(b)
+    setup_vsenv(b.need_vsenv)  # Call it before get_env to get vsenv vars as well
+    devenv, varnames = get_env(b, options.dump)
     if options.dump:
-        if options.command:
+        if options.devcmd:
             raise MesonException('--dump option does not allow running other command.')
         for name in varnames:
-            print(f'{name}={quote_arg(devenvname)}')
+            print(f'{name}="{devenvname}"')
             print(f'export {name}')
         return 0
 
-    install_data = minstall.load_install_data(str(privatedir / 'install.dat'))
-    write_gdb_script(privatedir, install_data)
+    if b.environment.need_exe_wrapper():
+        m = 'An executable wrapper could be required'
+        exe_wrapper = b.environment.get_exe_wrapper()
+        if exe_wrapper:
+            cmd = ' '.join(exe_wrapper.get_command())
+            m += f': {cmd}'
+        mlog.log(m)
 
-    setup_vsenv(b.need_vsenv)
+    install_data = minstall.load_install_data(str(privatedir / 'install.dat'))
+    write_gdb_script(privatedir, install_data, workdir)
 
-    args = options.command
+    args = options.devcmd
     if not args:
         prompt_prefix = f'{b.project_name}'
         shell_env = os.environ.get("SHELL")
@@ -145,7 +178,9 @@
             args = shell_env
         elif is_windows():
             shell = get_windows_shell()
-            if shell in 'powershell.exe', 'pwsh.exe':
+            if not shell:
+                mlog.warning('Failed to determine Windows shell, fallback to cmd.exe')
+            if shell in POWERSHELL_EXES:
                 args = shell, '-NoLogo', '-NoExit'
                 prompt = f'function global:prompt {{  "{prompt_prefix} PS " + $PWD + "> "}}'
                 args += '-Command', prompt
@@ -165,11 +200,15 @@
             tmprc.flush()
             args.append("--rcfile")
             args.append(tmprc.name)
+    else:
+        # Try to resolve executable using devenv's PATH
+        abs_path = shutil.which(args0, path=devenv.get('PATH', None))
+        args0 = abs_path or args0
 
     try:
         return subprocess.call(args, close_fds=False,
                                env=devenv,
-                               cwd=options.wd)
+                               cwd=workdir)
     except subprocess.CalledProcessError as e:
         return e.returncode
     except FileNotFoundError:

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/mdist.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/mdist.py Changed

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/mesondata.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/mesondata.py Changed

_service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/mesonlib.py Added

@@ -0,0 +1,35 @@
+# SPDX-license-identifier: Apache-2.0
+# Copyright 2012-2021 The Meson development team
+# Copyright © 2021 Intel Corporation
+
+# 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.
+
+# pylint: skip-file
+
+"""Helper functions and classes."""
+
+import os
+
+from .utils.core import *
+from .utils.vsenv import *
+
+from .utils.universal import *
+
+# Here we import either the posix implementations, the windows implementations,
+# or a generic no-op implementation
+if os.name == 'posix':
+    from .utils.posix import *
+elif os.name == 'nt':
+    from .utils.win32 import *
+else:
+    from .utils.platform import *

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/mesonmain.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/mesonmain.py Changed

@@ -11,6 +11,7 @@
 # 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.
+from __future__ import annotations
 
 # Work around some pathlib bugs...
 
@@ -18,24 +19,62 @@
 import sys
 sys.modules'pathlib' = _pathlib
 
+# This file is an entry point for all commands, including scripts. Include the
+# strict minimum python modules for performance reasons.
 import os.path
 import platform
 import importlib
-import traceback
 import argparse
-import shutil
 
-from . import mesonlib
+from .utils.core import MesonException, MesonBugException
 from . import mlog
-from . import mconf, mdist, minit, minstall, mintro, msetup, mtest, rewriter, msubprojects, munstable_coredata, mcompile, mdevenv
-from .mesonlib import MesonException, MesonBugException
-from .wrap import wraptool
-from .scripts import env2mfile
+
+def errorhandler(e, command):
+    import traceback
+    if isinstance(e, MesonException):
+        mlog.exception(e)
+        logfile = mlog.shutdown()
+        if logfile is not None:
+            mlog.log("\nA full log can be found at", mlog.bold(logfile))
+        if os.environ.get('MESON_FORCE_BACKTRACE'):
+            raise e
+        return 1
+    else:
+        # We assume many types of traceback are Meson logic bugs, but most
+        # particularly anything coming from the interpreter during `setup`.
+        # Some things definitely aren't:
+        # - PermissionError is always a problem in the user environment
+        # - runpython doesn't run Meson's own code, even though it is
+        #   dispatched by our run()
+        if os.environ.get('MESON_FORCE_BACKTRACE'):
+            raise e
+        traceback.print_exc()
+
+        if command == 'runpython':
+            return 2
+        elif isinstance(e, OSError):
+            mlog.exception("Unhandled python OSError. This is probably not a Meson bug, "
+                           "but an issue with your build environment.")
+            return e.errno
+        else: # Exception
+            msg = 'Unhandled python exception'
+            if all(getattr(e, a, None) is not None for a in 'file', 'lineno', 'colno'):
+                e = MesonBugException(msg, e.file, e.lineno, e.colno) # type: ignore
+            else:
+                e = MesonBugException(msg)
+            mlog.exception(e)
+        return 2
 
 # Note: when adding arguments, please also add them to the completion
 # scripts in $MESONSRC/data/shell-completions/
 class CommandLineParser:
     def __init__(self):
+        # only import these once we do full argparse processing
+        from . import mconf, mdist, minit, minstall, mintro, msetup, mtest, rewriter, msubprojects, munstable_coredata, mcompile, mdevenv
+        from .scripts import env2mfile
+        from .wrap import wraptool
+        import shutil
+
         self.term_width = shutil.get_terminal_size().columns
         self.formatter = lambda prog: argparse.HelpFormatter(prog, max_help_position=int(self.term_width / 2), width=self.term_width)
 
@@ -101,11 +140,11 @@
         parser.add_argument('script_args', nargs=argparse.REMAINDER)
 
     def run_runpython_command(self, options):
-        import runpy
+        sys.argv1: = options.script_args
         if options.eval_arg:
             exec(options.script_file)
         else:
-            sys.argv1: = options.script_args
+            import runpy
             sys.path.insert(0, os.path.dirname(options.script_file))
             runpy.run_path(options.script_file, run_name='__main__')
         return 0
@@ -121,11 +160,12 @@
         return 0
 
     def run(self, args):
-        pending_python_deprecation_notice = False
+        implicit_setup_command_notice = False
         # If first arg is not a known command, assume user wants to run the setup
         # command.
         known_commands = list(self.commands.keys()) + '-h', '--help'
         if not args or args0 not in known_commands:
+            implicit_setup_command_notice = True
             args = 'setup' + args
 
         # Hidden commands have their own parser instead of using the global one
@@ -137,6 +177,7 @@
             parser = self.parser
             command = None
 
+        from . import mesonlib
         args = mesonlib.expand_arguments(args)
         options = parser.parse_args(args)
 
@@ -146,50 +187,17 @@
         # Bump the version here in order to add a pre-exit warning that we are phasing out
         # support for old python. If this is already the oldest supported version, then
         # this can never be true and does nothing.
-        if command in ('setup', 'compile', 'test', 'install') and sys.version_info < (3, 7):
-            pending_python_deprecation_notice = True
+        pending_python_deprecation_notice = \
+            command in {'setup', 'compile', 'test', 'install'} and sys.version_info < (3, 7)
 
         try:
             return options.run_func(options)
-        except MesonException as e:
-            mlog.exception(e)
-            logfile = mlog.shutdown()
-            if logfile is not None:
-                mlog.log("\nA full log can be found at", mlog.bold(logfile))
-            if os.environ.get('MESON_FORCE_BACKTRACE'):
-                raise
-            return 1
-        except OSError as e:
-            if os.environ.get('MESON_FORCE_BACKTRACE'):
-                raise
-            traceback.print_exc()
-            error_msg = os.linesep.join(
-                "Unhandled python exception",
-                f"{e.strerror} - {e.args}",
-                "this is probably not a Meson bug.")
-
-            mlog.exception(error_msg)
-            return e.errno
-
         except Exception as e:
-            if os.environ.get('MESON_FORCE_BACKTRACE'):
-                raise
-            traceback.print_exc()
-            # We assume many types of traceback are Meson logic bugs, but most
-            # particularly anything coming from the interpreter during `setup`.
-            # Some things definitely aren't:
-            # - PermissionError is always a problem in the user environment
-            # - runpython doesn't run Meson's own code, even though it is
-            #   dispatched by our run()
-            if command != 'runpython':
-                msg = 'Unhandled python exception'
-                if all(getattr(e, a, None) is not None for a in 'file', 'lineno', 'colno'):
-                    e = MesonBugException(msg, e.file, e.lineno, e.colno) # type: ignore
-                else:
-                    e = MesonBugException(msg)
-                mlog.exception(e)
-            return 2
+            return errorhandler(e, command)
         finally:
+            if implicit_setup_command_notice:
+                mlog.warning('Running the setup command as `meson options` instead of '
+                             '`meson setup options` is ambiguous and deprecated.', fatal=False)
             if pending_python_deprecation_notice:
                 mlog.notice('You are using Python 3.6 which is EOL. Starting with v0.62.0, '
                             'Meson will require Python 3.7 or newer', fatal=False)
@@ -222,11 +230,23 @@
     if sys.stdout.encoding and not sys.stdout.encoding.upper().startswith('UTF-'):
         sys.stdout.reconfigure(errors='surrogateescape')
 
+def set_meson_command(mainfile):
+    # Set the meson command that will be used to run scripts and so on
+    from . import mesonlib
+    mesonlib.set_meson_command(mainfile)
+
 def run(original_args, mainfile):
     if sys.version_info >= (3, 10) and os.environ.get('MESON_RUNNING_IN_PROJECT_TESTS'):
         # workaround for https://bugs.python.org/issue34624
         import warnings
         warnings.filterwarnings('error', category=EncodingWarning, module='mesonbuild')
+        # python 3.11 adds a warning that in 3.15, UTF-8 mode will be default.
+        # This is fantastic news, we'd love that. Less fantastic: this warning is silly,
+        # we *want* these checks to be affected. Plus, the recommended alternative API
+        # would (in addition to warning people when UTF-8 mode removed the problem) also
+        # require using a minimum python version of 3.11 (in which the warning was added)
+        # or add verbose if/else soup.
+        warnings.filterwarnings('ignore', message="UTF-8 Mode affects .*getpreferredencoding", category=EncodingWarning)
 
     # Meson gets confused if stdout can't output Unicode, if the
     # locale isn't Unicode, just force stdout to accept it. This tries
@@ -239,21 +259,22 @@
         mlog.error('Please install and use mingw-w64-x86_64-python3 and/or mingw-w64-x86_64-meson with Pacman')
         return 2
 
-    # Set the meson command that will be used to run scripts and so on
-    mesonlib.set_meson_command(mainfile)
-
     args = original_args:
 
     # Special handling of internal commands called from backends, they don't
     # need to go through argparse.
     if len(args) >= 2 and args0 == '--internal':
         if args1 == 'regenerate':
-            # Rewrite "meson --internal regenerate" command line to
-            # "meson --reconfigure"
-            args = '--reconfigure' + args2:
+            set_meson_command(mainfile)
+            from . import msetup
+            try:
+                return msetup.run('--reconfigure' + args2:)
+            except Exception as e:
+                return errorhandler(e, 'setup')
         else:
             return run_script_command(args1, args2:)
 
+    set_meson_command(mainfile)
     return CommandLineParser().run(args)
 
 def main():

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/minit.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/minit.py Changed

@@ -11,6 +11,7 @@
 # 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.
+from __future__ import annotations
 
 """Code that creates simple startup projects."""
 
@@ -97,14 +98,14 @@
             raise SystemExit('No recognizable source files found.\n'
                              'Run meson init in an empty directory to create a sample project.')
         options.srcfiles = srcfiles
-        print("Detected source files: " + ' '.join(map(str, srcfiles)))
+        print("Detected source files: " + ' '.join(str(s) for s in srcfiles))
     options.srcfiles = Path(f) for f in options.srcfiles
     if not options.language:
         for f in options.srcfiles:
             if f.suffix == '.c':
                 options.language = 'c'
                 break
-            if f.suffix in ('.cc', '.cpp'):
+            if f.suffix in {'.cc', '.cpp'}:
                 options.language = 'cpp'
                 break
             if f.suffix == '.cs':

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/minstall.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/minstall.py Changed

@@ -27,7 +27,7 @@
 from . import build
 from . import environment
 from .backend.backends import InstallData
-from .mesonlib import MesonException, Popen_safe, RealPathAction, is_windows, setup_vsenv, pickle_load
+from .mesonlib import MesonException, Popen_safe, RealPathAction, is_windows, setup_vsenv, pickle_load, is_osx
 from .scripts import depfixer, destdir_join
 from .scripts.meson_exe import run_exe
 try:
@@ -235,7 +235,7 @@
     '''
     try:
         subprocess.check_call('selinuxenabled')
-    except (FileNotFoundError, NotADirectoryError, PermissionError, subprocess.CalledProcessError):
+    except (FileNotFoundError, NotADirectoryError, OSError, PermissionError, subprocess.CalledProcessError):
         # If we don't have selinux or selinuxenabled returned 1, failure
         # is ignored quietly.
         return
@@ -566,7 +566,13 @@
 
     def do_strip(self, strip_bin: T.Liststr, fname: str, outname: str) -> None:
         self.log(f'Stripping target {fname!r}.')
-        returncode, stdo, stde = self.Popen_safe(strip_bin + outname)
+        if is_osx():
+            # macOS expects dynamic objects to be stripped with -x maximum.
+            # To also strip the debug info, -S must be added.
+            # See: https://www.unix.com/man-page/osx/1/strip/
+            returncode, stdo, stde = self.Popen_safe(strip_bin + '-S', '-x', outname)
+        else:
+            returncode, stdo, stde = self.Popen_safe(strip_bin + outname)
         if returncode != 0:
             print('Could not strip file.\n')
             print(f'Stdout:\n{stdo}\n')

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/mintro.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/mintro.py Changed

@@ -11,6 +11,7 @@
 # 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.
+from __future__ import annotations
 
 """This is a helper script for IDE developers. It allows you to
 extract information such as list of targets, files, compiler flags,
@@ -21,19 +22,21 @@
 
 import collections
 import json
-from . import build, coredata as cdata
-from . import mesonlib
-from .ast import IntrospectionInterpreter, BUILD_TARGET_FUNCTIONS, AstConditionLevel, AstIDGenerator, AstIndentationGenerator, AstJSONPrinter
-from . import mlog
-from .backend import backends
-from .mparser import BaseNode, FunctionNode, ArrayNode, ArgumentNode, StringNode
-from .interpreter import Interpreter
+import os
 from pathlib import Path, PurePath
 import typing as T
-import os
-import argparse
 
+from . import build, mesonlib, mlog, coredata as cdata
+from .ast import IntrospectionInterpreter, BUILD_TARGET_FUNCTIONS, AstConditionLevel, AstIDGenerator, AstIndentationGenerator, AstJSONPrinter
+from .backend import backends
 from .mesonlib import OptionKey
+from .mparser import FunctionNode, ArrayNode, ArgumentNode, StringNode
+
+if T.TYPE_CHECKING:
+    import argparse
+
+    from .interpreter import Interpreter
+    from .mparser import BaseNode
 
 def get_meson_info_file(info_dir: str) -> str:
     return os.path.join(info_dir, 'meson-info.json')
@@ -134,14 +137,14 @@
         'data': installdata.data,
         'man': installdata.man,
         'headers': installdata.headers,
+        'install_subdirs': installdata.install_subdirs
     }.items():
-        for data in data_list:
+        # Mypy doesn't recognize SubdirInstallData as a subclass of InstallDataBase
+        for data in data_list: # type: ignoreattr-defined
             data_type = data.data_type or key
             install_path_name = data.install_path_name
             if key == 'headers':  # in the headers, install_path_name is the directory
                 install_path_name = os.path.join(install_path_name, os.path.basename(data.path))
-            elif data_type == 'configure':
-                install_path_name = os.path.join('{prefix}', install_path_name)
 
             plandata_type = plan.get(data_type, {})
             plandata_typedata.path = {
@@ -320,7 +323,7 @@
     filelist =   # type: T.Liststr
     for root, _, files in os.walk(src_dir):
         for f in files:
-            if f == 'meson.build' or f == 'meson_options.txt':
+            if f in {'meson.build', 'meson_options.txt'}:
                 filelist.append(os.path.relpath(os.path.join(root, f), src_dir))
     return filelist
 
@@ -485,8 +488,8 @@
             return 1
 
     # Extract introspection information from JSON
-    for i in intro_types.keys():
-        if not intro_typesi.func:
+    for i, v in intro_types.items():
+        if not v.func:
             continue
         if not options.all and not getattr(options, i, False):
             continue
@@ -501,7 +504,6 @@
 updated_introspection_files =   # type: T.Liststr
 
 def write_intro_info(intro_info: T.SequenceT.Tuplestr, T.Uniondict, T.ListT.Any, info_dir: str) -> None:
-    global updated_introspection_files
     for kind, data in intro_info:
         out_file = os.path.join(info_dir, f'intro-{kind}.json')
         tmp_file = os.path.join(info_dir, 'tmp_dump.json')
@@ -509,7 +511,7 @@
             json.dump(data, fp)
             fp.flush() # Not sure if this is needed
         os.replace(tmp_file, out_file)
-        updated_introspection_files += kind
+        updated_introspection_files.append(kind)
 
 def generate_introspection_file(builddata: build.Build, backend: backends.Backend) -> None:
     coredata = builddata.environment.get_coredata()
@@ -540,14 +542,13 @@
     }
 
 def write_meson_info_file(builddata: build.Build, errors: list, build_files_updated: bool = False) -> None:
-    global updated_introspection_files
     info_dir = builddata.environment.info_dir
     info_file = get_meson_info_file(info_dir)
     intro_types = get_meson_introspection_types()
     intro_info = {}
 
-    for i in intro_types.keys():
-        if not intro_typesi.func:
+    for i, v in intro_types.items():
+        if not v.func:
             continue
         intro_infoi = {
             'file': f'intro-{i}.json',

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/mlog.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/mlog.py Changed

@@ -17,6 +17,9 @@
 import sys
 import time
 import platform
+import shlex
+import subprocess
+import shutil
 import typing as T
 from contextlib import contextmanager
 from pathlib import Path
@@ -28,6 +31,10 @@
 information about Meson runs. Some output goes to screen,
 some to logging dir and some goes to both."""
 
+def is_windows() -> bool:
+    platname = platform.system().lower()
+    return platname == 'windows'
+
 def _windows_ansi() -> bool:
     # windll only exists on windows, so mypy will get mad
     from ctypes import windll, byref  # type: ignore
@@ -49,7 +56,7 @@
         return _colorize_console
 
     try:
-        if platform.system().lower() == 'windows':
+        if is_windows():
             _colorize_console = os.isatty(sys.stdout.fileno()) and _windows_ansi()
         else:
             _colorize_console = os.isatty(sys.stdout.fileno()) and os.environ.get('TERM', 'dumb') != 'dumb'
@@ -63,7 +70,7 @@
     # on Windows, a subprocess might call SetConsoleMode() on the console
     # connected to stdout and turn off ANSI escape processing. Call this after
     # running a subprocess to ensure we turn it on again.
-    if platform.system().lower() == 'windows':
+    if is_windows():
         try:
             delattr(sys.stdout, 'colorize_console')
         except AttributeError:
@@ -80,41 +87,43 @@
 _in_ci = 'CI' in os.environ  # type: bool
 _logged_once = set()         # type: T.SetT.Tuplestr, ...
 log_warnings_counter = 0     # type: int
+log_pager: T.Optional'subprocess.Popen' = None
 
 def disable() -> None:
-    global log_disable_stdout
+    global log_disable_stdout  # pylint: disable=global-statement
     log_disable_stdout = True
 
 def enable() -> None:
-    global log_disable_stdout
+    global log_disable_stdout  # pylint: disable=global-statement
     log_disable_stdout = False
 
 def set_quiet() -> None:
-    global log_errors_only
+    global log_errors_only  # pylint: disable=global-statement
     log_errors_only = True
 
 def set_verbose() -> None:
-    global log_errors_only
+    global log_errors_only  # pylint: disable=global-statement
     log_errors_only = False
 
 def initialize(logdir: str, fatal_warnings: bool = False) -> None:
-    global log_dir, log_file, log_fatal_warnings
+    global log_dir, log_file, log_fatal_warnings  # pylint: disable=global-statement
     log_dir = logdir
     log_file = open(os.path.join(logdir, log_fname), 'w', encoding='utf-8')
     log_fatal_warnings = fatal_warnings
 
 def set_timestamp_start(start: float) -> None:
-    global log_timestamp_start
+    global log_timestamp_start  # pylint: disable=global-statement
     log_timestamp_start = start
 
 def shutdown() -> T.Optionalstr:
-    global log_file
+    global log_file  # pylint: disable=global-statement
     if log_file is not None:
         path = log_file.name
         exception_around_goer = log_file
         log_file = None
         exception_around_goer.close()
         return path
+    stop_pager()
     return None
 
 class AnsiDecorator:
@@ -227,7 +236,8 @@
 
     # _Something_ is going to get printed.
     try:
-        print(raw, end='')
+        output = log_pager.stdin if log_pager else None
+        print(raw, end='', file=output)
     except UnicodeEncodeError:
         cleaned = raw.encode('ascii', 'replace').decode('ascii')
         print(cleaned, end='')
@@ -328,7 +338,7 @@
 
     log(*args, once=once, **kwargs)
 
-    global log_warnings_counter
+    global log_warnings_counter  # pylint: disable=global-statement
     log_warnings_counter += 1
 
     if log_fatal_warnings and fatal:
@@ -374,7 +384,13 @@
     if prefix:
         args.append(prefix)
     args.append(str(e))
-    log(*args)
+
+    restore = log_disable_stdout
+    if restore:
+        enable()
+    log(*args, is_error=True)
+    if restore:
+        disable()
 
 # Format a list for logging purposes as a string. It separates
 # all but the last item with commas, and the last with 'and'.
@@ -391,9 +407,59 @@
 
 @contextmanager
 def nested(name: str = '') -> T.GeneratorNone, None, None:
-    global log_depth
     log_depth.append(name)
     try:
         yield
     finally:
         log_depth.pop()
+
+def start_pager() -> None:
+    if not colorize_console():
+        return
+    pager_cmd = 
+    if 'PAGER' in os.environ:
+        pager_cmd = shlex.split(os.environ'PAGER')
+    else:
+        less = shutil.which('less')
+        if not less and is_windows():
+            git = shutil.which('git')
+            if git:
+                path = Path(git).parents1 / 'usr' / 'bin'
+                less = shutil.which('less', path=str(path))
+        if less:
+            pager_cmd = less
+    if not pager_cmd:
+        return
+    global log_pager # pylint: disable=global-statement
+    assert log_pager is None
+    try:
+        # Set 'LESS' environment variable, rather than arguments in
+        # pager_cmd, to also support the case where the user has 'PAGER'
+        # set to 'less'. Arguments set are:
+        # "R" : support color
+        # "X" : do not clear the screen when leaving the pager
+        # "F" : skip the pager if content fits into the screen
+        env = os.environ.copy()
+        if 'LESS' not in env:
+            env'LESS' = 'RXF'
+        # Set "-c" for lv to support color
+        if 'LV' not in env:
+            env'LV' = '-c'
+        log_pager = subprocess.Popen(pager_cmd, stdin=subprocess.PIPE,
+                                     text=True, encoding='utf-8', env=env)
+    except Exception as e:
+        # Ignore errors, unless it is a user defined pager.
+        if 'PAGER' in os.environ:
+            from .mesonlib import MesonException
+            raise MesonException(f'Failed to start pager: {str(e)}')
+
+def stop_pager() -> None:
+    global log_pager # pylint: disable=global-statement
+    if log_pager:
+        try:
+            log_pager.stdin.flush()
+            log_pager.stdin.close()
+        except BrokenPipeError:
+            pass
+        log_pager.wait()
+        log_pager = None

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/modules/__init__.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/modules/__init__.py Changed

@@ -15,14 +15,17 @@
 # This file contains the base representation for import('modname')
 
 from __future__ import annotations
+import dataclasses
 import typing as T
 
 from .. import mesonlib
-from ..mesonlib import relpath, HoldableObject, MachineChoice
+from ..build import IncludeDirs
 from ..interpreterbase.decorators import noKwargs, noPosargs
+from ..mesonlib import relpath, HoldableObject, MachineChoice
 from ..programs import ExternalProgram
 
 if T.TYPE_CHECKING:
+    from .. import build
     from ..interpreter import Interpreter
     from ..interpreter.interpreterobjects import MachineHolder
     from ..interpreterbase import TYPE_var, TYPE_kwargs
@@ -47,6 +50,7 @@
                                     interpreter.environment.get_build_dir())
         self.subproject = interpreter.subproject
         self.subdir = interpreter.subdir
+        self.root_subdir = interpreter.root_subdir
         self.current_lineno = interpreter.current_lineno
         self.environment = interpreter.environment
         self.project_name = interpreter.build.project_name
@@ -148,6 +152,19 @@
         key = mesonlib.OptionKey(name, subproject, machine, lang, module)
         return key in self._interpreter.user_defined_options.cmd_line_options
 
+    def process_include_dirs(self, dirs: T.IterableT.Unionstr, IncludeDirs) -> T.IterableIncludeDirs:
+        """Convert raw include directory arguments to only IncludeDirs
+
+        :param dirs: An iterable of strings and IncludeDirs
+        :return: None
+        :yield: IncludeDirs objects
+        """
+        for d in dirs:
+            if isinstance(d, IncludeDirs):
+                yield d
+            else:
+                yield self._interpreter.build_incdir_object(d)
+
 
 class ModuleObject(HoldableObject):
     """Base class for all objects returned by modules
@@ -162,6 +179,19 @@
 class MutableModuleObject(ModuleObject):
     pass
 
+
+@dataclasses.dataclass
+class ModuleInfo:
+
+    """Metadata about a Module."""
+
+    name: str
+    added: T.Optionalstr = None
+    deprecated: T.Optionalstr = None
+    unstable: bool = False
+    stabilized: T.Optionalstr = None
+
+
 class NewExtensionModule(ModuleObject):
 
     """Class for modern modules
@@ -169,6 +199,8 @@
     provides the found method.
     """
 
+    INFO: ModuleInfo
+
     def __init__(self) -> None:
         super().__init__()
         self.methods.update({
@@ -202,6 +234,10 @@
     provides the found method.
     """
 
+    def __init__(self, name: str) -> None:
+        super().__init__()
+        self.INFO = ModuleInfo(name)
+
     @staticmethod
     def found() -> bool:
         return False
@@ -215,7 +251,7 @@
     if hasattr(fname, 'fname'):
         fname = fname.fname
     suffix = fname.split('.')-1
-    return suffix in ('gir', 'typelib')
+    return suffix in {'gir', 'typelib'}
 
 
 class ModuleReturnValue:

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/modules/cmake.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/modules/cmake.py Changed

@@ -18,7 +18,7 @@
 import shutil
 import typing as T
 
-from . import ExtensionModule, ModuleReturnValue, ModuleObject
+from . import ExtensionModule, ModuleReturnValue, ModuleObject, ModuleInfo
 
 from .. import build, mesonlib, mlog, dependencies
 from ..cmake import TargetOptions, cmake_defines_to_args
@@ -127,10 +127,10 @@
         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(<cmake_subproject>.target_list()))')
+                                       '    message(\'CMake targets:\\n - \' + \'\\n - \'.join(<cmake_subproject>.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')
+        assert all(x in res for x in 'inc', 'src', 'dep', 'tgt', 'func')
         return res
 
     @noKwargs
@@ -247,7 +247,8 @@
     cmake_detected = False
     cmake_root = None
 
-    @FeatureNew('CMake Module', '0.50.0')
+    INFO = ModuleInfo('cmake', '0.50.0')
+
     def __init__(self, interpreter):
         super().__init__(interpreter)
         self.methods.update({

_service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/modules/cuda.py Added

@@ -0,0 +1,383 @@
+# Copyright 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.
+from __future__ import annotations
+
+import typing as T
+import re
+
+from ..mesonlib import version_compare
+from ..compilers.cuda import CudaCompiler
+
+from . import NewExtensionModule, ModuleInfo
+
+from ..interpreterbase import (
+    flatten, permittedKwargs, noKwargs,
+    InvalidArguments
+)
+
+if T.TYPE_CHECKING:
+    from . import ModuleState
+    from ..compilers import Compiler
+
+class CudaModule(NewExtensionModule):
+
+    INFO = ModuleInfo('CUDA', '0.50.0', unstable=True)
+
+    def __init__(self, *args, **kwargs):
+        super().__init__()
+        self.methods.update({
+            "min_driver_version": self.min_driver_version,
+            "nvcc_arch_flags":    self.nvcc_arch_flags,
+            "nvcc_arch_readable": self.nvcc_arch_readable,
+        })
+
+    @noKwargs
+    def min_driver_version(self, state: 'ModuleState',
+                           args: T.Tuplestr,
+                           kwargs: T.Dictstr, T.Any) -> str:
+        argerror = InvalidArguments('min_driver_version must have exactly one positional argument: ' +
+                                    'a CUDA Toolkit version string. Beware that, since CUDA 11.0, ' +
+                                    'the CUDA Toolkit\'s components (including NVCC) are versioned ' +
+                                    'independently from each other (and the CUDA Toolkit as a whole).')
+
+        if len(args) != 1 or not isinstance(args0, str):
+            raise argerror
+
+        cuda_version = args0
+        driver_version_table = 
+            {'cuda_version': '>=12.0.0',   'windows': '527.41', 'linux': '525.60.13'},
+            {'cuda_version': '>=11.8.0',   'windows': '522.06', 'linux': '520.61.05'},
+            {'cuda_version': '>=11.7.1',   'windows': '516.31', 'linux': '515.48.07'},
+            {'cuda_version': '>=11.7.0',   'windows': '516.01', 'linux': '515.43.04'},
+            {'cuda_version': '>=11.6.1',   'windows': '511.65', 'linux': '510.47.03'},
+            {'cuda_version': '>=11.6.0',   'windows': '511.23', 'linux': '510.39.01'},
+            {'cuda_version': '>=11.5.1',   'windows': '496.13', 'linux': '495.29.05'},
+            {'cuda_version': '>=11.5.0',   'windows': '496.04', 'linux': '495.29.05'},
+            {'cuda_version': '>=11.4.3',   'windows': '472.50', 'linux': '470.82.01'},
+            {'cuda_version': '>=11.4.1',   'windows': '471.41', 'linux': '470.57.02'},
+            {'cuda_version': '>=11.4.0',   'windows': '471.11', 'linux': '470.42.01'},
+            {'cuda_version': '>=11.3.0',   'windows': '465.89', 'linux': '465.19.01'},
+            {'cuda_version': '>=11.2.2',   'windows': '461.33', 'linux': '460.32.03'},
+            {'cuda_version': '>=11.2.1',   'windows': '461.09', 'linux': '460.32.03'},
+            {'cuda_version': '>=11.2.0',   'windows': '460.82', 'linux': '460.27.03'},
+            {'cuda_version': '>=11.1.1',   'windows': '456.81', 'linux': '455.32'},
+            {'cuda_version': '>=11.1.0',   'windows': '456.38', 'linux': '455.23'},
+            {'cuda_version': '>=11.0.3',   'windows': '451.82', 'linux': '450.51.06'},
+            {'cuda_version': '>=11.0.2',   'windows': '451.48', 'linux': '450.51.05'},
+            {'cuda_version': '>=11.0.1',   'windows': '451.22', 'linux': '450.36.06'},
+            {'cuda_version': '>=10.2.89',  'windows': '441.22', 'linux': '440.33'},
+            {'cuda_version': '>=10.1.105', 'windows': '418.96', 'linux': '418.39'},
+            {'cuda_version': '>=10.0.130', 'windows': '411.31', 'linux': '410.48'},
+            {'cuda_version': '>=9.2.148',  'windows': '398.26', 'linux': '396.37'},
+            {'cuda_version': '>=9.2.88',   'windows': '397.44', 'linux': '396.26'},
+            {'cuda_version': '>=9.1.85',   'windows': '391.29', 'linux': '390.46'},
+            {'cuda_version': '>=9.0.76',   'windows': '385.54', 'linux': '384.81'},
+            {'cuda_version': '>=8.0.61',   'windows': '376.51', 'linux': '375.26'},
+            {'cuda_version': '>=8.0.44',   'windows': '369.30', 'linux': '367.48'},
+            {'cuda_version': '>=7.5.16',   'windows': '353.66', 'linux': '352.31'},
+            {'cuda_version': '>=7.0.28',   'windows': '347.62', 'linux': '346.46'},
+        
+
+        driver_version = 'unknown'
+        for d in driver_version_table:
+            if version_compare(cuda_version, d'cuda_version'):
+                driver_version = d.get(state.host_machine.system, d'linux')
+                break
+
+        return driver_version
+
+    @permittedKwargs('detected')
+    def nvcc_arch_flags(self, state: 'ModuleState',
+                        args: T.TupleT.UnionCompiler, CudaCompiler, str,
+                        kwargs: T.Dictstr, T.Any) -> T.Liststr:
+        nvcc_arch_args = self._validate_nvcc_arch_args(args, kwargs)
+        ret = self._nvcc_arch_flags(*nvcc_arch_args)0
+        return ret
+
+    @permittedKwargs('detected')
+    def nvcc_arch_readable(self, state: 'ModuleState',
+                           args: T.TupleT.UnionCompiler, CudaCompiler, str,
+                           kwargs: T.Dictstr, T.Any) -> T.Liststr:
+        nvcc_arch_args = self._validate_nvcc_arch_args(args, kwargs)
+        ret = self._nvcc_arch_flags(*nvcc_arch_args)1
+        return ret
+
+    @staticmethod
+    def _break_arch_string(s):
+        s = re.sub(' \t\r\n,;+', ';', s)
+        s = s.strip(';').split(';')
+        return s
+
+    @staticmethod
+    def _detected_cc_from_compiler(c):
+        if isinstance(c, CudaCompiler):
+            return c.detected_cc
+        return ''
+
+    @staticmethod
+    def _version_from_compiler(c):
+        if isinstance(c, CudaCompiler):
+            return c.version
+        if isinstance(c, str):
+            return c
+        return 'unknown'
+
+    def _validate_nvcc_arch_args(self, args, kwargs):
+        argerror = InvalidArguments('The first argument must be an NVCC compiler object, or its version string!')
+
+        if len(args) < 1:
+            raise argerror
+        else:
+            compiler = args0
+            cuda_version = self._version_from_compiler(compiler)
+            if cuda_version == 'unknown':
+                raise argerror
+
+        arch_list =  if len(args) <= 1 else flatten(args1:)
+        arch_list = self._break_arch_string(a) for a in arch_list
+        arch_list = flatten(arch_list)
+        if len(arch_list) > 1 and not set(arch_list).isdisjoint({'All', 'Common', 'Auto'}):
+            raise InvalidArguments('''The special architectures 'All', 'Common' and 'Auto' must appear alone, as a positional argument!''')
+        arch_list = arch_list0 if len(arch_list) == 1 else arch_list
+
+        detected = kwargs.get('detected', self._detected_cc_from_compiler(compiler))
+        detected = flatten(detected)
+        detected = self._break_arch_string(a) for a in detected
+        detected = flatten(detected)
+        if not set(detected).isdisjoint({'All', 'Common', 'Auto'}):
+            raise InvalidArguments('''The special architectures 'All', 'Common' and 'Auto' must appear alone, as a positional argument!''')
+
+        return cuda_version, arch_list, detected
+
+    def _filter_cuda_arch_list(self, cuda_arch_list, lo=None, hi=None, saturate=None):
+        """
+        Filter CUDA arch list (no codenames) for >= low and < hi architecture
+        bounds, and deduplicate.
+        If saturate is provided, architectures >= hi are replaced with saturate.
+        """
+
+        filtered_cuda_arch_list = 
+        for arch in cuda_arch_list:
+            if arch:
+                if lo and version_compare(arch, '<' + lo):
+                    continue
+                if hi and version_compare(arch, '>=' + hi):
+                    if not saturate:
+                        continue
+                    arch = saturate
+                if arch not in filtered_cuda_arch_list:
+                    filtered_cuda_arch_list.append(arch)
+        return filtered_cuda_arch_list
+
+    def _nvcc_arch_flags(self, cuda_version, cuda_arch_list='Auto', detected=''):
+        """
+        Using the CUDA Toolkit version and the target architectures, compute
+        the NVCC architecture flags.
+        """
+
+        # Replicates much of the logic of
+        #     https://github.com/Kitware/CMake/blob/master/Modules/FindCUDA/select_compute_arch.cmake
+        # except that a bug with cuda_arch_list="All" is worked around by
+        # tracking both lower and upper limits on GPU architectures.
+
+        cuda_known_gpu_architectures   = 'Fermi', 'Kepler', 'Maxwell'  # noqa: E221
+        cuda_common_gpu_architectures  = '3.0', '3.5', '5.0'           # noqa: E221
+        cuda_hi_limit_gpu_architecture = None                            # noqa: E221
+        cuda_lo_limit_gpu_architecture = '2.0'                           # noqa: E221
+        cuda_all_gpu_architectures     = '3.0', '3.2', '3.5', '5.0'    # noqa: E221
+
+        if version_compare(cuda_version, '<7.0'):
+            cuda_hi_limit_gpu_architecture = '5.2'
+
+        if version_compare(cuda_version, '>=7.0'):
+            cuda_known_gpu_architectures  += 'Kepler+Tegra', 'Kepler+Tesla', 'Maxwell+Tegra'  # noqa: E221
+            cuda_common_gpu_architectures += '5.2'                                            # noqa: E221
+
+            if version_compare(cuda_version, '<8.0'):
+                cuda_common_gpu_architectures += '5.2+PTX'  # noqa: E221
+                cuda_hi_limit_gpu_architecture = '6.0'        # noqa: E221
+
+        if version_compare(cuda_version, '>=8.0'):
+            cuda_known_gpu_architectures  += 'Pascal', 'Pascal+Tegra'  # noqa: E221
+            cuda_common_gpu_architectures += '6.0', '6.1'              # noqa: E221
+            cuda_all_gpu_architectures    += '6.0', '6.1', '6.2'       # noqa: E221
+
+            if version_compare(cuda_version, '<9.0'):
+                cuda_common_gpu_architectures += '6.1+PTX'  # noqa: E221
+                cuda_hi_limit_gpu_architecture = '7.0'        # noqa: E221
+
+        if version_compare(cuda_version, '>=9.0'):
+            cuda_known_gpu_architectures  += 'Volta', 'Xavier' # noqa: E221
+            cuda_common_gpu_architectures += '7.0'             # noqa: E221
+            cuda_all_gpu_architectures    += '7.0', '7.2'      # noqa: E221
+            # https://docs.nvidia.com/cuda/archive/9.0/cuda-toolkit-release-notes/index.html#unsupported-features
+            cuda_lo_limit_gpu_architecture = '3.0'               # noqa: E221
+
+            if version_compare(cuda_version, '<10.0'):
+                cuda_common_gpu_architectures += '7.2+PTX'  # noqa: E221
+                cuda_hi_limit_gpu_architecture = '8.0'        # noqa: E221
+
+        if version_compare(cuda_version, '>=10.0'):
+            cuda_known_gpu_architectures  += 'Turing' # noqa: E221
+            cuda_common_gpu_architectures += '7.5'    # noqa: E221
+            cuda_all_gpu_architectures    += '7.5'    # noqa: E221
+
+            if version_compare(cuda_version, '<11.0'):
+                cuda_common_gpu_architectures += '7.5+PTX'  # noqa: E221
+                cuda_hi_limit_gpu_architecture = '8.0'        # noqa: E221
+
+        if version_compare(cuda_version, '>=11.0'):
+            cuda_known_gpu_architectures  += 'Ampere' # noqa: E221
+            cuda_common_gpu_architectures += '8.0'    # noqa: E221
+            cuda_all_gpu_architectures    += '8.0'    # noqa: E221
+            # https://docs.nvidia.com/cuda/archive/11.0/cuda-toolkit-release-notes/index.html#deprecated-features
+            cuda_lo_limit_gpu_architecture = '3.5'      # noqa: E221
+
+            if version_compare(cuda_version, '<11.1'):
+                cuda_common_gpu_architectures += '8.0+PTX'  # noqa: E221
+                cuda_hi_limit_gpu_architecture = '8.6'        # noqa: E221
+
+        if version_compare(cuda_version, '>=11.1'):
+            cuda_common_gpu_architectures += '8.6'             # noqa: E221
+            cuda_all_gpu_architectures    += '8.6'             # noqa: E221
+
+            if version_compare(cuda_version, '<11.8'):
+                cuda_common_gpu_architectures += '8.6+PTX'  # noqa: E221
+                cuda_hi_limit_gpu_architecture = '8.7'        # noqa: E221
+
+        if version_compare(cuda_version, '>=11.8'):
+            cuda_known_gpu_architectures  += 'Orin', 'Lovelace', 'Hopper'  # noqa: E221
+            cuda_common_gpu_architectures += '8.9', '9.0', '9.0+PTX'       # noqa: E221
+            cuda_all_gpu_architectures    += '8.7', '8.9', '9.0'           # noqa: E221
+
+            if version_compare(cuda_version, '<12'):
+                cuda_hi_limit_gpu_architecture = '9.1'        # noqa: E221
+
+        if version_compare(cuda_version, '>=12.0'):
+            # https://docs.nvidia.com/cuda/cuda-toolkit-release-notes/index.html#deprecated-features (Current)
+            # https://docs.nvidia.com/cuda/archive/12.0/cuda-toolkit-release-notes/index.html#deprecated-features (Eventual?)
+            cuda_lo_limit_gpu_architecture = '5.0'            # noqa: E221
+
+            if version_compare(cuda_version, '<13'):
+                cuda_hi_limit_gpu_architecture = '10.0'       # noqa: E221
+
+        if not cuda_arch_list:
+            cuda_arch_list = 'Auto'
+
+        if   cuda_arch_list == 'All':     # noqa: E271
+            cuda_arch_list = cuda_known_gpu_architectures
+        elif cuda_arch_list == 'Common':  # noqa: E271
+            cuda_arch_list = cuda_common_gpu_architectures
+        elif cuda_arch_list == 'Auto':    # noqa: E271
+            if detected:
+                if isinstance(detected, list):
+                    cuda_arch_list = detected
+                else:
+                    cuda_arch_list = self._break_arch_string(detected)
+                cuda_arch_list = self._filter_cuda_arch_list(cuda_arch_list,
+                                                             cuda_lo_limit_gpu_architecture,
+                                                             cuda_hi_limit_gpu_architecture,
+                                                             cuda_common_gpu_architectures-1)
+            else:
+                cuda_arch_list = cuda_common_gpu_architectures
+        elif isinstance(cuda_arch_list, str):
+            cuda_arch_list = self._break_arch_string(cuda_arch_list)
+
+        cuda_arch_list = sorted(x for x in set(cuda_arch_list) if x)
+
+        cuda_arch_bin = 
+        cuda_arch_ptx = 
+        for arch_name in cuda_arch_list:
+            arch_bin = 
+            arch_ptx = 
+            add_ptx = arch_name.endswith('+PTX')
+            if add_ptx:
+                arch_name = arch_name:-len('+PTX')
+
+            if re.fullmatch('0-9+\\.0-9(\$0-9+\\.0-9\$)?', arch_name):
+                arch_bin, arch_ptx = arch_name, arch_name
+            else:
+                arch_bin, arch_ptx = {
+                    'Fermi':         ('2.0', '2.1(2.0)', ),
+                    'Kepler+Tegra':  ('3.2',             ),
+                    'Kepler+Tesla':  ('3.7',             ),
+                    'Kepler':        ('3.0', '3.5',      '3.5'),
+                    'Maxwell+Tegra': ('5.3',             ),
+                    'Maxwell':       ('5.0', '5.2',      '5.2'),
+                    'Pascal':        ('6.0', '6.1',      '6.1'),
+                    'Pascal+Tegra':  ('6.2',             ),
+                    'Volta':         ('7.0',             '7.0'),
+                    'Xavier':        ('7.2',             ),
+                    'Turing':        ('7.5',             '7.5'),
+                    'Ampere':        ('8.0',             '8.0'),
+                    'Orin':          ('8.7',             ),
+                    'Lovelace':      ('8.9',             '8.9'),
+                    'Hopper':        ('9.0',             '9.0'),
+                }.get(arch_name, (None, None))
+
+            if arch_bin is None:
+                raise InvalidArguments(f'Unknown CUDA Architecture Name {arch_name}!')
+
+            cuda_arch_bin += arch_bin
+
+            if add_ptx:
+                if not arch_ptx:
+                    arch_ptx = arch_bin
+                cuda_arch_ptx += arch_ptx
+
+        cuda_arch_bin = sorted(set(cuda_arch_bin))
+        cuda_arch_ptx = sorted(set(cuda_arch_ptx))
+
+        nvcc_flags = 
+        nvcc_archs_readable = 
+
+        for arch in cuda_arch_bin:
+            arch, codev = re.fullmatch(
+                '(0-9+\\.0-9)(?:\$(0-9+\\.0-9)\$)?', arch).groups()
+
+            if version_compare(arch, '<' + cuda_lo_limit_gpu_architecture):
+                continue
+            if cuda_hi_limit_gpu_architecture and version_compare(arch, '>=' + cuda_hi_limit_gpu_architecture):
+                continue
+
+            if codev:
+                arch = arch.replace('.', '')
+                codev = codev.replace('.', '')
+                nvcc_flags += '-gencode', 'arch=compute_' + codev + ',code=sm_' + arch
+                nvcc_archs_readable += 'sm_' + arch
+            else:
+                arch = arch.replace('.', '')
+                nvcc_flags += '-gencode', 'arch=compute_' + arch + ',code=sm_' + arch
+                nvcc_archs_readable += 'sm_' + arch
+
+        for arch in cuda_arch_ptx:
+            arch, codev = re.fullmatch(
+                '(0-9+\\.0-9)(?:\$(0-9+\\.0-9)\$)?', arch).groups()
+
+            if codev:
+                arch = codev
+
+            if version_compare(arch, '<' + cuda_lo_limit_gpu_architecture):
+                continue
+            if cuda_hi_limit_gpu_architecture and version_compare(arch, '>=' + cuda_hi_limit_gpu_architecture):
+                continue
+
+            arch = arch.replace('.', '')
+            nvcc_flags += '-gencode', 'arch=compute_' + arch + ',code=compute_' + arch
+            nvcc_archs_readable += 'compute_' + arch
+
+        return nvcc_flags, nvcc_archs_readable
+
+def initialize(*args, **kwargs):
+    return CudaModule(*args, **kwargs)

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/modules/dlang.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/modules/dlang.py Changed

_service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/modules/external_project.py Added

@@ -0,0 +1,307 @@
+# Copyright 2020 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.
+
+from pathlib import Path
+import os
+import shlex
+import subprocess
+import typing as T
+
+from . import ExtensionModule, ModuleReturnValue, NewExtensionModule, ModuleInfo
+from .. import mlog, build
+from ..compilers.compilers import CFLAGS_MAPPING
+from ..envconfig import ENV_VAR_PROG_MAP
+from ..dependencies import InternalDependency, PkgConfigDependency
+from ..interpreterbase import FeatureNew
+from ..interpreter.type_checking import ENV_KW, DEPENDS_KW
+from ..interpreterbase.decorators import ContainerTypeInfo, KwargInfo, typed_kwargs, typed_pos_args
+from ..mesonlib import (EnvironmentException, MesonException, Popen_safe, MachineChoice,
+                        get_variable_regex, do_replacement, join_args, OptionKey)
+
+if T.TYPE_CHECKING:
+    from typing_extensions import TypedDict
+
+    from . import ModuleState
+    from ..interpreter import Interpreter
+    from ..interpreterbase import TYPE_var
+    from ..build import BuildTarget, CustomTarget
+
+    class Dependency(TypedDict):
+
+        subdir: str
+
+    class AddProject(TypedDict):
+
+        configure_options: T.Liststr
+        cross_configure_options: T.Liststr
+        verbose: bool
+        env: build.EnvironmentVariables
+        depends: T.ListT.UnionBuildTarget, CustomTarget
+
+
+class ExternalProject(NewExtensionModule):
+    def __init__(self,
+                 state: 'ModuleState',
+                 configure_command: str,
+                 configure_options: T.Liststr,
+                 cross_configure_options: T.Liststr,
+                 env: build.EnvironmentVariables,
+                 verbose: bool,
+                 extra_depends: T.ListT.Union'BuildTarget', 'CustomTarget'):
+        super().__init__()
+        self.methods.update({'dependency': self.dependency_method,
+                             })
+
+        self.subdir = Path(state.subdir)
+        self.project_version = state.project_version
+        self.subproject = state.subproject
+        self.env = state.environment
+        self.build_machine = state.build_machine
+        self.host_machine = state.host_machine
+        self.configure_command = configure_command
+        self.configure_options = configure_options
+        self.cross_configure_options = cross_configure_options
+        self.verbose = verbose
+        self.user_env = env
+
+        self.src_dir = Path(self.env.get_source_dir(), self.subdir)
+        self.build_dir = Path(self.env.get_build_dir(), self.subdir, 'build')
+        self.install_dir = Path(self.env.get_build_dir(), self.subdir, 'dist')
+        _p = self.env.coredata.get_option(OptionKey('prefix'))
+        assert isinstance(_p, str), 'for mypy'
+        self.prefix = Path(_p)
+        _l = self.env.coredata.get_option(OptionKey('libdir'))
+        assert isinstance(_l, str), 'for mypy'
+        self.libdir = Path(_l)
+        _i = self.env.coredata.get_option(OptionKey('includedir'))
+        assert isinstance(_i, str), 'for mypy'
+        self.includedir = Path(_i)
+        self.name = self.src_dir.name
+
+        # On Windows if the prefix is "c:/foo" and DESTDIR is "c:/bar", `make`
+        # will install files into "c:/bar/c:/foo" which is an invalid path.
+        # Work around that issue by removing the drive from prefix.
+        if self.prefix.drive:
+            self.prefix = self.prefix.relative_to(self.prefix.drive)
+
+        # self.prefix is an absolute path, so we cannot append it to another path.
+        self.rel_prefix = self.prefix.relative_to(self.prefix.root)
+
+        self._configure(state)
+
+        self.targets = self._create_targets(extra_depends)
+
+    def _configure(self, state: 'ModuleState') -> None:
+        if self.configure_command == 'waf':
+            FeatureNew('Waf external project', '0.60.0').use(self.subproject, state.current_node)
+            waf = state.find_program('waf')
+            configure_cmd = waf.get_command()
+            configure_cmd += 'configure', '-o', str(self.build_dir)
+            workdir = self.src_dir
+            self.make = waf.get_command() + 'build'
+        else:
+            # Assume it's the name of a script in source dir, like 'configure',
+            # 'autogen.sh', etc).
+            configure_path = Path(self.src_dir, self.configure_command)
+            configure_prog = state.find_program(configure_path.as_posix())
+            configure_cmd = configure_prog.get_command()
+            workdir = self.build_dir
+            self.make = state.find_program('make').get_command()
+
+        d = ('PREFIX', '--prefix=@PREFIX@', self.prefix.as_posix()),
+             ('LIBDIR', '--libdir=@PREFIX@/@LIBDIR@', self.libdir.as_posix()),
+             ('INCLUDEDIR', None, self.includedir.as_posix()),
+             
+        self._validate_configure_options(d, state)
+
+        configure_cmd += self._format_options(self.configure_options, d)
+
+        if self.env.is_cross_build():
+            host = '{}-{}-{}'.format(self.host_machine.cpu_family,
+                                     self.build_machine.system,
+                                     self.host_machine.system)
+            d = ('HOST', None, host)
+            configure_cmd += self._format_options(self.cross_configure_options, d)
+
+        # Set common env variables like CFLAGS, CC, etc.
+        link_exelist: T.Liststr = 
+        link_args: T.Liststr = 
+        self.run_env = os.environ.copy()
+        for lang, compiler in self.env.coredata.compilersMachineChoice.HOST.items():
+            if any(lang not in i for i in (ENV_VAR_PROG_MAP, CFLAGS_MAPPING)):
+                continue
+            cargs = self.env.coredata.get_external_args(MachineChoice.HOST, lang)
+            assert isinstance(cargs, list), 'for mypy'
+            self.run_envENV_VAR_PROG_MAPlang = self._quote_and_join(compiler.get_exelist())
+            self.run_envCFLAGS_MAPPINGlang = self._quote_and_join(cargs)
+            if not link_exelist:
+                link_exelist = compiler.get_linker_exelist()
+                _l = self.env.coredata.get_external_link_args(MachineChoice.HOST, lang)
+                assert isinstance(_l, list), 'for mypy'
+                link_args = _l
+        if link_exelist:
+            # FIXME: Do not pass linker because Meson uses CC as linker wrapper,
+            # but autotools often expects the real linker (e.h. GNU ld).
+            # self.run_env'LD' = self._quote_and_join(link_exelist)
+            pass
+        self.run_env'LDFLAGS' = self._quote_and_join(link_args)
+
+        self.run_env = self.user_env.get_env(self.run_env)
+        self.run_env = PkgConfigDependency.setup_env(self.run_env, self.env, MachineChoice.HOST,
+                                                     uninstalled=True)
+
+        self.build_dir.mkdir(parents=True, exist_ok=True)
+        self._run('configure', configure_cmd, workdir)
+
+    def _quote_and_join(self, array: T.Liststr) -> str:
+        return ' '.join(shlex.quote(i) for i in array)
+
+    def _validate_configure_options(self, variables: T.ListT.Tuplestr, str, str, state: 'ModuleState') -> None:
+        # Ensure the user at least try to pass basic info to the build system,
+        # like the prefix, libdir, etc.
+        for key, default, val in variables:
+            if default is None:
+                continue
+            key_format = f'@{key}@'
+            for option in self.configure_options:
+                if key_format in option:
+                    break
+            else:
+                FeatureNew('Default configure_option', '0.57.0').use(self.subproject, state.current_node)
+                self.configure_options.append(default)
+
+    def _format_options(self, options: T.Liststr, variables: T.ListT.Tuplestr, str, str) -> T.Liststr:
+        out: T.Liststr = 
+        missing = set()
+        regex = get_variable_regex('meson')
+        confdata: T.Dictstr, T.Tuplestr, T.Optionalstr = {k: (v, None) for k, _, v in variables}
+        for o in options:
+            arg, missing_vars = do_replacement(regex, o, 'meson', confdata)
+            missing.update(missing_vars)
+            out.append(arg)
+        if missing:
+            var_list = ", ".join(repr(m) for m in sorted(missing))
+            raise EnvironmentException(
+                f"Variables {var_list} in configure options are missing.")
+        return out
+
+    def _run(self, step: str, command: T.Liststr, workdir: Path) -> None:
+        mlog.log(f'External project {self.name}:', mlog.bold(step))
+        m = 'Running command ' + str(command) + ' in directory ' + str(workdir) + '\n'
+        log_filename = Path(mlog.log_dir, f'{self.name}-{step}.log')
+        output = None
+        if not self.verbose:
+            output = open(log_filename, 'w', encoding='utf-8')
+            output.write(m + '\n')
+            output.flush()
+        else:
+            mlog.log(m)
+        p, *_ = Popen_safe(command, cwd=workdir, env=self.run_env,
+                           stderr=subprocess.STDOUT,
+                           stdout=output)
+        if p.returncode != 0:
+            m = f'{step} step returned error code {p.returncode}.'
+            if not self.verbose:
+                m += '\nSee logs: ' + str(log_filename)
+            raise MesonException(m)
+
+    def _create_targets(self, extra_depends: T.ListT.Union'BuildTarget', 'CustomTarget') -> T.List'TYPE_var':
+        cmd = self.env.get_build_command()
+        cmd += '--internal', 'externalproject',
+                '--name', self.name,
+                '--srcdir', self.src_dir.as_posix(),
+                '--builddir', self.build_dir.as_posix(),
+                '--installdir', self.install_dir.as_posix(),
+                '--logdir', mlog.log_dir,
+                '--make', join_args(self.make),
+                
+        if self.verbose:
+            cmd.append('--verbose')
+
+        self.target = build.CustomTarget(
+            self.name,
+            self.subdir.as_posix(),
+            self.subproject,
+            self.env,
+            cmd + '@OUTPUT@', '@DEPFILE@',
+            ,
+            f'{self.name}.stamp',
+            depfile=f'{self.name}.d',
+            console=True,
+            extra_depends=extra_depends,
+        )
+
+        idir = build.InstallDir(self.subdir.as_posix(),
+                                Path('dist', self.rel_prefix).as_posix(),
+                                install_dir='.',
+                                install_dir_name='.',
+                                install_mode=None,
+                                exclude=None,
+                                strip_directory=True,
+                                from_source_dir=False,
+                                subproject=self.subproject)
+
+        return self.target, idir
+
+    @typed_pos_args('external_project.dependency', str)
+    @typed_kwargs('external_project.dependency', KwargInfo('subdir', str, default=''))
+    def dependency_method(self, state: 'ModuleState', args: T.Tuplestr, kwargs: 'Dependency') -> InternalDependency:
+        libname = args0
+
+        abs_includedir = Path(self.install_dir, self.rel_prefix, self.includedir)
+        if kwargs'subdir':
+            abs_includedir = Path(abs_includedir, kwargs'subdir')
+        abs_libdir = Path(self.install_dir, self.rel_prefix, self.libdir)
+
+        version = self.project_version
+        compile_args = f'-I{abs_includedir}'
+        link_args = f'-L{abs_libdir}', f'-l{libname}'
+        sources = self.target
+        dep = InternalDependency(version, , compile_args, link_args, ,
+                                 , sources, , {}, , )
+        return dep
+
+
+class ExternalProjectModule(ExtensionModule):
+
+    INFO = ModuleInfo('External build system', '0.56.0', unstable=True)
+
+    def __init__(self, interpreter: 'Interpreter'):
+        super().__init__(interpreter)
+        self.methods.update({'add_project': self.add_project,
+                             })
+
+    @typed_pos_args('external_project_mod.add_project', str)
+    @typed_kwargs(
+        'external_project.add_project',
+        KwargInfo('configure_options', ContainerTypeInfo(list, str), default=, listify=True),
+        KwargInfo('cross_configure_options', ContainerTypeInfo(list, str), default='--host=@HOST@', listify=True),
+        KwargInfo('verbose', bool, default=False),
+        ENV_KW,
+        DEPENDS_KW.evolve(since='0.63.0'),
+    )
+    def add_project(self, state: 'ModuleState', args: T.Tuplestr, kwargs: 'AddProject') -> ModuleReturnValue:
+        configure_command = args0
+        project = ExternalProject(state,
+                                  configure_command,
+                                  kwargs'configure_options',
+                                  kwargs'cross_configure_options',
+                                  kwargs'env',
+                                  kwargs'verbose',
+                                  kwargs'depends')
+        return ModuleReturnValue(project, project.targets)
+
+
+def initialize(interp: 'Interpreter') -> ExternalProjectModule:
+    return ExternalProjectModule(interp)

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/modules/fs.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/modules/fs.py Changed

@@ -12,24 +12,28 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-import typing as T
+from __future__ import annotations
+from pathlib import Path, PurePath, PureWindowsPath
 import hashlib
 import os
-from pathlib import Path, PurePath, PureWindowsPath
+import typing as T
 
+from . import ExtensionModule, ModuleReturnValue, ModuleInfo
 from .. import mlog
-from . import ExtensionModule
+from ..build import CustomTarget, InvalidArguments
+from ..interpreter.type_checking import INSTALL_KW, INSTALL_MODE_KW, INSTALL_TAG_KW, NoneType
+from ..interpreterbase import FeatureNew, KwargInfo, typed_kwargs, typed_pos_args, noKwargs
 from ..mesonlib import (
     File,
     MesonException,
+    has_path_sep,
     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 ..mesonlib import FileOrString
+    from ..mesonlib import FileOrString, FileMode
 
     from typing_extensions import TypedDict
 
@@ -38,10 +42,20 @@
 
         encoding: str
 
+    class CopyKw(TypedDict):
+
+        """Kwargs for fs.copy"""
+
+        install: bool
+        install_dir: T.Optionalstr
+        install_mode: FileMode
+        install_tag: T.Optionalstr
+
 
 class FSModule(ExtensionModule):
 
-    @FeatureNew('Fs Module', '0.53.0')
+    INFO = ModuleInfo('fs', '0.53.0')
+
     def __init__(self, interpreter: 'Interpreter') -> None:
         super().__init__(interpreter)
         self.methods.update({
@@ -60,6 +74,7 @@
             'name': self.name,
             'stem': self.stem,
             'read': self.read,
+            'copyfile': self.copyfile,
         })
 
     def _absolute_dir(self, state: 'ModuleState', arg: 'FileOrString') -> Path:
@@ -254,6 +269,47 @@
         self.interpreter.add_build_def_file(path)
         return data
 
+    @FeatureNew('fs.copyfile', '0.64.0')
+    @typed_pos_args('fs.copyfile', (File, str), optargs=str)
+    @typed_kwargs(
+        'fs.copyfile',
+        INSTALL_KW,
+        INSTALL_MODE_KW,
+        INSTALL_TAG_KW,
+        KwargInfo('install_dir', (str, NoneType)),
+    )
+    def copyfile(self, state: ModuleState, args: T.TupleFileOrString, T.Optionalstr,
+                 kwargs: CopyKw) -> ModuleReturnValue:
+        """Copy a file into the build directory at build time."""
+        if kwargs'install' and not kwargs'install_dir':
+            raise InvalidArguments('"install_dir" must be specified when "install" is true')
+
+        src = self.interpreter.source_strings_to_files(args0)0
+
+        # The input is allowed to have path separators, but the output may not,
+        # so use the basename for the default case
+        dest = args1 if args1 else os.path.basename(src.fname)
+        if has_path_sep(dest):
+            raise InvalidArguments('Destination path may not have path separators')
+
+        ct = CustomTarget(
+            dest,
+            state.subdir,
+            state.subproject,
+            state.environment,
+            state.environment.get_build_command() + '--internal', 'copy', '@INPUT@', '@OUTPUT@',
+            src,
+            dest,
+            build_by_default=True,
+            install=kwargs'install',
+            install_dir=kwargs'install_dir',
+            install_mode=kwargs'install_mode',
+            install_tag=kwargs'install_tag',
+            backend=state.backend,
+        )
+
+        return ModuleReturnValue(ct, ct)
+
 
 def initialize(*args: T.Any, **kwargs: T.Any) -> FSModule:
     return FSModule(*args, **kwargs)

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/modules/gnome.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/modules/gnome.py Changed

@@ -24,7 +24,7 @@
 import textwrap
 import typing as T
 
-from . import ExtensionModule
+from . import ExtensionModule, ModuleInfo
 from . import ModuleReturnValue
 from .. import build
 from .. import interpreter
@@ -32,14 +32,14 @@
 from .. import mlog
 from ..build import CustomTarget, CustomTargetIndex, Executable, GeneratedList, InvalidArguments
 from ..dependencies import Dependency, PkgConfigDependency, InternalDependency
-from ..interpreter.type_checking import DEPENDS_KW, DEPEND_FILES_KW, INSTALL_DIR_KW, INSTALL_KW, NoneType, in_set_validator
+from ..interpreter.type_checking import DEPENDS_KW, DEPEND_FILES_KW, INSTALL_DIR_KW, INSTALL_KW, NoneType, SOURCES_KW, in_set_validator
 from ..interpreterbase import noPosargs, noKwargs, FeatureNew, FeatureDeprecated
 from ..interpreterbase import typed_kwargs, KwargInfo, ContainerTypeInfo
 from ..interpreterbase.decorators import typed_pos_args
 from ..mesonlib import (
     MachineChoice, MesonException, OrderedSet, Popen_safe, join_args,
 )
-from ..programs import ExternalProgram, OverrideProgram, EmptyExternalProgram
+from ..programs import OverrideProgram
 from ..scripts.gettext import read_linguas
 
 if T.TYPE_CHECKING:
@@ -51,12 +51,14 @@
     from ..interpreter import Interpreter
     from ..interpreterbase import TYPE_var, TYPE_kwargs
     from ..mesonlib import FileOrString
+    from ..programs import ExternalProgram
 
     class PostInstall(TypedDict):
         glib_compile_schemas: bool
         gio_querymodules: T.Liststr
         gtk_update_icon_cache: bool
         update_desktop_database: bool
+        update_mime_database: bool
 
     class CompileSchemas(TypedDict):
 
@@ -268,9 +270,10 @@
 # https://bugzilla.gnome.org/show_bug.cgi?id=774368
 gresource_dep_needed_version = '>= 2.51.1'
 
-native_glib_version: T.Optionalstr = None
-
 class GnomeModule(ExtensionModule):
+
+    INFO = ModuleInfo('gnome')
+
     def __init__(self, interpreter: 'Interpreter') -> None:
         super().__init__(interpreter)
         self.gir_dep: T.OptionalDependency = None
@@ -280,7 +283,9 @@
         self.install_gio_querymodules: T.Liststr = 
         self.install_gtk_update_icon_cache = False
         self.install_update_desktop_database = False
+        self.install_update_mime_database = False
         self.devenv: T.Optionalbuild.EnvironmentVariables = None
+        self.native_glib_version: T.Optionalstr = None
         self.methods.update({
             'post_install': self.post_install,
             'compile_resources': self.compile_resources,
@@ -296,19 +301,17 @@
             'generate_vapi': self.generate_vapi,
         })
 
-    @staticmethod
-    def _get_native_glib_version(state: 'ModuleState') -> str:
-        global native_glib_version
-        if native_glib_version is None:
+    def _get_native_glib_version(self, state: 'ModuleState') -> str:
+        if self.native_glib_version is None:
             glib_dep = PkgConfigDependency('glib-2.0', state.environment,
                                            {'native': True, 'required': False})
             if glib_dep.found():
-                native_glib_version = glib_dep.get_version()
+                self.native_glib_version = glib_dep.get_version()
             else:
                 mlog.warning('Could not detect glib version, assuming 2.54. '
                              'You may get build errors if your glib is older.')
-                native_glib_version = '2.54'
-        return native_glib_version
+                self.native_glib_version = '2.54'
+        return self.native_glib_version
 
     @mesonlib.run_once
     def __print_gresources_warning(self, state: 'ModuleState') -> None:
@@ -331,6 +334,7 @@
         KwargInfo('gio_querymodules', ContainerTypeInfo(list, str), default=, listify=True),
         KwargInfo('gtk_update_icon_cache', bool, default=False),
         KwargInfo('update_desktop_database', bool, default=False, since='0.59.0'),
+        KwargInfo('update_mime_database', bool, default=False, since='0.64.0'),
     )
     @noPosargs
     @FeatureNew('gnome.post_install', '0.57.0')
@@ -369,6 +373,13 @@
             script = state.backend.get_executable_serialisation(prog, '-q', appdir)
             script.skip_if_destdir = True
             rv.append(script)
+        if kwargs'update_mime_database' and not self.install_update_mime_database:
+            self.install_update_mime_database = True
+            prog = state.find_program('update-mime-database')
+            appdir = os.path.join(datadir_abs, 'mime')
+            script = state.backend.get_executable_serialisation(prog, appdir)
+            script.skip_if_destdir = True
+            rv.append(script)
         return ModuleReturnValue(None, rv)
 
     @typed_pos_args('gnome.compile_resources', str, (str, mesonlib.File, build.CustomTarget, build.CustomTargetIndex, build.GeneratedList))
@@ -503,6 +514,7 @@
             extra_depends=depends,
             install=kwargs'install',
             install_dir=kwargs'install_dir' if kwargs'install_dir' else ,
+            install_tag='runtime',
         )
 
         if gresource: # Only one target for .gresource files
@@ -522,6 +534,7 @@
             extra_depends=depends,
             install=install_header,
             install_dir=install_dir,
+            install_tag='devel',
         )
         rv = target_c, target_h
         return ModuleReturnValue(rv, rv)
@@ -861,7 +874,7 @@
         for girtarget in girtargets:
             for lang, compiler in girtarget.compilers.items():
                 # XXX: Can you use g-i with any other language?
-                if lang in ('c', 'cpp', 'objc', 'objcpp', 'd'):
+                if lang in {'c', 'cpp', 'objc', 'objcpp', 'd'}:
                     ret.append((lang, compiler))
                     break
 
@@ -877,10 +890,10 @@
         return ret
 
     @staticmethod
-    def _get_gir_targets_inc_dirs(girtargets: T.Sequencebuild.BuildTarget) -> T.Listbuild.IncludeDirs:
-        ret: T.Listbuild.IncludeDirs = 
+    def _get_gir_targets_inc_dirs(girtargets: T.Sequencebuild.BuildTarget) -> OrderedSetbuild.IncludeDirs:
+        ret: OrderedSet = OrderedSet()
         for girtarget in girtargets:
-            ret += girtarget.get_include_dirs()
+            ret.update(girtarget.get_include_dirs())
         return ret
 
     @staticmethod
@@ -1053,7 +1066,7 @@
         return typelib_includes, new_depends
 
     @staticmethod
-    def _get_external_args_for_langs(state: 'ModuleState', langs: T.Sequencestr) -> T.Liststr:
+    def _get_external_args_for_langs(state: 'ModuleState', langs: T.Liststr) -> T.Liststr:
         ret: T.Liststr = 
         for lang in langs:
             ret += mesonlib.listify(state.environment.coredata.get_external_args(MachineChoice.HOST, lang))
@@ -1105,7 +1118,7 @@
     def generate_gir(self, state: 'ModuleState', args: T.TupleT.ListT.Unionbuild.Executable, build.SharedLibrary, build.StaticLibrary,
                      kwargs: 'GenerateGir') -> ModuleReturnValue:
         girtargets = self._unwrap_gir_target(arg, state) for arg in args0
-        if len(girtargets) > 1 and any(isinstance(el, build.Executable) for el in girtargets):
+        if len(girtargets) > 1 and any(isinstance(el, build.Executable) for el in girtargets):
             raise MesonException('generate_gir only accepts a single argument when one of the arguments is an executable')
 
         gir_dep, giscanner, gicompiler = self._get_gir_dep(state)
@@ -1149,6 +1162,7 @@
         gir_inc_dirs: T.Liststr = 
 
         scan_command: T.ListT.Unionstr, build.Executable, 'ExternalProgram', 'OverrideProgram' = giscanner
+        scan_command += '--quiet'
         scan_command += '--no-libtool'
         scan_command += '--namespace=' + ns, '--nsversion=' + nsversion
         scan_command += '--warn-all'
@@ -1180,8 +1194,8 @@
         scan_command += list(scan_external_ldflags)
 
         if self._gir_has_option('--sources-top-dirs'):
-            scan_command += '--sources-top-dirs', os.path.join(state.environment.get_source_dir(), self.interpreter.subproject_dir, state.subproject)
-            scan_command += '--sources-top-dirs', os.path.join(state.environment.get_build_dir(), self.interpreter.subproject_dir, state.subproject)
+            scan_command += '--sources-top-dirs', os.path.join(state.environment.get_source_dir(), state.root_subdir)
+            scan_command += '--sources-top-dirs', os.path.join(state.environment.get_build_dir(), state.root_subdir)
 
         if '--warn-error' in scan_command:
             FeatureDeprecated.single_use('gnome.generate_gir argument --warn-error', '0.55.0',
@@ -1353,7 +1367,7 @@
                 l_subdir,
                 state.subproject,
                 state.environment,
-                itstool, '-m', os.path.join(l_subdir, gmo_file), '-o', '@OUTDIR@', '@INPUT@',
+                itstool, '-m', os.path.join(l_subdir, gmo_file), '--lang', l, '-o', '@OUTDIR@', '@INPUT@',
                 sources_files,
                 sources,
                 extra_depends=gmotarget,
@@ -1450,9 +1464,8 @@
             t_args.append(f'--{program_name}={path}')
         if namespace:
             t_args.append('--namespace=' + namespace)
-        # if not need_exe_wrapper, we get an EmptyExternalProgram. If none provided, we get NoneType
         exe_wrapper = state.environment.get_exe_wrapper()
-        if not isinstance(exe_wrapper, (NoneType, EmptyExternalProgram)):
+        if exe_wrapper:
             t_args.append('--run=' + ' '.join(exe_wrapper.get_command()))
         t_args.append(f'--htmlargs={"@@".join(kwargs"html_args")}')
         t_args.append(f'--scanargs={"@@".join(kwargs"scan_args")}')
@@ -1556,11 +1569,11 @@
     def gtkdoc_html_dir(self, state: 'ModuleState', args: T.Tuplestr, kwargs: 'TYPE_kwargs') -> str:
         return os.path.join('share/gtk-doc/html', args0)
 
-    @typed_pos_args('gnome.gdbus_codegen', str, optargs=(str, mesonlib.File))
+    @typed_pos_args('gnome.gdbus_codegen', str, optargs=(str, mesonlib.File, build.CustomTarget, build.CustomTargetIndex, build.GeneratedList))
     @typed_kwargs(
         'gnome.gdbus_codegen',
         _BUILD_BY_DEFAULT.evolve(since='0.40.0'),
-        KwargInfo('sources', ContainerTypeInfo(list, (str, mesonlib.File)), since='0.46.0', default=, listify=True),
+        SOURCES_KW.evolve(since='0.46.0'),
         KwargInfo('extra_args', ContainerTypeInfo(list, str), since='0.47.0', default=, listify=True),
         KwargInfo('interface_prefix', (str, NoneType)),
         KwargInfo('namespace', (str, NoneType)),
@@ -1578,10 +1591,10 @@
             validator=in_set_validator({'all', 'none', 'objects'})),
         INSTALL_DIR_KW.evolve(since='0.46.0')
     )
-    def gdbus_codegen(self, state: 'ModuleState', args: T.Tuplestr, T.Optional'FileOrString',
+    def gdbus_codegen(self, state: 'ModuleState', args: T.Tuplestr, T.OptionalT.Union'FileOrString', build.GeneratedTypes,
                       kwargs: 'GdbusCodegen') -> ModuleReturnValue:
         namebase = args0
-        xml_files: T.List'FileOrString' = args1 if args1 else 
+        xml_files: T.ListT.Union'FileOrString', build.GeneratedTypes = args1 if args1 else 
         cmd: T.ListT.Union'ExternalProgram', str = state.find_program('gdbus-codegen')
         cmd.extend(kwargs'extra_args')
 
@@ -1669,6 +1682,7 @@
             extra_depends=depends,
             install=install_header,
             install_dir=install_dir,
+            install_tag='devel',
         )
         targets.append(hfile_custom_target)
 
@@ -1915,6 +1929,7 @@
             capture=True,
             install=install,
             install_dir=_install_dir,
+            install_tag='devel',
             extra_depends=depends,
             # https://github.com/mesonbuild/meson/issues/973
             absolute_paths=True,
@@ -1980,6 +1995,7 @@
             header_file,
             install=install_header,
             install_dir=kwargs'install_dir' if kwargs'install_dir' else ,
+            install_tag='devel',
             capture=capture,
             depend_files=kwargs'depend_files',
         )
@@ -2126,6 +2142,7 @@
             extra_depends=vapi_depends,
             install=kwargs'install',
             install_dir=install_dir,
+            install_tag='devel',
         )
 
         # So to try our best to get this to just work we need:

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/modules/hotdoc.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/modules/hotdoc.py Changed

@@ -11,20 +11,25 @@
 # 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.
+from __future__ import annotations
 
 '''This module provides helper functions for generating documentation using hotdoc'''
 
 import os
-from collections import OrderedDict
+import subprocess
 
 from mesonbuild import mesonlib
 from mesonbuild import mlog, build
 from mesonbuild.coredata import MesonException
-from . import ModuleReturnValue
+from . import ModuleReturnValue, ModuleInfo
 from . import ExtensionModule
 from ..dependencies import Dependency, InternalDependency
-from ..interpreterbase import FeatureNew, InvalidArguments, noPosargs, noKwargs, typed_pos_args
+from ..interpreterbase import (
+    InvalidArguments, noPosargs, noKwargs, typed_kwargs, FeatureDeprecated,
+    ContainerTypeInfo, KwargInfo, typed_pos_args
+)
 from ..interpreter import CustomTargetHolder
+from ..interpreter.type_checking import NoneType
 from ..programs import ExternalProgram
 
 
@@ -36,8 +41,11 @@
 
 MIN_HOTDOC_VERSION = '0.8.100'
 
+file_types = (str, mesonlib.File, build.CustomTarget, build.CustomTargetIndex)
+
 
 class HotdocTargetBuilder:
+
     def __init__(self, name, state, hotdoc, interpreter, kwargs):
         self.hotdoc = hotdoc
         self.build_by_default = kwargs.pop('build_by_default', False)
@@ -45,7 +53,7 @@
         self.name = name
         self.state = state
         self.interpreter = interpreter
-        self.include_paths = OrderedDict()
+        self.include_paths = mesonlib.OrderedSet()
 
         self.builddir = state.environment.get_build_dir()
         self.sourcedir = state.environment.get_source_dir()
@@ -57,17 +65,16 @@
 
         self._extra_extension_paths = set()
         self.extra_assets = set()
-        self._dependencies = 
+        self.extra_depends = 
         self._subprojects = 
 
-    def process_known_arg(self, option, types, argname=None,
-                          value_processor=None, mandatory=False,
-                          force_list=False):
+    def process_known_arg(self, option, argname=None, value_processor=None):
         if not argname:
             argname = option.strip("-").replace("-", "_")
 
-        value, _ = self.get_value(
-            types, argname, None, value_processor, mandatory, force_list)
+        value = self.kwargs.pop(argname)
+        if value is not None and value_processor:
+            value = value_processor(value)
 
         self.set_arg_value(option, value)
 
@@ -146,15 +153,6 @@
 
         return None, None
 
-    def setup_extension_paths(self, paths):
-        if not isinstance(paths, list):
-            paths = paths
-
-        for path in paths:
-            self.add_extension_paths(path)
-
-        return 
-
     def add_extension_paths(self, paths):
         for path in paths:
             if path in self._extra_extension_paths:
@@ -163,10 +161,6 @@
             self._extra_extension_paths.add(path)
             self.cmd.extend("--extra-extension-path", path)
 
-    def process_extra_extension_paths(self):
-        self.get_value(list, str, 'extra_extensions_paths',
-                       default="", value_processor=self.setup_extension_paths)
-
     def replace_dirs_in_string(self, string):
         return string.replace("@SOURCE_ROOT@", self.sourcedir).replace("@BUILD_ROOT@", self.builddir)
 
@@ -174,11 +168,10 @@
         if self.hotdoc.run_hotdoc('--has-extension=gi-extension') != 0:
             return
 
-        value, _ = self.get_value(list, str, 'gi_c_source_roots', default=, force_list=True)
+        value = self.kwargs.pop('gi_c_source_roots')
         value.extend(
-            os.path.join(self.state.environment.get_source_dir(),
-                         self.interpreter.subproject_dir, self.state.subproject),
-            os.path.join(self.state.environment.get_build_dir(), self.interpreter.subproject_dir, self.state.subproject)
+            os.path.join(self.sourcedir, self.state.root_subdir),
+            os.path.join(self.builddir, self.state.root_subdir)
         )
 
         self.cmd += '--gi-c-source-roots' + value
@@ -196,7 +189,7 @@
             elif isinstance(dep, Dependency):
                 cflags.update(dep.get_compile_args())
             elif isinstance(dep, (build.StaticLibrary, build.SharedLibrary)):
-                self._dependencies.append(dep)
+                self.extra_depends.append(dep)
                 for incd in dep.get_include_dirs():
                     cflags.update(incd.get_incdirs())
             elif isinstance(dep, HotdocTarget):
@@ -204,29 +197,27 @@
                 self.process_dependencies(dep.get_target_dependencies())
                 self._subprojects.extend(dep.subprojects)
                 self.process_dependencies(dep.subprojects)
-                self.add_include_path(os.path.join(self.builddir, dep.hotdoc_conf.subdir))
+                self.include_paths.add(os.path.join(self.builddir, dep.hotdoc_conf.subdir))
                 self.cmd += '--extra-assets=' + p for p in dep.extra_assets
                 self.add_extension_paths(dep.extra_extension_paths)
-            elif isinstance(dep, build.CustomTarget) or isinstance(dep, build.BuildTarget):
-                self._dependencies.append(dep)
+            elif isinstance(dep, (build.CustomTarget, build.BuildTarget)):
+                self.extra_depends.append(dep)
             elif isinstance(dep, build.CustomTargetIndex):
-                self._dependencies.append(dep.target)
+                self.extra_depends.append(dep.target)
 
         return f.strip('-I') for f in cflags
 
     def process_extra_assets(self):
-        self._extra_assets, _ = self.get_value("--extra-assets", (str, list), default=,
-                                               force_list=True)
+        self._extra_assets = self.kwargs.pop('extra_assets')
+
         for assets_path in self._extra_assets:
             self.cmd.extend("--extra-assets", assets_path)
 
     def process_subprojects(self):
-        _, value = self.get_value(
-            list, HotdocTarget, argname="subprojects",
-            force_list=True, value_processor=self.process_dependencies)
+        value = self.kwargs.pop('subprojects')
 
-        if value is not None:
-            self._subprojects.extend(value)
+        self.process_dependencies(value)
+        self._subprojects.extend(value)
 
     def flatten_config_command(self):
         cmd = 
@@ -241,10 +232,10 @@
 
                 continue
             elif isinstance(arg, (build.BuildTarget, build.CustomTarget)):
-                self._dependencies.append(arg)
+                self.extra_depends.append(arg)
                 arg = self.interpreter.backend.get_target_filename_abs(arg)
             elif isinstance(arg, build.CustomTargetIndex):
-                self._dependencies.append(arg.target)
+                self.extra_depends.append(arg.target)
                 arg = self.interpreter.backend.get_target_filename_abs(arg)
 
             cmd.append(arg)
@@ -287,27 +278,21 @@
             if arg in self.kwargs:
                 raise InvalidArguments(f'Argument "{arg}" is forbidden.')
 
-    def add_include_path(self, path):
-        self.include_pathspath = path
-
     def make_targets(self):
         self.check_forbidden_args()
-        file_types = (str, mesonlib.File, build.CustomTarget, build.CustomTargetIndex)
-        self.process_known_arg("--index", file_types, mandatory=True, value_processor=self.ensure_file)
-        self.process_known_arg("--project-version", str, mandatory=True)
-        self.process_known_arg("--sitemap", file_types, mandatory=True, value_processor=self.ensure_file)
-        self.process_known_arg("--html-extra-theme", str, value_processor=self.ensure_dir)
-        self.process_known_arg(None, list, "include_paths", force_list=True,
-                               value_processor=lambda x: self.add_include_path(self.ensure_dir(v)) for v in ensure_list(x))
-        self.process_known_arg('--c-include-directories',
-                               Dependency, build.StaticLibrary, build.SharedLibrary, list, argname="dependencies",
-                               force_list=True, value_processor=self.process_dependencies)
+        self.process_known_arg("--index", value_processor=self.ensure_file)
+        self.process_known_arg("--project-version")
+        self.process_known_arg("--sitemap", value_processor=self.ensure_file)
+        self.process_known_arg("--html-extra-theme", value_processor=self.ensure_dir)
+        self.include_paths.update(self.ensure_dir(v) for v in self.kwargs.pop('include_paths'))
+        self.process_known_arg('--c-include-directories', argname="dependencies", value_processor=self.process_dependencies)
         self.process_gi_c_source_roots()
         self.process_extra_assets()
-        self.process_extra_extension_paths()
+        self.add_extension_paths(self.kwargs.pop('extra_extension_paths'))
         self.process_subprojects()
+        self.extra_depends.extend(self.kwargs.pop('depends'))
 
-        install, install = self.get_value(bool, "install", mandatory=False)
+        install = self.kwargs.pop('install')
         self.process_extra_args()
 
         fullname = self.name + '-doc'
@@ -318,17 +303,17 @@
             f.write('{}')
 
         self.cmd += '--conf-file', hotdoc_config_path
-        self.add_include_path(os.path.join(self.builddir, self.subdir))
-        self.add_include_path(os.path.join(self.sourcedir, self.subdir))
+        self.include_paths.add(os.path.join(self.builddir, self.subdir))
+        self.include_paths.add(os.path.join(self.sourcedir, self.subdir))
 
         depfile = os.path.join(self.builddir, self.subdir, self.name + '.deps')
         self.cmd += '--deps-file-dest', depfile
 
-        for path in self.include_paths.keys():
+        for path in self.include_paths:
             self.cmd.extend('--include-path', path)
 
         if self.state.environment.coredata.get_option(mesonlib.OptionKey('werror', subproject=self.state.subproject)):
-            self.cmd.append('--fatal-warning')
+            self.cmd.append('--fatal-warnings')
         self.generate_hotdoc_config()
 
         target_cmd = self.build_command + "--internal", "hotdoc" + \
@@ -345,14 +330,14 @@
                               extra_assets=self._extra_assets,
                               subprojects=self._subprojects,
                               command=target_cmd,
-                              extra_depends=self._dependencies,
+                              extra_depends=self.extra_depends,
                               outputs=fullname,
                               sources=,
                               depfile=os.path.basename(depfile),
                               build_by_default=self.build_by_default)
 
         install_script = None
-        if install is True:
+        if install:
             install_script = self.state.backend.get_executable_serialisation(self.build_command + 
                 "--internal", "hotdoc",
                 "--install", os.path.join(fullname, 'html'),
@@ -396,18 +381,22 @@
 
 
 class HotDocModule(ExtensionModule):
-    @FeatureNew('Hotdoc Module', '0.48.0')
+
+    INFO = ModuleInfo('hotdoc', '0.48.0')
+
     def __init__(self, interpreter):
         super().__init__(interpreter)
         self.hotdoc = ExternalProgram('hotdoc')
         if not self.hotdoc.found():
             raise MesonException('hotdoc executable not found')
+        version = self.hotdoc.get_version(interpreter)
+        if not mesonlib.version_compare(version, f'>={MIN_HOTDOC_VERSION}'):
+            raise MesonException(f'hotdoc {MIN_HOTDOC_VERSION} required but not found.)')
 
-        try:
-            from hotdoc.run_hotdoc import run  # noqa: F401
-            self.hotdoc.run_hotdoc = run
-        except Exception as e:
-            raise MesonException(f'hotdoc {MIN_HOTDOC_VERSION} required but not found. ({e})')
+        def run_hotdoc(cmd):
+            return subprocess.run(self.hotdoc.get_command() + cmd, stdout=subprocess.DEVNULL).returncode
+
+        self.hotdoc.run_hotdoc = run_hotdoc
         self.methods.update({
             'has_extensions': self.has_extensions,
             'generate_doc': self.generate_doc,
@@ -419,8 +408,40 @@
         return self.hotdoc.run_hotdoc(f'--has-extension={extension}' for extension in args0) == 0
 
     @typed_pos_args('hotdoc.generate_doc', str)
+    @typed_kwargs(
+        'hotdoc.generate_doc',
+        KwargInfo('sitemap', file_types, required=True),
+        KwargInfo('index', file_types, required=True),
+        KwargInfo('project_version', str, required=True),
+        KwargInfo('html_extra_theme', (str, NoneType)),
+        KwargInfo('include_paths', ContainerTypeInfo(list, str), listify=True, default=),
+        # --c-include-directories
+        KwargInfo(
+            'dependencies',
+            ContainerTypeInfo(list, (Dependency, build.StaticLibrary, build.SharedLibrary,
+                                     build.CustomTarget, build.CustomTargetIndex)),
+            listify=True,
+            default=,
+        ),
+        KwargInfo(
+            'depends',
+            ContainerTypeInfo(list, (build.CustomTarget, build.CustomTargetIndex)),
+            listify=True,
+            default=,
+            since='0.64.1',
+        ),
+        KwargInfo('gi_c_source_roots', ContainerTypeInfo(list, str), listify=True, default=),
+        KwargInfo('extra_assets', ContainerTypeInfo(list, str), listify=True, default=),
+        KwargInfo('extra_extension_paths', ContainerTypeInfo(list, str), listify=True, default=),
+        KwargInfo('subprojects', ContainerTypeInfo(list, HotdocTarget), listify=True, default=),
+        KwargInfo('install', bool, default=False),
+        allow_unknown=True
+    )
     def generate_doc(self, state, args, kwargs):
         project_name = args0
+        if any(isinstance(x, (build.CustomTarget, build.CustomTargetIndex)) for x in kwargs'dependencies'):
+            FeatureDeprecated.single_use('hotdoc.generate_doc dependencies argument with custom_target',
+                                         '0.64.1', state.subproject, 'use `depends`', state.current_node)
         builder = HotdocTargetBuilder(project_name, state, self.hotdoc, self.interpreter, kwargs)
         target, install_script = builder.make_targets()
         targets = target

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/modules/i18n.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/modules/i18n.py Changed

@@ -16,7 +16,7 @@
 from os import path
 import typing as T
 
-from . import ExtensionModule, ModuleReturnValue
+from . import ExtensionModule, ModuleReturnValue, ModuleInfo
 from .. import build
 from .. import mesonlib
 from .. import mlog
@@ -124,6 +124,9 @@
 
 
 class I18nModule(ExtensionModule):
+
+    INFO = ModuleInfo('i18n')
+
     def __init__(self, interpreter: 'Interpreter'):
         super().__init__(interpreter)
         self.methods.update({
@@ -186,7 +189,6 @@
         if build_by_default is None:
             build_by_default = kwargs'install'
 
-        install_dir = kwargs'install_dir' if kwargs'install_dir' is not None else None
         install_tag = kwargs'install_tag' if kwargs'install_tag' is not None else None
 
         ct = build.CustomTarget(
@@ -199,7 +201,7 @@
             kwargs'output',
             build_by_default=build_by_default,
             install=kwargs'install',
-            install_dir=install_dir,
+            install_dir=kwargs'install_dir' if kwargs'install_dir' is not None else None,
             install_tag=install_tag,
         )
 
@@ -253,10 +255,13 @@
 
         extra_arg = '--extra-args=' + '@@'.join(extra_args) if extra_args else None
 
+        source_root = path.join(state.source_root, state.root_subdir)
+        subdir = path.relpath(state.subdir, start=state.root_subdir) if state.subdir else None
+
         potargs = state.environment.get_build_command() + '--internal', 'gettext', 'pot', pkg_arg
-        potargs.append(f'--source-root={state.source_root}')
-        if state.subdir:
-            potargs.append(f'--subdir={state.subdir}')
+        potargs.append(f'--source-root={source_root}')
+        if subdir:
+            potargs.append(f'--subdir={subdir}')
         if datadirs:
             potargs.append(datadirs)
         if extra_arg:
@@ -299,9 +304,9 @@
         targets.append(allgmotarget)
 
         updatepoargs = state.environment.get_build_command() + '--internal', 'gettext', 'update_po', pkg_arg
-        updatepoargs.append(f'--source-root={state.source_root}')
-        if state.subdir:
-            updatepoargs.append(f'--subdir={state.subdir}')
+        updatepoargs.append(f'--source-root={source_root}')
+        if subdir:
+            updatepoargs.append(f'--subdir={subdir}')
         if lang_arg:
             updatepoargs.append(lang_arg)
         if datadirs:
@@ -361,7 +366,6 @@
         if build_by_default is None:
             build_by_default = kwargs'install'
 
-        install_dir = kwargs'install_dir' if kwargs'install_dir' is not None else None
         install_tag = kwargs'install_tag' if kwargs'install_tag' is not None else None
 
         ct = build.CustomTarget(
@@ -375,7 +379,7 @@
             build_by_default=build_by_default,
             extra_depends=mo_targets,
             install=kwargs'install',
-            install_dir=install_dir,
+            install_dir=kwargs'install_dir' if kwargs'install_dir' is not None else None,
             install_tag=install_tag,
         )

_service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/modules/icestorm.py Added

@@ -0,0 +1,131 @@
+# Copyright 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.
+
+from __future__ import annotations
+import itertools
+import typing as T
+
+from . import ExtensionModule, ModuleReturnValue, ModuleInfo
+from .. import build
+from .. import mesonlib
+from ..interpreter.type_checking import CT_INPUT_KW
+from ..interpreterbase.decorators import KwargInfo, typed_kwargs, typed_pos_args
+
+if T.TYPE_CHECKING:
+    from typing_extensions import TypedDict
+
+    from . import ModuleState
+    from ..interpreter import Interpreter
+    from ..programs import ExternalProgram
+
+    class ProjectKwargs(TypedDict):
+
+        sources: T.ListT.Unionmesonlib.FileOrString, build.GeneratedTypes
+        constraint_file: T.Unionmesonlib.FileOrString, build.GeneratedTypes
+
+class IceStormModule(ExtensionModule):
+
+    INFO = ModuleInfo('FPGA/Icestorm', '0.45.0', unstable=True)
+
+    def __init__(self, interpreter: Interpreter) -> None:
+        super().__init__(interpreter)
+        self.tools: T.Dictstr, ExternalProgram = {}
+        self.methods.update({
+            'project': self.project,
+        })
+
+    def detect_tools(self, state: ModuleState) -> None:
+        self.tools'yosys' = state.find_program('yosys')
+        self.tools'arachne' = state.find_program('arachne-pnr')
+        self.tools'icepack' = state.find_program('icepack')
+        self.tools'iceprog' = state.find_program('iceprog')
+        self.tools'icetime' = state.find_program('icetime')
+
+    @typed_pos_args('icestorm.project', str,
+                    varargs=(str, mesonlib.File, build.CustomTarget, build.CustomTargetIndex,
+                             build.GeneratedList))
+    @typed_kwargs(
+        'icestorm.project',
+        CT_INPUT_KW.evolve(name='sources'),
+        KwargInfo(
+            'constraint_file',
+            (str, mesonlib.File, build.CustomTarget, build.CustomTargetIndex, build.GeneratedList),
+            required=True,
+        )
+    )
+    def project(self, state: ModuleState,
+                args: T.Tuplestr, T.ListT.Unionmesonlib.FileOrString, build.GeneratedTypes,
+                kwargs: ProjectKwargs) -> ModuleReturnValue:
+        if not self.tools:
+            self.detect_tools(state)
+        proj_name, arg_sources = args
+        all_sources = self.interpreter.source_strings_to_files(
+            list(itertools.chain(arg_sources, kwargs'sources')))
+
+        blif_target = build.CustomTarget(
+            f'{proj_name}_blif',
+            state.subdir,
+            state.subproject,
+            state.environment,
+            self.tools'yosys', '-q', '-p', 'synth_ice40 -blif @OUTPUT@', '@INPUT@',
+            all_sources,
+            f'{proj_name}.blif',
+        )
+
+        asc_target = build.CustomTarget(
+            f'{proj_name}_asc',
+            state.subdir,
+            state.subproject,
+            state.environment,
+            self.tools'arachne', '-q', '-d', '1k', '-p', '@INPUT@', '-o', '@OUTPUT@',
+            kwargs'constraint_file', blif_target,
+            f'{proj_name}.asc',
+        )
+
+        bin_target = build.CustomTarget(
+            f'{proj_name}_bin',
+            state.subdir,
+            state.subproject,
+            state.environment,
+            self.tools'icepack', '@INPUT@', '@OUTPUT@',
+            asc_target,
+            f'{proj_name}.bin',
+            build_by_default=True,
+        )
+
+        upload_target = build.RunTarget(
+            f'{proj_name}-upload',
+            self.tools'iceprog', bin_target,
+            ,
+            state.subdir,
+            state.subproject,
+            state.environment,
+        )
+
+        time_target = build.RunTarget(
+            f'{proj_name}-time',
+            self.tools'icetime', bin_target,
+            ,
+            state.subdir,
+            state.subproject,
+            state.environment,
+        )
+
+        return ModuleReturnValue(
+            None,
+            blif_target, asc_target, bin_target, upload_target, time_target)
+
+
+def initialize(interp: Interpreter) -> IceStormModule:
+    return IceStormModule(interp)

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/modules/java.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/modules/java.py Changed

@@ -13,7 +13,6 @@
 # limitations under the License.
 from __future__ import annotations
 
-import os
 import pathlib
 import typing as T
 
@@ -22,7 +21,8 @@
 from mesonbuild.compilers import detect_compiler_for
 from mesonbuild.interpreterbase.decorators import ContainerTypeInfo, FeatureDeprecated, FeatureNew, KwargInfo, typed_pos_args, typed_kwargs
 from mesonbuild.mesonlib import version_compare, MachineChoice
-from . import NewExtensionModule, ModuleReturnValue
+from . import NewExtensionModule, ModuleReturnValue, ModuleInfo
+from ..interpreter.type_checking import NoneType
 
 if T.TYPE_CHECKING:
     from . import ModuleState
@@ -30,12 +30,14 @@
     from ..interpreter import Interpreter
 
 class JavaModule(NewExtensionModule):
-    @FeatureNew('Java Module', '0.60.0')
+
+    INFO = ModuleInfo('java', '0.60.0')
+
     def __init__(self, interpreter: Interpreter):
         super().__init__()
         self.methods.update({
-            'generate_native_header': self.generate_native_header,
             'generate_native_headers': self.generate_native_headers,
+            'native_headers': self.native_headers,
         })
 
     def __get_java_compiler(self, state: ModuleState) -> Compiler:
@@ -43,68 +45,46 @@
             detect_compiler_for(state.environment, 'java', MachineChoice.BUILD)
         return state.environment.coredata.compilersMachineChoice.BUILD'java'
 
-    @FeatureDeprecated('java.generate_native_header', '0.62.0', 'Use java.generate_native_headers instead')
-    @typed_pos_args('java.generate_native_header', (str, mesonlib.File))
-    @typed_kwargs('java.generate_native_header', KwargInfo('package', str, default=None))
-    def generate_native_header(self, state: ModuleState, args: T.TupleT.Unionstr, mesonlib.File,
-                               kwargs: T.Dictstr, T.Optionalstr) -> ModuleReturnValue:
-        package = kwargs.get('package')
-
-        if isinstance(args0, mesonlib.File):
-            file = args0
-        else:
-            file = mesonlib.File.from_source_file(state.source_root, state.subdir, args0)
-
-        if package:
-            header = f'{package.replace(".", "_")}_{pathlib.Path(file.fname).stem}.h'
-        else:
-            header = f'{pathlib.Path(file.fname).stem}.h'
-
-        javac = self.__get_java_compiler(state)
-
-        target = CustomTarget(
-            os.path.basename(header),
-            state.subdir,
-            state.subproject,
-            state.environment,
-            mesonlib.listify(
-                javac.exelist,
-                '-d',
-                '@PRIVATE_DIR@',
-                '-h',
-                state.subdir,
-                '@INPUT@',
-            ),
-            file,
-            header,
-            backend=state.backend,
-        )
-        # It is only known that 1.8.0 won't pre-create the directory. 11 and 16
-        # do not exhibit this behavior.
-        if version_compare(javac.version, '1.8.0'):
-            pathlib.Path(state.backend.get_target_private_dir_abs(target)).mkdir(parents=True, exist_ok=True)
-
-        return ModuleReturnValue(target, target)
-
     @FeatureNew('java.generate_native_headers', '0.62.0')
-    @typed_pos_args('java.generate_native_headers',
+    @FeatureDeprecated('java.generate_native_headers', '1.0.0')
+    @typed_pos_args(
+        'java.generate_native_headers',
         varargs=(str, mesonlib.File, Target, CustomTargetIndex, GeneratedList))
-    @typed_kwargs('java.generate_native_headers',
-        KwargInfo('classes', ContainerTypeInfo(list, str), default=, listify=True,
-            required=True),
-        KwargInfo('package', str, default=None))
+    @typed_kwargs(
+        'java.generate_native_headers',
+        KwargInfo('classes', ContainerTypeInfo(list, str), default=, listify=True, required=True),
+        KwargInfo('package', (str, NoneType), default=None))
     def generate_native_headers(self, state: ModuleState, args: T.TupleT.Listmesonlib.FileOrString,
-                               kwargs: T.Dictstr, T.Optionalstr) -> ModuleReturnValue:
+                                kwargs: T.Dictstr, T.Optionalstr) -> ModuleReturnValue:
+        return self.__native_headers(state, args, kwargs)
+
+    @FeatureNew('java.native_headers', '1.0.0')
+    @typed_pos_args(
+        'java.native_headers',
+        varargs=(str, mesonlib.File, Target, CustomTargetIndex, GeneratedList))
+    @typed_kwargs(
+        'java.native_headers',
+        KwargInfo('classes', ContainerTypeInfo(list, str), default=, listify=True, required=True),
+        KwargInfo('package', (str, NoneType), default=None))
+    def native_headers(self, state: ModuleState, args: T.TupleT.Listmesonlib.FileOrString,
+                       kwargs: T.Dictstr, T.Optionalstr) -> ModuleReturnValue:
+        return self.__native_headers(state, args, kwargs)
+
+    def __native_headers(self, state: ModuleState, args: T.TupleT.Listmesonlib.FileOrString,
+                         kwargs: T.Dictstr, T.Optionalstr) -> ModuleReturnValue:
         classes = T.cast('T.Liststr', kwargs.get('classes'))
         package = kwargs.get('package')
 
+        if package:
+            sanitized_package = package.replace("-", "_").replace(".", "_")
+
         headers: T.Liststr = 
         for clazz in classes:
-            underscore_clazz = clazz.replace(".", "_")
+            sanitized_clazz = clazz.replace(".", "_")
             if package:
-                headers.append(f'{package.replace(".", "_")}_{underscore_clazz}.h')
+                headers.append(f'{sanitized_package}_{sanitized_clazz}.h')
             else:
-                headers.append(f'{underscore_clazz}.h')
+                headers.append(f'{sanitized_clazz}.h')
 
         javac = self.__get_java_compiler(state)

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/modules/keyval.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/modules/keyval.py Changed

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/modules/modtest.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/modules/modtest.py Changed

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/modules/pkgconfig.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/modules/pkgconfig.py Changed

@@ -1,4 +1,4 @@
-# Copyright 2015 The Meson development team
+# Copyright 2015-2022 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.
@@ -12,11 +12,14 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+from __future__ import annotations
+from collections import defaultdict
+from dataclasses import dataclass
 from pathlib import PurePath
 import os
 import typing as T
 
-from . import ExtensionModule
+from . import NewExtensionModule, ModuleInfo
 from . import ModuleReturnValue
 from .. import build
 from .. import dependencies
@@ -24,68 +27,131 @@
 from .. import mlog
 from ..coredata import BUILTIN_DIR_OPTIONS
 from ..dependencies import ThreadDependency
-from ..interpreterbase import permittedKwargs, FeatureNew, FeatureDeprecated, FeatureNewKwargs
+from ..interpreter.type_checking import D_MODULE_VERSIONS_KW, INSTALL_DIR_KW, VARIABLES_KW, NoneType
+from ..interpreterbase import FeatureNew, FeatureDeprecated
+from ..interpreterbase.decorators import ContainerTypeInfo, KwargInfo, typed_kwargs, typed_pos_args
 
 if T.TYPE_CHECKING:
+    from typing_extensions import TypedDict
+
     from . import ModuleState
+    from .. import mparser
+    from ..interpreter import Interpreter
+
+    ANY_DEP = T.Uniondependencies.Dependency, build.BuildTargetTypes, str
+    LIBS = T.Unionbuild.LibTypes, str
+
+    class GenerateKw(TypedDict):
+
+        version: T.Optionalstr
+        name: T.Optionalstr
+        filebase: T.Optionalstr
+        description: T.Optionalstr
+        url: str
+        subdirs: T.Liststr
+        conflicts: T.Liststr
+        dataonly: bool
+        libraries: T.ListANY_DEP
+        libraries_private: T.ListANY_DEP
+        requires: T.ListT.Unionstr, build.StaticLibrary, build.SharedLibrary, dependencies.Dependency
+        requires_private: T.ListT.Unionstr, build.StaticLibrary, build.SharedLibrary, dependencies.Dependency
+        install_dir: T.Optionalstr
+        d_module_versions: T.ListT.Unionstr, int
+        extra_cflags: T.Liststr
+        variables: T.Dictstr, str
+        uninstalled_variables: T.Dictstr, str
+        unescaped_variables: T.Dictstr, str
+        unescaped_uninstalled_variables: T.Dictstr, str
+
+
+_PKG_LIBRARIES: KwargInfoT.ListT.Unionstr, dependencies.Dependency, build.SharedLibrary, build.StaticLibrary, build.CustomTarget, build.CustomTargetIndex = KwargInfo(
+    'libraries',
+    ContainerTypeInfo(list, (str, dependencies.Dependency,
+                             build.SharedLibrary, build.StaticLibrary,
+                             build.CustomTarget, build.CustomTargetIndex)),
+    default=,
+    listify=True,
+)
+
+_PKG_REQUIRES: KwargInfoT.ListT.Unionstr, build.SharedLibrary, build.StaticLibrary, dependencies.Dependency = KwargInfo(
+    'requires',
+    ContainerTypeInfo(list, (str, build.SharedLibrary, build.StaticLibrary, dependencies.Dependency)),
+    default=,
+    listify=True,
+)
+
+
+def _as_str(obj: object) -> str:
+    assert isinstance(obj, str)
+    return obj
+
+
+@dataclass
+class MetaData:
+
+    filebase: str
+    display_name: str
+    location: mparser.BaseNode
+    warned: bool = False
 
-already_warned_objs = set()
 
 class DependenciesHelper:
-    def __init__(self, state, name):
+    def __init__(self, state: ModuleState, name: str, metadata: T.Dictstr, MetaData) -> None:
         self.state = state
         self.name = name
-        self.pub_libs = 
-        self.pub_reqs = 
-        self.priv_libs = 
-        self.priv_reqs = 
-        self.cflags = 
-        self.version_reqs = {}
-        self.link_whole_targets = 
-
-    def add_pub_libs(self, libs):
-        libs, reqs, cflags = self._process_libs(libs, True)
-        self.pub_libs = libs + self.pub_libs # prepend to preserve dependencies
+        self.pub_libs: T.ListLIBS = 
+        self.pub_reqs: T.Liststr = 
+        self.priv_libs: T.ListLIBS = 
+        self.priv_reqs: T.Liststr = 
+        self.cflags: T.Liststr = 
+        self.version_reqs: T.DefaultDictstr, T.Setstr = defaultdict(set)
+        self.link_whole_targets: T.ListT.Unionbuild.CustomTarget, build.CustomTargetIndex, build.StaticLibrary = 
+        self.metadata = metadata
+
+    def add_pub_libs(self, libs: T.ListANY_DEP) -> None:
+        p_libs, reqs, cflags = self._process_libs(libs, True)
+        self.pub_libs = p_libs + self.pub_libs # prepend to preserve dependencies
         self.pub_reqs += reqs
         self.cflags += cflags
 
-    def add_priv_libs(self, libs):
-        libs, reqs, _ = self._process_libs(libs, False)
-        self.priv_libs = libs + self.priv_libs
+    def add_priv_libs(self, libs: T.ListANY_DEP) -> None:
+        p_libs, reqs, _ = self._process_libs(libs, False)
+        self.priv_libs = p_libs + self.priv_libs
         self.priv_reqs += reqs
 
-    def add_pub_reqs(self, reqs):
+    def add_pub_reqs(self, reqs: T.ListT.Unionstr, build.StaticLibrary, build.SharedLibrary, dependencies.Dependency) -> None:
         self.pub_reqs += self._process_reqs(reqs)
 
-    def add_priv_reqs(self, reqs):
+    def add_priv_reqs(self, reqs: T.ListT.Unionstr, build.StaticLibrary, build.SharedLibrary, dependencies.Dependency) -> None:
         self.priv_reqs += self._process_reqs(reqs)
 
-    def _check_generated_pc_deprecation(self, obj):
-        if not hasattr(obj, 'generated_pc_warn'):
+    def _check_generated_pc_deprecation(self, obj: T.Unionbuild.CustomTarget, build.CustomTargetIndex, build.StaticLibrary, build.SharedLibrary) -> None:
+        if obj.get_id() in self.metadata:
             return
-        name = obj.generated_pc_warn0
-        if (name, obj.name) in already_warned_objs:
+        data = self.metadataobj.get_id()
+        if data.warned:
             return
         mlog.deprecation('Library', mlog.bold(obj.name), 'was passed to the '
                          '"libraries" keyword argument of a previous call '
                          'to generate() method instead of first positional '
-                         'argument.', 'Adding', mlog.bold(obj.generated_pc),
+                         'argument.', 'Adding', mlog.bold(data.display_name),
                          'to "Requires" field, but this is a deprecated '
                          'behaviour that will change in a future version '
                          'of Meson. Please report the issue if this '
                          'warning cannot be avoided in your case.',
-                         location=obj.generated_pc_warn1)
-        already_warned_objs.add((name, obj.name))
+                         location=data.location)
+        data.warned = True
 
-    def _process_reqs(self, reqs):
+    def _process_reqs(self, reqs: T.SequenceT.Unionstr, build.StaticLibrary, build.SharedLibrary, dependencies.Dependency) -> T.Liststr:
         '''Returns string names of requirements'''
-        processed_reqs = 
+        processed_reqs: T.Liststr = 
         for obj in mesonlib.listify(reqs):
             if not isinstance(obj, str):
                 FeatureNew.single_use('pkgconfig.generate requirement from non-string object', '0.46.0', self.state.subproject)
-            if hasattr(obj, 'generated_pc'):
+            if (isinstance(obj, (build.CustomTarget, build.CustomTargetIndex, build.SharedLibrary, build.StaticLibrary))
+                    and obj.get_id() in self.metadata):
                 self._check_generated_pc_deprecation(obj)
-                processed_reqs.append(obj.generated_pc)
+                processed_reqs.append(self.metadataobj.get_id().filebase)
             elif isinstance(obj, dependencies.PkgConfigDependency):
                 if obj.found():
                     processed_reqs.append(obj.name)
@@ -93,7 +159,7 @@
             elif isinstance(obj, str):
                 name, version_req = self.split_version_req(obj)
                 processed_reqs.append(name)
-                self.add_version_reqs(name, version_req)
+                self.add_version_reqs(name, version_req if version_req is not None else None)
             elif isinstance(obj, dependencies.Dependency) and not obj.found():
                 pass
             elif isinstance(obj, ThreadDependency):
@@ -104,18 +170,23 @@
                                               f'or pkgconfig-dependency object, got {obj!r}')
         return processed_reqs
 
-    def add_cflags(self, cflags):
+    def add_cflags(self, cflags: T.Liststr) -> None:
         self.cflags += mesonlib.stringlistify(cflags)
 
-    def _process_libs(self, libs, public: bool):
+    def _process_libs(
+            self, libs: T.ListANY_DEP, public: bool
+            ) -> T.TupleT.ListT.Unionstr, build.SharedLibrary, build.StaticLibrary, build.CustomTarget, build.CustomTargetIndex, T.Liststr, T.Liststr:
         libs = mesonlib.listify(libs)
-        processed_libs = 
-        processed_reqs = 
-        processed_cflags = 
+        processed_libs: T.ListT.Unionstr, build.SharedLibrary, build.StaticLibrary, build.CustomTarget, build.CustomTargetIndex = 
+        processed_reqs: T.Liststr = 
+        processed_cflags: T.Liststr = 
         for obj in libs:
-            if hasattr(obj, 'generated_pc'):
+            if (isinstance(obj, (build.CustomTarget, build.CustomTargetIndex, build.SharedLibrary, build.StaticLibrary))
+                    and obj.get_id() in self.metadata):
                 self._check_generated_pc_deprecation(obj)
-                processed_reqs.append(obj.generated_pc)
+                processed_reqs.append(self.metadataobj.get_id().filebase)
+            elif isinstance(obj, dependencies.ValgrindDependency):
+                pass
             elif isinstance(obj, dependencies.PkgConfigDependency):
                 if obj.found():
                     processed_reqs.append(obj.name)
@@ -158,13 +229,21 @@
 
         return processed_libs, processed_reqs, processed_cflags
 
-    def _add_lib_dependencies(self, link_targets, link_whole_targets, external_deps, public, private_external_deps=False):
+    def _add_lib_dependencies(
+            self, link_targets: T.Sequencebuild.BuildTargetTypes,
+            link_whole_targets: T.SequenceT.Unionbuild.StaticLibrary, build.CustomTarget, build.CustomTargetIndex,
+            external_deps: T.Listdependencies.Dependency,
+            public: bool,
+            private_external_deps: bool = False) -> None:
         add_libs = self.add_pub_libs if public else self.add_priv_libs
         # Recursively add all linked libraries
         for t in link_targets:
             # Internal libraries (uninstalled static library) will be promoted
             # to link_whole, treat them as such here.
             if t.is_internal():
+                # `is_internal` shouldn't return True for anything but a
+                # StaticLibrary, or a CustomTarget that is a StaticLibrary
+                assert isinstance(t, (build.StaticLibrary, build.CustomTarget, build.CustomTargetIndex)), 'for mypy'
                 self._add_link_whole(t, public)
             else:
                 add_libs(t)
@@ -172,11 +251,11 @@
             self._add_link_whole(t, public)
         # And finally its external dependencies
         if private_external_deps:
-            self.add_priv_libs(external_deps)
+            self.add_priv_libs(T.cast('T.ListANY_DEP', external_deps))
         else:
-            add_libs(external_deps)
+            add_libs(T.cast('T.ListANY_DEP', external_deps))
 
-    def _add_link_whole(self, t, public):
+    def _add_link_whole(self, t: T.Unionbuild.CustomTarget, build.CustomTargetIndex, build.StaticLibrary, public: bool) -> None:
         # Don't include static libraries that we link_whole. But we still need to
         # include their dependencies: a static library we link_whole
         # could itself link to a shared library or an installed static library.
@@ -187,32 +266,29 @@
         if isinstance(t, build.BuildTarget):
             self._add_lib_dependencies(t.link_targets, t.link_whole_targets, t.external_deps, public)
 
-    def add_version_reqs(self, name, version_reqs):
+    def add_version_reqs(self, name: str, version_reqs: T.OptionalT.Liststr) -> None:
         if version_reqs:
-            if name not in self.version_reqs:
-                self.version_reqsname = set()
             # Note that pkg-config is picky about whitespace.
             # 'foo > 1.2' is ok but 'foo>1.2' is not.
             # foo, bar' is ok, but 'foo,bar' is not.
-            new_vreqs = s for s in mesonlib.stringlistify(version_reqs)
-            self.version_reqsname.update(new_vreqs)
+            self.version_reqsname.update(version_reqs)
 
-    def split_version_req(self, s):
+    def split_version_req(self, s: str) -> T.Tuplestr, T.Optionalstr:
         for op in '>=', '<=', '!=', '==', '=', '>', '<':
             pos = s.find(op)
             if pos > 0:
                 return s0:pos.strip(), spos:.strip()
         return s, None
 
-    def format_vreq(self, vreq):
+    def format_vreq(self, vreq: str) -> str:
         # vreq are '>=1.0' and pkgconfig wants '>= 1.0'
         for op in '>=', '<=', '!=', '==', '=', '>', '<':
             if vreq.startswith(op):
                 return op + ' ' + vreqlen(op):
         return vreq
 
-    def format_reqs(self, reqs):
-        result = 
+    def format_reqs(self, reqs: T.Liststr) -> str:
+        result: T.Liststr = 
         for name in reqs:
             vreqs = self.version_reqs.get(name, None)
             if vreqs:
@@ -221,21 +297,22 @@
                 result += name
         return ', '.join(result)
 
-    def remove_dups(self):
+    def remove_dups(self) -> None:
         # Set of ids that have already been handled and should not be added any more
-        exclude = set()
+        exclude: T.Setstr = set()
 
         # We can't just check if 'x' is excluded because we could have copies of
         # the same SharedLibrary object for example.
-        def _ids(x):
-            if hasattr(x, 'generated_pc'):
-                yield x.generated_pc
-            if isinstance(x, build.Target):
+        def _ids(x: T.Unionstr, build.CustomTarget, build.CustomTargetIndex, build.StaticLibrary, build.SharedLibrary) -> T.Iterablestr:
+            if isinstance(x, str):
+                yield x
+            else:
+                if x.get_id() in self.metadata:
+                    yield self.metadatax.get_id().display_name
                 yield x.get_id()
-            yield x
 
         # Exclude 'x' in all its forms and return if it was already excluded
-        def _add_exclude(x):
+        def _add_exclude(x: T.Unionstr, build.CustomTarget, build.CustomTargetIndex, build.StaticLibrary, build.SharedLibrary) -> bool:
             was_excluded = False
             for i in _ids(x):
                 if i in exclude:
@@ -248,7 +325,17 @@
         for t in self.link_whole_targets:
             _add_exclude(t)
 
-        def _fn(xs, libs=False):
+        # Mypy thinks these overlap, but since List is invariant they don't,
+        # `Liststr`` is not a valid input to `Liststr | BuildTarget`.
+        # pylance/pyright gets this right, but for mypy we have to ignore the
+        # error
+        @T.overload
+        def _fn(xs: T.Liststr, libs: bool = False) -> T.Liststr: ...  # type: ignore
+
+        @T.overload
+        def _fn(xs: T.ListLIBS, libs: bool = False) -> T.ListLIBS: ...
+
+        def _fn(xs: T.UnionT.Liststr, T.ListLIBS, libs: bool = False) -> T.UnionT.Liststr, T.ListLIBS:
             # Remove duplicates whilst preserving original order
             result = 
             for x in xs:
@@ -273,15 +360,23 @@
         exclude = set()
         self.cflags = _fn(self.cflags)
 
-class PkgConfigModule(ExtensionModule):
-    def __init__(self, interpreter):
-        super().__init__(interpreter)
+class PkgConfigModule(NewExtensionModule):
+
+    INFO = ModuleInfo('pkgconfig')
+
+    # Track already generated pkg-config files This is stored as a class
+    # variable so that multiple `import()`s share metadata
+    _metadata: T.ClassVarT.Dictstr, MetaData = {}
+
+    def __init__(self) -> None:
+        super().__init__()
         self.methods.update({
             'generate': self.generate,
         })
 
-    def _get_lname(self, l, msg, pcfile, is_custom_target):
-        if is_custom_target:
+    def _get_lname(self, l: T.Unionbuild.SharedLibrary, build.StaticLibrary, build.CustomTarget, build.CustomTargetIndex,
+                   msg: str, pcfile: str) -> str:
+        if isinstance(l, (build.CustomTargetIndex, build.CustomTarget)):
             basename = os.path.basename(l.get_filename())
             name = os.path.splitext(basename)0
             if name.startswith('lib'):
@@ -304,7 +399,7 @@
         mlog.warning(msg.format(l.name, 'name_prefix', l.name, pcfile))
         return l.name
 
-    def _escape(self, value):
+    def _escape(self, value: T.Unionstr, PurePath) -> str:
         '''
         We cannot use quote_arg because it quotes with ' and " which does not
         work with pkg-config and pkgconf at all.
@@ -316,7 +411,7 @@
             value = value.as_posix()
         return value.replace(' ', r'\ ')
 
-    def _make_relative(self, prefix, subdir):
+    def _make_relative(self, prefix: T.UnionPurePath, str, subdir: T.UnionPurePath, str) -> str:
         prefix = PurePath(prefix)
         subdir = PurePath(subdir)
         try:
@@ -326,10 +421,14 @@
         # pathlib joining makes sure absolute libdir is not appended to '${prefix}'
         return ('${prefix}' / libdir).as_posix()
 
-    def _generate_pkgconfig_file(self, state, deps, subdirs, name, description,
-                                 url, version, pcfile, conflicts, variables,
-                                 unescaped_variables, uninstalled=False, dataonly=False,
-                                 pkgroot=None):
+    def _generate_pkgconfig_file(self, state: ModuleState, deps: DependenciesHelper,
+                                 subdirs: T.Liststr, name: T.Optionalstr,
+                                 description: T.Optionalstr, url: str, version: str,
+                                 pcfile: str, conflicts: T.Liststr,
+                                 variables: T.ListT.Tuplestr, str,
+                                 unescaped_variables: T.ListT.Tuplestr, str,
+                                 uninstalled: bool = False, dataonly: bool = False,
+                                 pkgroot: T.Optionalstr = None) -> None:
         coredata = state.environment.get_coredata()
         referenced_vars = set()
         optnames = x.name for x in BUILTIN_DIR_OPTIONS.keys()
@@ -374,16 +473,16 @@
             srcdir = PurePath(state.environment.get_source_dir())
         else:
             outdir = state.environment.scratch_dir
-            prefix = PurePath(coredata.get_option(mesonlib.OptionKey('prefix')))
+            prefix = PurePath(_as_str(coredata.get_option(mesonlib.OptionKey('prefix'))))
             if pkgroot:
-                pkgroot = PurePath(pkgroot)
-                if not pkgroot.is_absolute():
-                    pkgroot = prefix / pkgroot
-                elif prefix not in pkgroot.parents:
+                pkgroot_ = PurePath(pkgroot)
+                if not pkgroot_.is_absolute():
+                    pkgroot_ = prefix / pkgroot
+                elif prefix not in pkgroot_.parents:
                     raise mesonlib.MesonException('Pkgconfig prefix cannot be outside of the prefix '
                                                   'when pkgconfig.relocatable=true. '
-                                                  f'Pkgconfig prefix is {pkgroot.as_posix()}.')
-                prefix = PurePath('${pcfiledir}', os.path.relpath(prefix, pkgroot))
+                                                  f'Pkgconfig prefix is {pkgroot_.as_posix()}.')
+                prefix = PurePath('${pcfiledir}', os.path.relpath(prefix, pkgroot_))
         fname = os.path.join(outdir, pcfile)
         with open(fname, 'w', encoding='utf-8') as ofile:
             for optname in optnames:
@@ -391,7 +490,7 @@
                     if optname == 'prefix':
                         ofile.write('prefix={}\n'.format(self._escape(prefix)))
                     else:
-                        dirpath = PurePath(coredata.get_option(mesonlib.OptionKey(optname)))
+                        dirpath = PurePath(_as_str(coredata.get_option(mesonlib.OptionKey(optname))))
                         ofile.write('{}={}\n'.format(optname, self._escape('${prefix}' / dirpath)))
             if uninstalled and not dataonly:
                 ofile.write('srcdir={}\n'.format(self._escape(srcdir)))
@@ -417,7 +516,7 @@
             if len(conflicts) > 0:
                 ofile.write('Conflicts: {}\n'.format(' '.join(conflicts)))
 
-            def generate_libs_flags(libs):
+            def generate_libs_flags(libs: T.ListLIBS) -> T.Iterablestr:
                 msg = 'Library target {0!r} has {1!r} set. Compilers ' \
                       'may not find it from its \'-l{2}\' linker flag in the ' \
                       '{3!r} pkg-config file.'
@@ -426,6 +525,7 @@
                     if isinstance(l, str):
                         yield l
                     else:
+                        install_dir: T.Unionstr, bool
                         if uninstalled:
                             install_dir = os.path.dirname(state.backend.get_target_filename_abs(l))
                         else:
@@ -433,8 +533,7 @@
                             install_dir = _i0 if _i else None
                         if install_dir is False:
                             continue
-                        is_custom_target = isinstance(l, (build.CustomTarget, build.CustomTargetIndex))
-                        if not is_custom_target and 'cs' in l.compilers:
+                        if isinstance(l, build.BuildTarget) and 'cs' in l.compilers:
                             if isinstance(install_dir, str):
                                 Lflag = '-r{}/{}'.format(self._escape(self._make_relative(prefix, install_dir)), l.filename)
                             else:  # install_dir is True
@@ -447,16 +546,16 @@
                         if Lflag not in Lflags:
                             Lflags.append(Lflag)
                             yield Lflag
-                        lname = self._get_lname(l, msg, pcfile, is_custom_target)
+                        lname = self._get_lname(l, msg, pcfile)
                         # If using a custom suffix, the compiler may not be able to
                         # find the library
-                        if not is_custom_target and l.name_suffix_set:
+                        if isinstance(l, build.BuildTarget) and l.name_suffix_set:
                             mlog.warning(msg.format(l.name, 'name_suffix', lname, pcfile))
-                        if is_custom_target or 'cs' not in l.compilers:
+                        if isinstance(l, (build.CustomTarget, build.CustomTargetIndex)) or 'cs' not in l.compilers:
                             yield f'-l{lname}'
 
-            def get_uninstalled_include_dirs(libs):
-                result = 
+            def get_uninstalled_include_dirs(libs: T.ListLIBS) -> T.Liststr:
+                result: T.Liststr = 
                 for l in libs:
                     if isinstance(l, (str, build.CustomTarget, build.CustomTargetIndex)):
                         continue
@@ -470,7 +569,7 @@
                                 result.append(path)
                 return result
 
-            def generate_uninstalled_cflags(libs):
+            def generate_uninstalled_cflags(libs: T.ListLIBS) -> T.Iterablestr:
                 for d in get_uninstalled_include_dirs(libs):
                     for basedir in '${prefix}', '${srcdir}':
                         path = PurePath(basedir, d)
@@ -481,7 +580,7 @@
             if len(deps.priv_libs) > 0:
                 ofile.write('Libs.private: {}\n'.format(' '.join(generate_libs_flags(deps.priv_libs))))
 
-            cflags = 
+            cflags: T.Liststr = 
             if uninstalled:
                 cflags += generate_uninstalled_cflags(deps.pub_libs + deps.priv_libs)
             else:
@@ -494,81 +593,87 @@
             if cflags and not dataonly:
                 ofile.write('Cflags: {}\n'.format(' '.join(cflags)))
 
-    @FeatureNewKwargs('pkgconfig.generate', '0.59.0', 'unescaped_variables', 'unescaped_uninstalled_variables')
-    @FeatureNewKwargs('pkgconfig.generate', '0.54.0', 'uninstalled_variables')
-    @FeatureNewKwargs('pkgconfig.generate', '0.42.0', 'extra_cflags')
-    @FeatureNewKwargs('pkgconfig.generate', '0.41.0', 'variables')
-    @FeatureNewKwargs('pkgconfig.generate', '0.54.0', 'dataonly')
-    @permittedKwargs({'libraries', 'version', 'name', 'description', 'filebase',
-                      'subdirs', 'requires', 'requires_private', 'libraries_private',
-                      'install_dir', 'extra_cflags', 'variables', 'url', 'd_module_versions',
-                      'dataonly', 'conflicts', 'uninstalled_variables',
-                      'unescaped_variables', 'unescaped_uninstalled_variables'})
-    def generate(self, state: 'ModuleState', args, kwargs):
+    @typed_pos_args('pkgconfig.generate', optargs=(build.SharedLibrary, build.StaticLibrary))
+    @typed_kwargs(
+        'pkgconfig.generate',
+        D_MODULE_VERSIONS_KW.evolve(since='0.43.0'),
+        INSTALL_DIR_KW,
+        KwargInfo('conflicts', ContainerTypeInfo(list, str), default=, listify=True),
+        KwargInfo('dataonly', bool, default=False, since='0.54.0'),
+        KwargInfo('description', (str, NoneType)),
+        KwargInfo('extra_cflags', ContainerTypeInfo(list, str), default=, listify=True, since='0.42.0'),
+        KwargInfo('filebase', (str, NoneType), validator=lambda x: 'must not be an empty string' if x == '' else None),
+        KwargInfo('name', (str, NoneType), validator=lambda x: 'must not be an empty string' if x == '' else None),
+        KwargInfo('subdirs', ContainerTypeInfo(list, str), default=, listify=True),
+        KwargInfo('url', str, default=''),
+        KwargInfo('version', (str, NoneType)),
+        VARIABLES_KW.evolve(name="unescaped_uninstalled_variables", since='0.59.0'),
+        VARIABLES_KW.evolve(name="unescaped_variables", since='0.59.0'),
+        VARIABLES_KW.evolve(name="uninstalled_variables", since='0.54.0', since_values={dict: '0.56.0'}),
+        VARIABLES_KW.evolve(since='0.41.0', since_values={dict: '0.56.0'}),
+        _PKG_LIBRARIES,
+        _PKG_LIBRARIES.evolve(name='libraries_private'),
+        _PKG_REQUIRES,
+        _PKG_REQUIRES.evolve(name='requires_private'),
+    )
+    def generate(self, state: ModuleState,
+                 args: T.TupleT.OptionalT.Unionbuild.SharedLibrary, build.StaticLibrary,
+                 kwargs: GenerateKw) -> ModuleReturnValue:
         default_version = state.project_version
-        default_install_dir = None
-        default_description = None
-        default_name = None
-        mainlib = None
+        default_install_dir: T.Optionalstr = None
+        default_description: T.Optionalstr = None
+        default_name: T.Optionalstr = None
+        mainlib: T.OptionalT.Unionbuild.SharedLibrary, build.StaticLibrary = None
         default_subdirs = '.'
-        if not args and 'version' not in kwargs:
-            FeatureNew.single_use('pkgconfig.generate implicit version keyword', '0.46.0', state.subproject)
-        elif len(args) == 1:
+        if args0:
             FeatureNew.single_use('pkgconfig.generate optional positional argument', '0.46.0', state.subproject)
             mainlib = args0
-            if not isinstance(mainlib, (build.StaticLibrary, build.SharedLibrary)):
-                raise mesonlib.MesonException('Pkgconfig_gen first positional argument must be a library object')
             default_name = mainlib.name
             default_description = state.project_name + ': ' + mainlib.name
             install_dir = mainlib.get_custom_install_dir()
             if install_dir and isinstance(install_dir0, str):
                 default_install_dir = os.path.join(install_dir0, 'pkgconfig')
-        elif len(args) > 1:
-            raise mesonlib.MesonException('Too many positional arguments passed to Pkgconfig_gen.')
-
-        dataonly = kwargs.get('dataonly', False)
-        if not isinstance(dataonly, bool):
-            raise mesonlib.MesonException('dataonly must be boolean.')
+        else:
+            if kwargs'version' is None:
+                FeatureNew.single_use('pkgconfig.generate implicit version keyword', '0.46.0', state.subproject)
+            if kwargs'name' is None:
+                raise build.InvalidArguments(
+                    'pkgconfig.generate: if a library is not passed as a '
+                    'positional argument, the name keyword argument is '
+                    'required.')
+
+        dataonly = kwargs'dataonly'
         if dataonly:
             default_subdirs = 
-            blocked_vars = 'libraries', 'libraries_private', 'require_private', 'extra_cflags', 'subdirs'
-            if any(k in kwargs for k in blocked_vars):
+            blocked_vars = 'libraries', 'libraries_private', 'requires_private', 'extra_cflags', 'subdirs'
+            if any(kwargsk for k in blocked_vars):  # type: ignore
                 raise mesonlib.MesonException(f'Cannot combine dataonly with any of {blocked_vars}')
             default_install_dir = os.path.join(state.environment.get_datadir(), 'pkgconfig')
 
-        subdirs = mesonlib.stringlistify(kwargs.get('subdirs', default_subdirs))
-        version = kwargs.get('version', default_version)
-        if not isinstance(version, str):
-            raise mesonlib.MesonException('Version must be specified.')
-        name = kwargs.get('name', default_name)
-        if not isinstance(name, str):
-            raise mesonlib.MesonException('Name not specified.')
-        filebase = kwargs.get('filebase', name)
-        if not isinstance(filebase, str):
-            raise mesonlib.MesonException('Filebase must be a string.')
-        description = kwargs.get('description', default_description)
-        if not isinstance(description, str):
-            raise mesonlib.MesonException('Description is not a string.')
-        url = kwargs.get('url', '')
-        if not isinstance(url, str):
-            raise mesonlib.MesonException('URL is not a string.')
-        conflicts = mesonlib.stringlistify(kwargs.get('conflicts', ))
+        subdirs = kwargs'subdirs' or default_subdirs
+        version = kwargs'version' if kwargs'version' is not None else default_version
+        name = kwargs'name' if kwargs'name' is not None else default_name
+        assert isinstance(name, str), 'for mypy'
+        filebase = kwargs'filebase' if kwargs'filebase' is not None else name
+        description = kwargs'description' if kwargs'description' is not None else default_description
+        url = kwargs'url'
+        conflicts = kwargs'conflicts'
 
         # Prepend the main library to public libraries list. This is required
         # so dep.add_pub_libs() can handle dependency ordering correctly and put
         # extra libraries after the main library.
-        libraries = mesonlib.extract_as_list(kwargs, 'libraries')
+        libraries = kwargs'libraries'.copy()
         if mainlib:
-            libraries = mainlib + libraries
+            libraries.insert(0, mainlib)
 
-        deps = DependenciesHelper(state, filebase)
+        deps = DependenciesHelper(state, filebase, self._metadata)
         deps.add_pub_libs(libraries)
-        deps.add_priv_libs(kwargs.get('libraries_private', ))
-        deps.add_pub_reqs(kwargs.get('requires', ))
-        deps.add_priv_reqs(kwargs.get('requires_private', ))
-        deps.add_cflags(kwargs.get('extra_cflags', ))
+        deps.add_priv_libs(kwargs'libraries_private')
+        deps.add_pub_reqs(kwargs'requires')
+        deps.add_priv_reqs(kwargs'requires_private')
+        deps.add_cflags(kwargs'extra_cflags')
 
-        dversions = kwargs.get('d_module_versions', None)
+        dversions = kwargs'd_module_versions'
         if dversions:
             compiler = state.environment.coredata.compilers.host.get('d')
             if compiler:
@@ -576,7 +681,7 @@
 
         deps.remove_dups()
 
-        def parse_variable_list(vardict):
+        def parse_variable_list(vardict: T.Dictstr, str) -> T.ListT.Tuplestr, str:
             reserved = 'prefix', 'libdir', 'includedir'
             variables = 
             for name, value in vardict.items():
@@ -585,32 +690,29 @@
                 variables.append((name, value))
             return variables
 
-        variables = self.interpreter.extract_variables(kwargs, dict_new=True)
-        variables = parse_variable_list(variables)
-        unescaped_variables = self.interpreter.extract_variables(kwargs, argname='unescaped_variables')
-        unescaped_variables = parse_variable_list(unescaped_variables)
+        variables = parse_variable_list(kwargs'variables')
+        unescaped_variables = parse_variable_list(kwargs'unescaped_variables')
 
         pcfile = filebase + '.pc'
-        pkgroot = pkgroot_name = kwargs.get('install_dir', default_install_dir)
+        pkgroot = pkgroot_name = kwargs'install_dir' or default_install_dir
         if pkgroot is None:
             if mesonlib.is_freebsd():
-                pkgroot = os.path.join(state.environment.coredata.get_option(mesonlib.OptionKey('prefix')), 'libdata', 'pkgconfig')
+                pkgroot = os.path.join(_as_str(state.environment.coredata.get_option(mesonlib.OptionKey('prefix'))), 'libdata', 'pkgconfig')
                 pkgroot_name = os.path.join('{prefix}', 'libdata', 'pkgconfig')
+            elif mesonlib.is_haiku():
+                pkgroot = os.path.join(_as_str(state.environment.coredata.get_option(mesonlib.OptionKey('prefix'))), 'develop', 'lib', 'pkgconfig')
+                pkgroot_name = os.path.join('{prefix}', 'develop', 'lib', 'pkgconfig')
             else:
-                pkgroot = os.path.join(state.environment.coredata.get_option(mesonlib.OptionKey('libdir')), 'pkgconfig')
+                pkgroot = os.path.join(_as_str(state.environment.coredata.get_option(mesonlib.OptionKey('libdir'))), 'pkgconfig')
                 pkgroot_name = os.path.join('{libdir}', 'pkgconfig')
-        if not isinstance(pkgroot, str):
-            raise mesonlib.MesonException('Install_dir must be a string.')
         relocatable = state.get_option('relocatable', module='pkgconfig')
         self._generate_pkgconfig_file(state, deps, subdirs, name, description, url,
                                       version, pcfile, conflicts, variables,
                                       unescaped_variables, False, dataonly,
                                       pkgroot=pkgroot if relocatable else None)
         res = build.Data(mesonlib.File(True, state.environment.get_scratch_dir(), pcfile), pkgroot, pkgroot_name, None, state.subproject, install_tag='devel')
-        variables = self.interpreter.extract_variables(kwargs, argname='uninstalled_variables', dict_new=True)
-        variables = parse_variable_list(variables)
-        unescaped_variables = self.interpreter.extract_variables(kwargs, argname='unescaped_uninstalled_variables')
-        unescaped_variables = parse_variable_list(unescaped_variables)
+        variables = parse_variable_list(kwargs'uninstalled_variables')
+        unescaped_variables = parse_variable_list(kwargs'unescaped_uninstalled_variables')
 
         pcfile = filebase + '-uninstalled.pc'
         self._generate_pkgconfig_file(state, deps, subdirs, name, description, url,
@@ -623,17 +725,18 @@
         # libraries instead of just the main one. Keep doing that but warn if
         # anyone is relying on that deprecated behaviour.
         if mainlib:
-            if not hasattr(mainlib, 'generated_pc'):
-                mainlib.generated_pc = filebase
+            if mainlib.get_id() not in self._metadata:
+                self._metadatamainlib.get_id() = MetaData(
+                    filebase, name, state.current_node)
             else:
                 mlog.warning('Already generated a pkg-config file for', mlog.bold(mainlib.name))
         else:
             for lib in deps.pub_libs:
-                if not isinstance(lib, str) and not hasattr(lib, 'generated_pc'):
-                    lib.generated_pc = filebase
-                    location = state.current_node
-                    lib.generated_pc_warn = name, location
+                if not isinstance(lib, str) and lib.get_id() not in self._metadata:
+                    self._metadatalib.get_id() = MetaData(
+                        filebase, name, state.current_node)
         return ModuleReturnValue(res, res)
 
-def initialize(*args, **kwargs):
-    return PkgConfigModule(*args, **kwargs)
+
+def initialize(interp: Interpreter) -> PkgConfigModule:
+    return PkgConfigModule()

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/modules/python.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/modules/python.py Changed

@@ -14,13 +14,14 @@
 from __future__ import annotations
 
 from pathlib import Path
+import copy
 import functools
 import json
 import os
 import shutil
 import typing as T
 
-from . import ExtensionModule
+from . import ExtensionModule, ModuleInfo
 from .. import mesonlib
 from .. import mlog
 from ..coredata import UserFeatureOption
@@ -30,7 +31,8 @@
 from ..dependencies.detect import get_dep_identifier
 from ..environment import detect_cpu_family
 from ..interpreter import ExternalProgramHolder, extract_required_kwarg, permitted_dependency_kwargs
-from ..interpreter.type_checking import NoneType
+from ..interpreter import primitives as P_OBJ
+from ..interpreter.type_checking import NoneType, PRESERVE_PATH_KW
 from ..interpreterbase import (
     noPosargs, noKwargs, permittedKwargs, ContainerTypeInfo,
     InvalidArguments, typed_pos_args, typed_kwargs, KwargInfo,
@@ -66,7 +68,7 @@
 
     class PyInstallKw(TypedDict):
 
-        pure: bool
+        pure: T.Optionalbool
         subdir: str
         install_tag: T.Optionalstr
 
@@ -74,6 +76,7 @@
 
         disabler: bool
         modules: T.Liststr
+        pure: T.Optionalbool
 
     _Base = ExternalDependency
 else:
@@ -88,13 +91,20 @@
 class _PythonDependencyBase(_Base):
 
     def __init__(self, python_holder: 'PythonInstallation', embed: bool):
-        self.name = 'python'  # override the name from the "real" dependency lookup
         self.embed = embed
         self.version: str = python_holder.version
         self.platform = python_holder.platform
         self.variables = python_holder.variables
         self.paths = python_holder.paths
-        self.link_libpython = python_holder.link_libpython
+        # The "-embed" version of python.pc / python-config was introduced in 3.8,
+        # and distutils extension linking was changed to be considered a non embed
+        # usage. Before then, this dependency always uses the embed=True handling
+        # because that is the only one that exists.
+        #
+        # On macOS and some Linux distros (Debian) distutils doesn't link extensions
+        # against libpython, even on 3.7 and below. We call into distutils and
+        # mirror its behavior. See https://github.com/mesonbuild/meson/issues/4117
+        self.link_libpython = python_holder.link_libpython or embed
         self.info: T.OptionalT.Dictstr, str = None
         if mesonlib.version_compare(self.version, '>= 3.0'):
             self.major_version = 3
@@ -118,6 +128,10 @@
         if libpc and not self.is_found:
             mlog.debug(f'"python-{self.version}" could not be found in LIBPC, this is likely due to a relocated python installation')
 
+        # pkg-config files are usually accurate starting with python 3.8
+        if not self.link_libpython and mesonlib.version_compare(self.version, '< 3.8'):
+            self.link_args = 
+
 
 class PythonFrameworkDependency(ExtraFrameworkDependency, _PythonDependencyBase):
 
@@ -139,6 +153,13 @@
         else:
             self._find_libpy(installation, environment)
 
+        if not self.link_libpython:
+            # match pkg-config behavior
+            self.link_args = 
+
+        if not self.clib_compiler.has_header('Python.h', '', environment, extra_args=self.compile_args):
+            self.is_found = False
+
     def _find_libpy(self, python_holder: 'PythonInstallation', environment: 'Environment') -> None:
         if python_holder.is_pypy:
             if self.major_version == 3:
@@ -180,7 +201,7 @@
                 return None
         elif self.platform == 'win32':
             return '32'
-        elif self.platform in ('win64', 'win-amd64'):
+        elif self.platform in {'win64', 'win-amd64'}:
             return '64'
         mlog.log(f'Unknown Windows Python platform {self.platform!r}')
         return None
@@ -260,7 +281,8 @@
         self.compile_args += '-I' + path for path in inc_paths if path
 
         # https://sourceforge.net/p/mingw-w64/mailman/message/30504611/
-        if pyarch == '64' and self.major_version == 2:
+        # https://github.com/python/cpython/pull/100137
+        if pyarch == '64' and mesonlib.version_compare(self.version, '<3.12'):
             self.compile_args += '-DMS_WIN64'
 
         self.is_found = True
@@ -369,6 +391,15 @@
 variables = sysconfig.get_config_vars()
 variables.update({'base_prefix': getattr(sys, 'base_prefix', sys.prefix)})
 
+if sys.version_info < (3, 0):
+    suffix = variables.get('SO')
+elif sys.version_info < (3, 8, 7):
+    # https://bugs.python.org/issue?@action=redirect&bpo=39825
+    from distutils.sysconfig import get_config_var
+    suffix = get_config_var('EXT_SUFFIX')
+else:
+    suffix = variables.get('EXT_SUFFIX')
+
 print(json.dumps({
   'variables': variables,
   'paths': paths,
@@ -379,6 +410,7 @@
   'is_pypy': '__pypy__' in sys.builtin_module_names,
   'is_venv': sys.prefix != variables'base_prefix',
   'link_libpython': links_against_libpython(),
+  'suffix': suffix,
 }))
 '''
 
@@ -408,6 +440,7 @@
             'variables': {},
             'version': '0.0',
         }
+        self.pure: bool = True
 
     def _check_version(self, version: str) -> bool:
         if self.name == 'python2':
@@ -436,8 +469,6 @@
             mlog.debug(stderr)
 
         if info is not None and self._check_version(info'version'):
-            variables = info'variables'
-            info'suffix' = variables.get('EXT_SUFFIX') or variables.get('SO') or variables.get('.so')
             self.info = T.cast('PythonIntrospectionDict', info)
             self.platlib = self._get_path(state, 'platlib')
             self.purelib = self._get_path(state, 'purelib')
@@ -471,7 +502,7 @@
         return rel_path
 
 
-_PURE_KW = KwargInfo('pure', bool, default=True)
+_PURE_KW = KwargInfo('pure', (bool, NoneType))
 _SUBDIR_KW = KwargInfo('subdir', str, default='')
 
 
@@ -484,6 +515,7 @@
         self.variables = info'variables'
         self.suffix = info'suffix'
         self.paths = info'paths'
+        self.pure = python.pure
         self.platlib_install_path = os.path.join(prefix, python.platlib)
         self.purelib_install_path = os.path.join(prefix, python.purelib)
         self.version = info'version'
@@ -514,19 +546,10 @@
             if not isinstance(subdir, str):
                 raise InvalidArguments('"subdir" argument must be a string.')
 
-            kwargs'install_dir' = os.path.join(self.platlib_install_path, subdir)
-
-        new_deps = 
-        has_pydep = False
-        for dep in mesonlib.extract_as_list(kwargs, 'dependencies'):
-            if isinstance(dep, _PythonDependencyBase):
-                has_pydep = True
-                # On macOS and some Linux distros (Debian) distutils doesn't link
-                # extensions against libpython. We call into distutils and mirror its
-                # behavior. See https://github.com/mesonbuild/meson/issues/4117
-                if not self.link_libpython:
-                    dep = dep.get_partial_dependency(compile_args=True)
-            new_deps.append(dep)
+            kwargs'install_dir' = self._get_install_dir_impl(False, subdir)
+
+        new_deps = mesonlib.extract_as_list(kwargs, 'dependencies')
+        has_pydep = any(isinstance(dep, _PythonDependencyBase) for dep in new_deps)
         if not has_pydep:
             pydep = self._dependency_method_impl({})
             if not pydep.found():
@@ -588,28 +611,40 @@
             return dep
 
     @typed_pos_args('install_data', varargs=(str, mesonlib.File))
-    @typed_kwargs('python_installation.install_sources', _PURE_KW, _SUBDIR_KW,
-                  KwargInfo('install_tag', (str, NoneType), since='0.60.0'))
+    @typed_kwargs(
+        'python_installation.install_sources',
+        _PURE_KW,
+        _SUBDIR_KW,
+        PRESERVE_PATH_KW,
+        KwargInfo('install_tag', (str, NoneType), since='0.60.0')
+    )
     def install_sources_method(self, args: T.TupleT.ListT.Unionstr, mesonlib.File,
                                kwargs: 'PyInstallKw') -> 'Data':
-        tag = kwargs'install_tag' or 'runtime'
+        tag = kwargs'install_tag' or 'python-runtime'
+        pure = kwargs'pure' if kwargs'pure' is not None else self.pure
+        install_dir = self._get_install_dir_impl(pure, kwargs'subdir')
         return self.interpreter.install_data_impl(
             self.interpreter.source_strings_to_files(args0),
-            self._get_install_dir_impl(kwargs'pure', kwargs'subdir'),
+            install_dir,
             mesonlib.FileMode(), rename=None, tag=tag, install_data_type='python',
-            install_dir_name=self._get_install_dir_name_impl(kwargs'pure', kwargs'subdir'))
+            install_dir_name=install_dir.optname,
+            preserve_path=kwargs'preserve_path')
 
     @noPosargs
     @typed_kwargs('python_installation.install_dir', _PURE_KW, _SUBDIR_KW)
     def get_install_dir_method(self, args: T.List'TYPE_var', kwargs: 'PyInstallKw') -> str:
-        return self._get_install_dir_impl(kwargs'pure', kwargs'subdir')
+        pure = kwargs'pure' if kwargs'pure' is not None else self.pure
+        return self._get_install_dir_impl(pure, kwargs'subdir')
 
-    def _get_install_dir_impl(self, pure: bool, subdir: str) -> str:
-        return os.path.join(
-            self.purelib_install_path if pure else self.platlib_install_path, subdir)
+    def _get_install_dir_impl(self, pure: bool, subdir: str) -> P_OBJ.OptionString:
+        if pure:
+            base = self.purelib_install_path
+            name = '{py_purelib}'
+        else:
+            base = self.platlib_install_path
+            name = '{py_platlib}'
 
-    def _get_install_dir_name_impl(self, pure: bool, subdir: str) -> str:
-        return os.path.join('{py_purelib}' if pure else '{py_platlib}', subdir)
+        return P_OBJ.OptionString(os.path.join(base, subdir), os.path.join(name, subdir))
 
     @noPosargs
     @noKwargs
@@ -657,7 +692,8 @@
 
 class PythonModule(ExtensionModule):
 
-    @FeatureNew('Python Module', '0.46.0')
+    INFO = ModuleInfo('python', '0.46.0')
+
     def __init__(self, interpreter: 'Interpreter') -> None:
         super().__init__(interpreter)
         self.installations: T.Dictstr, ExternalProgram = {}
@@ -699,7 +735,7 @@
             # on various platforms, let's not give up just yet, if an executable
             # named python is available and has a compatible version, let's use
             # it
-            if not python.found() and name_or_path in 'python2', 'python3':
+            if not python.found() and name_or_path in {'python2', 'python3'}:
                 python = PythonExternalProgram('python')
 
         if python.found():
@@ -721,6 +757,7 @@
         KwargInfo('required', (bool, UserFeatureOption), default=True),
         KwargInfo('disabler', bool, default=False, since='0.49.0'),
         KwargInfo('modules', ContainerTypeInfo(list, str), listify=True, default=, since='0.51.0'),
+        _PURE_KW.evolve(default=True, since='0.64.0'),
     )
     def find_installation(self, state: 'ModuleState', args: T.TupleT.Optionalstr,
                           kwargs: 'FindInstallationKw') -> ExternalProgram:
@@ -785,6 +822,8 @@
                 raise mesonlib.MesonException('{} is missing modules: {}'.format(name_or_path or 'python', ', '.join(missing_modules)))
             return NonExistingExternalProgram()
         else:
+            python = copy.copy(python)
+            python.pure = kwargs'pure'
             return python
 
         raise mesonlib.MesonBugException('Unreachable code was reached (PythonModule.find_installation).')

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/modules/python3.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/modules/python3.py Changed

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/modules/qt.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/modules/qt.py Changed

@@ -158,7 +158,7 @@
                     care = out
                 else:
                     care = err
-                return care.split(' ')-1.replace(')', '').strip()
+                return care.rsplit(' ', maxsplit=1)-1.replace(')', '').strip()
 
             p = state.find_program(b, required=False,
                                    version_func=get_version,
@@ -198,12 +198,11 @@
         abspath: str
         if isinstance(rcc_file, str):
             abspath = os.path.join(state.environment.source_dir, state.subdir, rcc_file)
-            rcc_dirname = os.path.dirname(abspath)
         else:
             abspath = rcc_file.absolute_path(state.environment.source_dir, state.environment.build_dir)
-            rcc_dirname = os.path.dirname(abspath)
+        rcc_dirname = os.path.dirname(abspath)
 
-        # FIXME: what error are we actually trying to check here?
+        # FIXME: what error are we actually trying to check here? (probably parse errors?)
         try:
             tree = ET.parse(abspath)
             root = tree.getroot()
@@ -212,10 +211,14 @@
                 if child.tag != 'file':
                     mlog.warning("malformed rcc file: ", os.path.join(state.subdir, str(rcc_file)))
                     break
+                elif child.text is None:
+                    raise MesonException(f'<file> element without a path in {os.path.join(state.subdir, str(rcc_file))}')
                 else:
                     result.append(child.text)
 
             return rcc_dirname, result
+        except MesonException:
+            raise
         except Exception:
             raise MesonException(f'Unable to parse resource file {abspath}')

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/modules/qt4.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/modules/qt4.py Changed

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/modules/qt5.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/modules/qt5.py Changed

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/modules/qt6.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/modules/qt6.py Changed

_service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/modules/rust.py Added

@@ -0,0 +1,250 @@
+# Copyright © 2020-2022 Intel Corporation
+
+# 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.
+from __future__ import annotations
+
+import os
+import typing as T
+
+from . import ExtensionModule, ModuleReturnValue, ModuleInfo
+from .. import mlog
+from ..build import BothLibraries, BuildTarget, CustomTargetIndex, Executable, ExtractedObjects, GeneratedList, IncludeDirs, CustomTarget, StructuredSources
+from ..dependencies import Dependency, ExternalLibrary
+from ..interpreter.type_checking import DEPENDENCIES_KW, TEST_KWS, OUTPUT_KW, INCLUDE_DIRECTORIES, include_dir_string_new
+from ..interpreterbase import ContainerTypeInfo, InterpreterException, KwargInfo, typed_kwargs, typed_pos_args, noPosargs
+from ..mesonlib import File
+
+if T.TYPE_CHECKING:
+    from . import ModuleState
+    from ..interpreter import Interpreter
+    from ..interpreter import kwargs as _kwargs
+    from ..interpreter.interpreter import SourceInputs, SourceOutputs
+    from ..programs import ExternalProgram
+
+    from typing_extensions import TypedDict
+
+    class FuncTest(_kwargs.BaseTest):
+
+        dependencies: T.ListT.UnionDependency, ExternalLibrary
+        is_parallel: bool
+
+    class FuncBindgen(TypedDict):
+
+        args: T.Liststr
+        c_args: T.Liststr
+        include_directories: T.ListIncludeDirs
+        input: T.ListSourceInputs
+        output: str
+        dependencies: T.ListT.UnionDependency, ExternalLibrary
+
+
+class RustModule(ExtensionModule):
+
+    """A module that holds helper functions for rust."""
+
+    INFO = ModuleInfo('rust', '0.57.0', stabilized='1.0.0')
+
+    def __init__(self, interpreter: Interpreter) -> None:
+        super().__init__(interpreter)
+        self._bindgen_bin: T.OptionalExternalProgram = None
+        self.methods.update({
+            'test': self.test,
+            'bindgen': self.bindgen,
+        })
+
+    @typed_pos_args('rust.test', str, BuildTarget)
+    @typed_kwargs(
+        'rust.test',
+        *TEST_KWS,
+        DEPENDENCIES_KW,
+        KwargInfo('is_parallel', bool, default=False),
+    )
+    def test(self, state: ModuleState, args: T.Tuplestr, BuildTarget, kwargs: FuncTest) -> ModuleReturnValue:
+        """Generate a rust test target from a given rust target.
+
+        Rust puts it's unitests inside it's main source files, unlike most
+        languages that put them in external files. This means that normally
+        you have to define two separate targets with basically the same
+        arguments to get tests:
+
+        ```meson
+        rust_lib_sources = ...
+        rust_lib = static_library(
+            'rust_lib',
+            rust_lib_sources,
+        )
+
+        rust_lib_test = executable(
+            'rust_lib_test',
+            rust_lib_sources,
+            rust_args : '--test',
+        )
+
+        test(
+            'rust_lib_test',
+            rust_lib_test,
+            protocol : 'rust',
+        )
+        ```
+
+        This is all fine, but not very DRY. This method makes it much easier
+        to define rust tests:
+
+        ```meson
+        rust = import('unstable-rust')
+
+        rust_lib = static_library(
+            'rust_lib',
+            sources,
+        )
+
+        rust.test('rust_lib_test', rust_lib)
+        ```
+        """
+        name = args0
+        base_target: BuildTarget = args1
+        if not base_target.uses_rust():
+            raise InterpreterException('Second positional argument to rustmod.test() must be a rust based target')
+        extra_args = kwargs'args'
+
+        # Delete any arguments we don't want passed
+        if '--test' in extra_args:
+            mlog.warning('Do not add --test to rustmod.test arguments')
+            extra_args.remove('--test')
+        if '--format' in extra_args:
+            mlog.warning('Do not add --format to rustmod.test arguments')
+            i = extra_args.index('--format')
+            # Also delete the argument to --format
+            del extra_argsi + 1
+            del extra_argsi
+        for i, a in enumerate(extra_args):
+            if isinstance(a, str) and a.startswith('--format='):
+                del extra_argsi
+                break
+
+        # We need to cast here, as currently these don't have protocol in them, but test itself does.
+        tkwargs = T.cast('_kwargs.FuncTest', kwargs.copy())
+
+        tkwargs'args' = extra_args + '--test', '--format', 'pretty'
+        tkwargs'protocol' = 'rust'
+
+        new_target_kwargs = base_target.kwargs.copy()
+        # Don't mutate the shallow copied list, instead replace it with a new
+        # one
+        new_target_kwargs'rust_args' = new_target_kwargs.get('rust_args', ) + '--test'
+        new_target_kwargs'install' = False
+        new_target_kwargs'dependencies' = new_target_kwargs.get('dependencies', ) + kwargs'dependencies'
+
+        sources = T.cast('T.ListSourceOutputs', base_target.sources.copy())
+        sources.extend(base_target.generated)
+
+        new_target = Executable(
+            name, base_target.subdir, state.subproject, base_target.for_machine,
+            sources, base_target.structured_sources,
+            base_target.objects, base_target.environment, base_target.compilers,
+            new_target_kwargs
+        )
+
+        test = self.interpreter.make_test(
+            self.interpreter.current_node, (name, new_target), tkwargs)
+
+        return ModuleReturnValue(None, new_target, test)
+
+    @noPosargs
+    @typed_kwargs(
+        'rust.bindgen',
+        KwargInfo('c_args', ContainerTypeInfo(list, str), default=, listify=True),
+        KwargInfo('args', ContainerTypeInfo(list, str), default=, listify=True),
+        KwargInfo(
+            'input',
+            ContainerTypeInfo(list, (File, GeneratedList, BuildTarget, BothLibraries, ExtractedObjects, CustomTargetIndex, CustomTarget, str), allow_empty=False),
+            default=,
+            listify=True,
+            required=True,
+        ),
+        INCLUDE_DIRECTORIES.evolve(feature_validator=include_dir_string_new),
+        OUTPUT_KW,
+        DEPENDENCIES_KW.evolve(since='1.0.0'),
+    )
+    def bindgen(self, state: ModuleState, args: T.List, kwargs: FuncBindgen) -> ModuleReturnValue:
+        """Wrapper around bindgen to simplify it's use.
+
+        The main thing this simplifies is the use of `include_directory`
+        objects, instead of having to pass a plethora of `-I` arguments.
+        """
+        header, *_deps = self.interpreter.source_strings_to_files(kwargs'input')
+
+        # Split File and Target dependencies to add pass to CustomTarget
+        depends: T.ListSourceOutputs = 
+        depend_files: T.ListFile = 
+        for d in _deps:
+            if isinstance(d, File):
+                depend_files.append(d)
+            else:
+                depends.append(d)
+
+        clang_args: T.Liststr = 
+        for i in state.process_include_dirs(kwargs'include_directories'):
+            # bindgen always uses clang, so it's safe to hardcode -I here
+            clang_args.extend(f'-I{x}' for x in i.to_string_list(
+                state.environment.get_source_dir(), state.environment.get_build_dir()))
+
+        for de in kwargs'dependencies':
+            for i in de.get_include_dirs():
+                clang_args.extend(f'-I{x}' for x in i.to_string_list(
+                    state.environment.get_source_dir(), state.environment.get_build_dir()))
+            clang_args.extend(de.get_all_compile_args())
+            for s in de.get_sources():
+                if isinstance(s, File):
+                    depend_files.append(s)
+                elif isinstance(s, CustomTarget):
+                    depends.append(s)
+
+        if self._bindgen_bin is None:
+            self._bindgen_bin = state.find_program('bindgen')
+
+        name: str
+        if isinstance(header, File):
+            name = header.fname
+        elif isinstance(header, (BuildTarget, BothLibraries, ExtractedObjects, StructuredSources)):
+            raise InterpreterException('bindgen source file must be a C header, not an object or build target')
+        else:
+            name = header.get_outputs()0
+
+        cmd = self._bindgen_bin.get_command() + \
+            
+                '@INPUT@', '--output',
+                os.path.join(state.environment.build_dir, '@OUTPUT@')
+             + \
+            kwargs'args' + '--' + kwargs'c_args' + clang_args + \
+            '-MD', '-MQ', '@INPUT@', '-MF', '@DEPFILE@'
+
+        target = CustomTarget(
+            f'rustmod-bindgen-{name}'.replace('/', '_'),
+            state.subdir,
+            state.subproject,
+            state.environment,
+            cmd,
+            header,
+            kwargs'output',
+            depfile='@PLAINNAME@.d',
+            extra_depends=depends,
+            depend_files=depend_files,
+            backend=state.backend,
+        )
+
+        return ModuleReturnValue(target, target)
+
+
+def initialize(interp: Interpreter) -> RustModule:
+    return RustModule(interp)

_service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/modules/simd.py Added

@@ -0,0 +1,88 @@
+# Copyright 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.
+from __future__ import annotations
+
+from .. import mesonlib, compilers, mlog
+from .. import build
+
+from . import ExtensionModule, ModuleInfo
+
+class SimdModule(ExtensionModule):
+
+    INFO = ModuleInfo('SIMD', '0.42.0', unstable=True)
+
+    def __init__(self, interpreter):
+        super().__init__(interpreter)
+        # FIXME add Altivec and AVX512.
+        self.isets = ('mmx',
+                      'sse',
+                      'sse2',
+                      'sse3',
+                      'ssse3',
+                      'sse41',
+                      'sse42',
+                      'avx',
+                      'avx2',
+                      'neon',
+                      )
+        self.methods.update({
+            'check': self.check,
+        })
+
+    def check(self, state, args, kwargs):
+        result = 
+        if len(args) != 1:
+            raise mesonlib.MesonException('Check requires one argument, a name prefix for checks.')
+        prefix = args0
+        if not isinstance(prefix, str):
+            raise mesonlib.MesonException('Argument must be a string.')
+        if 'compiler' not in kwargs:
+            raise mesonlib.MesonException('Must specify compiler keyword')
+        if 'sources' in kwargs:
+            raise mesonlib.MesonException('SIMD module does not support the "sources" keyword')
+        basic_kwargs = {}
+        for key, value in kwargs.items():
+            if key not in self.isets and key != 'compiler':
+                basic_kwargskey = value
+        compiler = kwargs'compiler'
+        if not isinstance(compiler, compilers.compilers.Compiler):
+            raise mesonlib.MesonException('Compiler argument must be a compiler object.')
+        conf = build.ConfigurationData()
+        for iset in self.isets:
+            if iset not in kwargs:
+                continue
+            iset_fname = kwargsiset # Might also be an array or Files. static_library will validate.
+            args = compiler.get_instruction_set_args(iset)
+            if args is None:
+                mlog.log('Compiler supports %s:' % iset, mlog.red('NO'))
+                continue
+            if args:
+                if not compiler.has_multi_arguments(args, state.environment)0:
+                    mlog.log('Compiler supports %s:' % iset, mlog.red('NO'))
+                    continue
+            mlog.log('Compiler supports %s:' % iset, mlog.green('YES'))
+            conf.values'HAVE_' + iset.upper() = ('1', 'Compiler supports %s.' % iset)
+            libname = prefix + '_' + iset
+            lib_kwargs = {'sources': iset_fname,
+                          }
+            lib_kwargs.update(basic_kwargs)
+            langarg_key = compiler.get_language() + '_args'
+            old_lang_args = mesonlib.extract_as_list(lib_kwargs, langarg_key)
+            all_lang_args = old_lang_args + args
+            lib_kwargslangarg_key = all_lang_args
+            result.append(self.interpreter.func_static_lib(None, libname, lib_kwargs))
+        return result, conf
+
+def initialize(*args, **kwargs):
+    return SimdModule(*args, **kwargs)

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/modules/sourceset.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/modules/sourceset.py Changed

_service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/modules/wayland.py Added

@@ -0,0 +1,160 @@
+# Copyright 2022 Mark Bolhuis <mark@bolhuis.dev>
+
+# 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.
+
+from __future__ import annotations
+import os
+import typing as T
+
+from . import ExtensionModule, ModuleReturnValue, ModuleInfo
+from ..build import CustomTarget
+from ..interpreter.type_checking import NoneType, in_set_validator
+from ..interpreterbase import typed_pos_args, typed_kwargs, KwargInfo
+from ..mesonlib import File, MesonException
+
+if T.TYPE_CHECKING:
+    from typing_extensions import Literal, TypedDict
+
+    from . import ModuleState
+    from ..build import Executable
+    from ..dependencies import Dependency
+    from ..interpreter import Interpreter
+    from ..programs import ExternalProgram
+    from ..mesonlib import FileOrString
+
+    class ScanXML(TypedDict):
+
+        public: bool
+        client: bool
+        server: bool
+        include_core_only: bool
+
+    class FindProtocol(TypedDict):
+
+        state: Literal'stable', 'staging', 'unstable'
+        version: T.Optionalint
+
+class WaylandModule(ExtensionModule):
+
+    INFO = ModuleInfo('wayland', '0.62.0', unstable=True)
+
+    def __init__(self, interpreter: Interpreter) -> None:
+        super().__init__(interpreter)
+
+        self.protocols_dep: T.OptionalDependency = None
+        self.pkgdatadir: T.Optionalstr = None
+        self.scanner_bin: T.OptionalT.UnionExternalProgram, Executable = None
+
+        self.methods.update({
+            'scan_xml': self.scan_xml,
+            'find_protocol': self.find_protocol,
+        })
+
+    @typed_pos_args('wayland.scan_xml', varargs=(str, File), min_varargs=1)
+    @typed_kwargs(
+        'wayland.scan_xml',
+        KwargInfo('public', bool, default=False),
+        KwargInfo('client', bool, default=True),
+        KwargInfo('server', bool, default=False),
+        KwargInfo('include_core_only', bool, default=True, since='0.64.0'),
+    )
+    def scan_xml(self, state: ModuleState, args: T.TupleT.ListFileOrString, kwargs: ScanXML) -> ModuleReturnValue:
+        if self.scanner_bin is None:
+            # wayland-scanner from BUILD machine must have same version as wayland
+            # libraries from HOST machine.
+            dep = state.dependency('wayland-client')
+            self.scanner_bin = state.find_tool('wayland-scanner', 'wayland-scanner', 'wayland_scanner',
+                                               wanted=dep.version)
+
+        scope = 'public' if kwargs'public' else 'private'
+        # We have to cast because mypy can't deduce these are literals
+        sides = i for i in T.cast("T.ListLiteral'client', 'server'", 'client', 'server') if kwargsi
+        if not sides:
+            raise MesonException('At least one of client or server keyword argument must be set to true.')
+
+        xml_files = self.interpreter.source_strings_to_files(args0)
+        targets: T.ListCustomTarget = 
+        for xml_file in xml_files:
+            name = os.path.splitext(os.path.basename(xml_file.fname))0
+
+            code = CustomTarget(
+                f'{name}-protocol',
+                state.subdir,
+                state.subproject,
+                state.environment,
+                self.scanner_bin, f'{scope}-code', '@INPUT@', '@OUTPUT@',
+                xml_file,
+                f'{name}-protocol.c',
+                backend=state.backend,
+            )
+            targets.append(code)
+
+            for side in sides:
+                command = self.scanner_bin, f'{side}-header', '@INPUT@', '@OUTPUT@'
+                if kwargs'include_core_only':
+                    command.append('--include-core-only')
+
+                header = CustomTarget(
+                    f'{name}-{side}-protocol',
+                    state.subdir,
+                    state.subproject,
+                    state.environment,
+                    command,
+                    xml_file,
+                    f'{name}-{side}-protocol.h',
+                    backend=state.backend,
+                )
+                targets.append(header)
+
+        return ModuleReturnValue(targets, targets)
+
+    @typed_pos_args('wayland.find_protocol', str)
+    @typed_kwargs(
+        'wayland.find_protocol',
+        KwargInfo('state', str, default='stable', validator=in_set_validator({'stable', 'staging', 'unstable'})),
+        KwargInfo('version', (int, NoneType)),
+    )
+    def find_protocol(self, state: ModuleState, args: T.Tuplestr, kwargs: FindProtocol) -> File:
+        base_name = args0
+        xml_state = kwargs'state'
+        version = kwargs'version'
+
+        if xml_state != 'stable' and version is None:
+            raise MesonException(f'{xml_state} protocols require a version number.')
+
+        if xml_state == 'stable' and version is not None:
+            raise MesonException('stable protocols do not require a version number.')
+
+        if self.protocols_dep is None:
+            self.protocols_dep = state.dependency('wayland-protocols')
+
+        if self.pkgdatadir is None:
+            self.pkgdatadir = self.protocols_dep.get_variable(pkgconfig='pkgdatadir', internal='pkgdatadir')
+
+        if xml_state == 'stable':
+            xml_name = f'{base_name}.xml'
+        elif xml_state == 'staging':
+            xml_name = f'{base_name}-v{version}.xml'
+        else:
+            xml_name = f'{base_name}-unstable-v{version}.xml'
+
+        path = os.path.join(self.pkgdatadir, xml_state, base_name, xml_name)
+
+        if not os.path.exists(path):
+            raise MesonException(f'The file {path} does not exist.')
+
+        return File.from_absolute_file(path)
+
+
+def initialize(interpreter: Interpreter) -> WaylandModule:
+    return WaylandModule(interpreter)

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/modules/windows.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/modules/windows.py Changed

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/mparser.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/mparser.py Changed

@@ -11,6 +11,7 @@
 # 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.
+from __future__ import annotations
 
 from dataclasses import dataclass
 import re
@@ -21,6 +22,8 @@
 from . import mlog
 
 if T.TYPE_CHECKING:
+    from typing_extensions import Literal
+
     from .ast import AstVisitor
 
 # This is the regex for the supported escape sequences of a regular string
@@ -175,7 +178,7 @@
                     span_end = loc
                     bytespan = (span_start, span_end)
                     match_text = mo.group()
-                    if tid == 'ignore' or tid == 'comment':
+                    if tid in {'ignore', 'comment'}:
                         break
                     elif tid == 'lparen':
                         par_count += 1
@@ -388,11 +391,11 @@
         self.right = right  # type: BaseNode
 
 class ComparisonNode(BaseNode):
-    def __init__(self, ctype: str, left: BaseNode, right: BaseNode):
+    def __init__(self, ctype: COMPARISONS, left: BaseNode, right: BaseNode):
         super().__init__(left.lineno, left.colno, left.filename)
         self.left = left    # type: BaseNode
         self.right = right  # type: BaseNode
-        self.ctype = ctype  # type: str
+        self.ctype = ctype
 
 class ArithmeticNode(BaseNode):
     def __init__(self, operation: str, left: BaseNode, right: BaseNode):
@@ -477,15 +480,19 @@
         self.trueblock = trueblock    # type: BaseNode
         self.falseblock = falseblock  # type: BaseNode
 
-comparison_map = {'equal': '==',
-                  'nequal': '!=',
-                  'lt': '<',
-                  'le': '<=',
-                  'gt': '>',
-                  'ge': '>=',
-                  'in': 'in',
-                  'notin': 'not in',
-                  }
+if T.TYPE_CHECKING:
+    COMPARISONS = Literal'==', '!=', '<', '<=', '>=', '>', 'in', 'notin'
+
+comparison_map: T.Mappingstr, COMPARISONS = {
+    'equal': '==',
+    'nequal': '!=',
+    'lt': '<',
+    'le': '<=',
+    'gt': '>',
+    'ge': '>=',
+    'in': 'in',
+    'not in': 'notin',
+}
 
 # Recursive descent parser for Meson's definition language.
 # Very basic apart from the fact that we have many precedence
@@ -525,7 +532,7 @@
             return True
         return False
 
-    def accept_any(self, tids: T.Sequencestr) -> str:
+    def accept_any(self, tids: T.Tuplestr, ...) -> str:
         tid = self.current.tid
         if tid in tids:
             self.getsym()

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/msetup.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/msetup.py Changed

@@ -11,6 +11,7 @@
 # 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.
+from __future__ import annotations
 
 import typing as T
 import time
@@ -165,7 +166,7 @@
             if not reconfigure and not wipe:
                 print('Directory already configured.\n'
                       '\nJust run your build command (e.g. ninja) and Meson will regenerate as necessary.\n'
-                      'If ninja fails, run "ninja reconfigure" or "meson --reconfigure"\n'
+                      'If ninja fails, run "ninja reconfigure" or "meson setup --reconfigure"\n'
                       'to force Meson to regenerate.\n'
                       '\nIf build failures persist, run "meson setup --wipe" to rebuild from scratch\n'
                       'using the same options as passed when configuring the build.'
@@ -231,6 +232,8 @@
         except Exception as e:
             mintro.write_meson_info_file(b, e)
             raise
+
+        cdf: T.Optionalstr = None
         try:
             dumpfile = os.path.join(env.get_scratch_dir(), 'build.dat')
             # We would like to write coredata as late as possible since we use the existence of
@@ -281,7 +284,7 @@
 
         except Exception as e:
             mintro.write_meson_info_file(b, e)
-            if 'cdf' in locals():
+            if cdf is not None:
                 old_cdf = cdf + '.prev'
                 if os.path.exists(old_cdf):
                     os.replace(old_cdf, cdf)
@@ -297,7 +300,11 @@
             if devenv:
                 b.devenv.append(devenv)
 
-def run(options: argparse.Namespace) -> int:
+def run(options: T.Unionargparse.Namespace, T.Liststr) -> int:
+    if not isinstance(options, argparse.Namespace):
+        parser = argparse.ArgumentParser()
+        add_arguments(parser)
+        options = parser.parse_args(options)
     coredata.parse_cmd_line_options(options)
     app = MesonApp(options)
     app.generate()

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/msubprojects.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/msubprojects.py Changed

@@ -15,13 +15,13 @@
 
 from . import mlog
 from .mesonlib import quiet_git, GitException, Popen_safe, MesonException, windows_proof_rmtree
-from .wrap.wrap import Resolver, WrapException, ALL_TYPES
-from .wrap import wraptool
+from .wrap.wrap import (Resolver, WrapException, ALL_TYPES, PackageDefinition,
+                        parse_patch_url, update_wrap_file, get_releases)
 
 if T.TYPE_CHECKING:
     from typing_extensions import Protocol
 
-    from .wrap.wrap import PackageDefinition
+    SubParsers = argparse._SubParsersActionargparse.ArgumentParser
 
     class Arguments(Protocol):
         sourcedir: str
@@ -35,6 +35,10 @@
         rebase: bool
         reset: bool
 
+    class UpdateWrapDBArguments(Arguments):
+        force: bool
+        releases: T.Dictstr, T.Any
+
     class CheckoutArguments(Arguments):
         b: bool
         branch_name: str
@@ -114,7 +118,7 @@
         self.wrap_resolver = copy.copy(r)
         self.wrap_resolver.dirname = os.path.join(r.subdir_root, self.wrap.directory)
         self.wrap_resolver.wrap = self.wrap
-        self.run_method: T.Callable, bool = self.options.subprojects_func.__get__(self) # type: ignore
+        self.run_method: T.Callable, bool = self.options.subprojects_func.__get__(self)
         self.log_queue: T.ListT.Tuplemlog.TV_LoggableList, T.Any = 
 
     def log(self, *args: mlog.TV_Loggable, **kwargs: T.Any) -> None:
@@ -130,29 +134,53 @@
         self.logger.done(self.wrap.name, self.log_queue)
         return result
 
-    def update_wrapdb_file(self) -> None:
+    @staticmethod
+    def pre_update_wrapdb(options: 'UpdateWrapDBArguments') -> None:
+        options.releases = get_releases(options.allow_insecure)
+
+    def update_wrapdb(self) -> bool:
+        self.log(f'Checking latest WrapDB version for {self.wrap.name}...')
+        options = T.cast('UpdateWrapDBArguments', self.options)
+
+        # Check if this wrap is in WrapDB
+        info = options.releases.get(self.wrap.name)
+        if not info:
+            self.log('  -> Wrap not found in wrapdb')
+            return True
+
+        # Determine current version
         try:
-            patch_url = self.wrap.get('patch_url')
-            branch, revision = wraptool.parse_patch_url(patch_url)
+            wrapdb_version = self.wrap.get('wrapdb_version')
+            branch, revision = wrapdb_version.split('-', 1)
         except WrapException:
-            return
-        new_branch, new_revision = wraptool.get_latest_version(self.wrap.name, self.options.allow_insecure)
+            # Fallback to parsing the patch URL to determine current version.
+            # This won't work for projects that have upstream Meson support.
+            try:
+                patch_url = self.wrap.get('patch_url')
+                branch, revision = parse_patch_url(patch_url)
+            except WrapException:
+                if not options.force:
+                    self.log('  ->', mlog.red('Could not determine current version, use --force to update any way'))
+                    return False
+                branch = revision = None
+
+        # Download latest wrap if version differs
+        latest_version = info'versions'0
+        new_branch, new_revision = latest_version.rsplit('-', 1)
         if new_branch != branch or new_revision != revision:
-            wraptool.update_wrap_file(self.wrap.filename, self.wrap.name, new_branch, new_revision, self.options.allow_insecure)
-            self.log('  -> New wrap file downloaded.')
+            filename = self.wrap.filename if self.wrap.has_wrap else f'{self.wrap.filename}.wrap'
+            update_wrap_file(filename, self.wrap.name,
+                             new_branch, new_revision,
+                             options.allow_insecure)
+            self.log('  -> New version downloaded:', mlog.blue(latest_version))
+        else:
+            self.log('  -> Already at latest version:', mlog.blue(latest_version))
+
+        return True
 
     def update_file(self) -> bool:
         options = T.cast('UpdateArguments', self.options)
-
-        self.update_wrapdb_file()
-        if not os.path.isdir(self.repo_dir):
-            # The subproject is not needed, or it is a tarball extracted in
-            # 'libfoo-1.0' directory and the version has been bumped and the new
-            # directory is 'libfoo-2.0'. In that case forcing a meson
-            # reconfigure will download and use the new tarball.
-            self.log('  -> Not used.')
-            return True
-        elif options.reset:
+        if options.reset:
             # Delete existing directory and redownload. It is possible that nothing
             # changed but we have no way to know. Hopefully tarballs are still
             # cached.
@@ -251,10 +279,6 @@
 
     def update_git(self) -> bool:
         options = T.cast('UpdateArguments', self.options)
-
-        if not os.path.isdir(self.repo_dir):
-            self.log('  -> Not used.')
-            return True
         if not os.path.exists(os.path.join(self.repo_dir, '.git')):
             if options.reset:
                 # Delete existing directory and redownload
@@ -359,9 +383,6 @@
         self.git_show()
 
     def update_hg(self) -> bool:
-        if not os.path.isdir(self.repo_dir):
-            self.log('  -> Not used.')
-            return True
         revno = self.wrap.get('revision')
         if revno.lower() == 'tip':
             # Failure to do pull is not a fatal error,
@@ -375,9 +396,6 @@
         return True
 
     def update_svn(self) -> bool:
-        if not os.path.isdir(self.repo_dir):
-            self.log('  -> Not used.')
-            return True
         revno = self.wrap.get('revision')
         _, out, _ = Popen_safe('svn', 'info', '--show-item', 'revision', self.repo_dir)
         current_revno = out
@@ -394,19 +412,28 @@
 
     def update(self) -> bool:
         self.log(f'Updating {self.wrap.name}...')
-        if self.wrap.type == 'file':
-            return self.update_file()
+        success = False
+        if not os.path.isdir(self.repo_dir):
+            self.log('  -> Not used.')
+            # It is not an error if we are updating all subprojects.
+            success = not self.options.subprojects
+        elif self.wrap.type == 'file':
+            success = self.update_file()
         elif self.wrap.type == 'git':
-            return self.update_git()
+            success = self.update_git()
         elif self.wrap.type == 'hg':
-            return self.update_hg()
+            success = self.update_hg()
         elif self.wrap.type == 'svn':
-            return self.update_svn()
+            success = self.update_svn()
         elif self.wrap.type is None:
             self.log('  -> Cannot update subproject with no wrap file')
+            # It is not an error if we are updating all subprojects.
+            success = not self.options.subprojects
         else:
             self.log('  -> Cannot update', self.wrap.type, 'subproject')
-        return True
+        if success and os.path.isdir(self.repo_dir):
+            self.wrap.update_hash_cache(self.repo_dir)
+        return success
 
     def checkout(self) -> bool:
         options = T.cast('CheckoutArguments', self.options)
@@ -588,6 +615,16 @@
     p.add_argument('subprojects', nargs='*',
                    help='List of subprojects (default: all)')
 
+def add_wrap_update_parser(subparsers: 'SubParsers') -> argparse.ArgumentParser:
+    p = subparsers.add_parser('update', help='Update wrap files from WrapDB (Since 0.63.0)')
+    p.add_argument('--force', default=False, action='store_true',
+                   help='Update wraps that does not seems to come from WrapDB')
+    add_common_arguments(p)
+    add_subprojects_argument(p)
+    p.set_defaults(subprojects_func=Runner.update_wrapdb)
+    p.set_defaults(pre_func=Runner.pre_update_wrapdb)
+    return p
+
 def add_arguments(parser: argparse.ArgumentParser) -> None:
     subparsers = parser.add_subparsers(title='Commands', dest='command')
     subparsers.required = True
@@ -666,6 +703,9 @@
     executor = ThreadPoolExecutor(options.num_processes)
     if types:
         wraps = wrap for wrap in wraps if wrap.type in types
+    pre_func = getattr(options, 'pre_func', None)
+    if pre_func:
+        pre_func(options)
     logger = Logger(len(wraps))
     for wrap in wraps:
         dirname = Path(subprojects_dir, wrap.directory).as_posix()

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/mtest.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/mtest.py Changed

@@ -13,6 +13,7 @@
 # limitations under the License.
 
 # A tool to run tests in many different ways.
+from __future__ import annotations
 
 from pathlib import Path
 from collections import deque
@@ -50,6 +51,15 @@
 from .programs import ExternalProgram
 from .backend.backends import TestProtocol, TestSerialisation
 
+if T.TYPE_CHECKING:
+    TYPE_TAPResult = T.Union'TAPParser.Test',
+                             'TAPParser.Error',
+                             'TAPParser.Version',
+                             'TAPParser.Plan',
+                             'TAPParser.UnknownLine',
+                             'TAPParser.Bailout'
+
+
 # GNU autotools interprets a return code of 77 from tests it executes to
 # mean that the test should be skipped.
 GNU_SKIP_RETURNCODE = 77
@@ -94,6 +104,9 @@
     return num_workers
 
 def add_arguments(parser: argparse.ArgumentParser) -> None:
+    parser.add_argument('--maxfail', default=0, type=int,
+                        help='Number of failing tests before aborting the '
+                        'test run. (default: 0, to disable aborting on failure)')
     parser.add_argument('--repeat', default=1, dest='repeat', type=int,
                         help='Number of times to run the tests.')
     parser.add_argument('--no-rebuild', default=False, action='store_true',
@@ -268,12 +281,6 @@
         return str(self.colorize('>>> '))
 
 
-TYPE_TAPResult = T.Union'TAPParser.Test',
-                         'TAPParser.Error',
-                         'TAPParser.Version',
-                         'TAPParser.Plan',
-                         'TAPParser.Bailout'
-
 class TAPParser:
     class Plan(T.NamedTuple):
         num_tests: int
@@ -296,6 +303,10 @@
     class Error(T.NamedTuple):
         message: str
 
+    class UnknownLine(T.NamedTuple):
+        message: str
+        lineno: int
+
     class Version(T.NamedTuple):
         version: int
 
@@ -377,7 +388,7 @@
                 self.state = self._MAIN
 
             assert self.state == self._MAIN
-            if line.startswith('#'):
+            if not line or line.startswith('#'):
                 return
 
             m = self._RE_TEST.match(line)
@@ -400,7 +411,7 @@
                     yield self.Error('more than one plan found')
                 else:
                     num_tests = int(m.group(1))
-                    skipped = (num_tests == 0)
+                    skipped = num_tests == 0
                     if m.group(2):
                         if m.group(2).upper().startswith('SKIP'):
                             if num_tests > 0:
@@ -431,6 +442,9 @@
                 else:
                     yield self.Version(version=self.version)
                 return
+
+            # unknown syntax
+            yield self.UnknownLine(line, self.lineno)
         else:
             # end of file
             if self.state == self._YAML:
@@ -670,6 +684,11 @@
                       flush=True)
                 if result.verbose or result.res.is_bad():
                     self.print_log(harness, result)
+            if result.warnings:
+                print(flush=True)
+                for w in result.warnings:
+                    print(w, flush=True)
+                print(flush=True)
             if result.verbose or result.res.is_bad():
                 print(flush=True)
 
@@ -882,7 +901,7 @@
         self._num = None       # type: T.Optionalint
         self.name = name
         self.timeout = timeout
-        self.results = list()  # type: T.ListTAPParser.Test
+        self.results =       # type: T.ListTAPParser.Test
         self.returncode = None  # type: T.Optionalint
         self.starttime = None  # type: T.Optionalfloat
         self.duration = None   # type: T.Optionalfloat
@@ -896,6 +915,7 @@
         self.junit = None      # type: T.Optionalet.ElementTree
         self.is_parallel = is_parallel
         self.verbose = verbose
+        self.warnings =      # type: T.Liststr
 
     def start(self, cmd: T.Liststr) -> None:
         self.res = TestResult.RUNNING
@@ -1038,9 +1058,13 @@
 
     async def parse(self, harness: 'TestHarness', lines: T.AsyncIteratorstr) -> None:
         res = None
+        warnings =  # type: T.ListTAPParser.UnknownLine
+        version = 12
 
         async for i in TAPParser().parse_async(lines):
-            if isinstance(i, TAPParser.Bailout):
+            if isinstance(i, TAPParser.Version):
+                version = i.version
+            elif isinstance(i, TAPParser.Bailout):
                 res = TestResult.ERROR
                 harness.log_subtest(self, i.message, res)
             elif isinstance(i, TAPParser.Test):
@@ -1048,10 +1072,23 @@
                 if i.result.is_bad():
                     res = TestResult.FAIL
                 harness.log_subtest(self, i.name or f'subtest {i.number}', i.result)
+            elif isinstance(i, TAPParser.UnknownLine):
+                warnings.append(i)
             elif isinstance(i, TAPParser.Error):
                 self.additional_error += 'TAP parsing error: ' + i.message
                 res = TestResult.ERROR
 
+        if warnings:
+            unknown = str(mlog.yellow('UNKNOWN'))
+            width = len(str(max(i.lineno for i in warnings)))
+            for w in warnings:
+                self.warnings.append(f'stdout: {w.lineno:{width}}: {unknown}: {w.message}')
+            if version > 13:
+                self.warnings.append('Unknown TAP output lines have been ignored. Please open a feature request to\n'
+                                     'implement them, or prefix them with a # if they are not TAP syntax.')
+            else:
+                self.warnings.append(str(mlog.red('ERROR')) + ': Unknown TAP output lines for a supported TAP version.\n'
+                                     'This is probably a bug in the test; if they are not TAP syntax, prefix them with a #')
         if all(t.result is TestResult.SKIP for t in self.results):
             # This includes the case where self.results is empty
             res = TestResult.SKIP
@@ -1210,8 +1247,8 @@
         self._process = p
         self.stdout = stdout
         self.stderr = stderr
-        self.stdo_task = None            # type: T.Optionalasyncio.Futurestr
-        self.stde_task = None            # type: T.Optionalasyncio.Futurestr
+        self.stdo_task: T.Optionalasyncio.TaskNone = None
+        self.stde_task: T.Optionalasyncio.TaskNone = None
         self.postwait_fn = postwait_fn   # type: T.Callable, None
         self.all_futures =             # type: T.Listasyncio.Future
         self.queue = None                # type: T.Optionalasyncio.QueueT.Optionalstr
@@ -1262,14 +1299,14 @@
 
                 # Make sure the termination signal actually kills the process
                 # group, otherwise retry with a SIGKILL.
-                with suppress(TimeoutError):
+                with suppress(asyncio.TimeoutError):
                     await asyncio.wait_for(p.wait(), timeout=0.5)
                 if p.returncode is not None:
                     return None
 
                 os.killpg(p.pid, signal.SIGKILL)
 
-            with suppress(TimeoutError):
+            with suppress(asyncio.TimeoutError):
                 await asyncio.wait_for(p.wait(), timeout=1)
             if p.returncode is not None:
                 return None
@@ -1278,7 +1315,7 @@
             # Try to kill it one last time with a direct call.
             # If the process has spawned children, they will remain around.
             p.kill()
-            with suppress(TimeoutError):
+            with suppress(asyncio.TimeoutError):
                 await asyncio.wait_for(p.wait(), timeout=1)
             if p.returncode is not None:
                 return None
@@ -1509,6 +1546,7 @@
         self.console_logger = ConsoleLogger()
         self.loggers.append(self.console_logger)
         self.need_console = False
+        self.ninja = None # type: T.Liststr
 
         self.logfile_base = None  # type: T.Optionalstr
         if self.options.logbase and not self.options.gdb:
@@ -1523,9 +1561,52 @@
             if namebase:
                 self.logfile_base += '-' + namebase.replace(' ', '_')
 
+        self.prepare_build()
+        self.load_metadata()
+
+        ss = set()
+        for t in self.tests:
+            for s in t.suite:
+                ss.add(s)
+        self.suites = list(ss)
+
+    def get_console_logger(self) -> 'ConsoleLogger':
+        assert self.console_logger
+        return self.console_logger
+
+    def prepare_build(self) -> None:
+        if self.options.no_rebuild:
+            return
+
+        if not (Path(self.options.wd) / 'build.ninja').is_file():
+            print('Only ninja backend is supported to rebuild tests before running them.')
+            # Disable, no point in trying to build anything later
+            self.options.no_rebuild = True
+            return
+
+        self.ninja = environment.detect_ninja()
+        if not self.ninja:
+            print("Can't find ninja, can't rebuild test.")
+            # If ninja can't be found return exit code 127, indicating command
+            # not found for shell, which seems appropriate here. This works
+            # nicely for `git bisect run`, telling it to abort - no point in
+            # continuing if there's no ninja.
+            sys.exit(127)
+
+    def load_metadata(self) -> None:
         startdir = os.getcwd()
         try:
             os.chdir(self.options.wd)
+
+            # Before loading build / test data, make sure that the build
+            # configuration does not need to be regenerated. This needs to
+            # happen before rebuild_deps(), because we need the correct list of
+            # tests and their dependencies to compute
+            if not self.options.no_rebuild:
+                ret = subprocess.run(self.ninja + 'build.ninja').returncode
+                if ret != 0:
+                    raise TestException(f'Could not configure {self.options.wd!r}')
+
             self.build_data = build.load(os.getcwd())
             if not self.options.setup:
                 self.options.setup = self.build_data.test_setup_default_name
@@ -1536,16 +1617,6 @@
         finally:
             os.chdir(startdir)
 
-        ss = set()
-        for t in self.tests:
-            for s in t.suite:
-                ss.add(s)
-        self.suites = list(ss)
-
-    def get_console_logger(self) -> 'ConsoleLogger':
-        assert self.console_logger
-        return self.console_logger
-
     def load_tests(self, file_name: str) -> T.ListTestSerialisation:
         datafile = Path('meson-private') / file_name
         if not datafile.is_file():
@@ -1689,7 +1760,7 @@
         tests = self.get_tests()
         if not tests:
             return 0
-        if not self.options.no_rebuild and not rebuild_deps(self.options.wd, tests):
+        if not self.options.no_rebuild and not rebuild_deps(self.ninja, self.options.wd, tests):
             # We return 125 here in case the build failed.
             # The reason is that exit code 125 tells `git bisect run` that the current
             # commit should be skipped.  Thus users can directly use `meson test` to
@@ -1868,7 +1939,7 @@
     async def _run_tests(self, runners: T.ListSingleTestRunner) -> None:
         semaphore = asyncio.Semaphore(self.options.num_processes)
         futures = deque()  # type: T.Dequeasyncio.Future
-        running_tests = dict()  # type: T.Dictasyncio.Future, str
+        running_tests = {}  # type: T.Dictasyncio.Future, str
         interrupted = False
         ctrlc_times = deque(maxlen=MAX_CTRLC)  # type: T.Dequefloat
 
@@ -1878,6 +1949,9 @@
                     return
                 res = await test.run(self)
                 self.process_test_result(res)
+                maxfail = self.options.maxfail
+                if maxfail and self.fail_count >= maxfail and res.res.is_bad():
+                    cancel_all_tests()
 
         def test_done(f: asyncio.Future) -> None:
             if not f.cancelled():
@@ -1964,25 +2038,18 @@
         print(th.get_pretty_suite(t))
     return not tests
 
-def rebuild_deps(wd: str, tests: T.ListTestSerialisation) -> bool:
+def rebuild_deps(ninja: T.Liststr, wd: str, tests: T.ListTestSerialisation) -> bool:
     def convert_path_to_target(path: str) -> str:
         path = os.path.relpath(path, wd)
         if os.sep != '/':
             path = path.replace(os.sep, '/')
         return path
 
-    if not (Path(wd) / 'build.ninja').is_file():
-        print('Only ninja backend is supported to rebuild tests before running them.')
-        return True
-
-    ninja = environment.detect_ninja()
-    if not ninja:
-        print("Can't find ninja, can't rebuild test.")
-        return False
+    assert len(ninja) > 0
 
-    depends = set()            # type: T.Setstr
-    targets = set()            # type: T.Setstr
-    intro_targets = dict()     # type: T.Dictstr, T.Liststr
+    depends = set()        # type: T.Setstr
+    targets = set()        # type: T.Setstr
+    intro_targets = {}     # type: T.Dictstr, T.Liststr
     for target in load_info_file(get_infodir(wd), kind='targets'):
         intro_targetstarget'id' = 
             convert_path_to_target(f)

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/munstable_coredata.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/munstable_coredata.py Changed

@@ -11,6 +11,7 @@
 # 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.
+from __future__ import annotations
 
 
 from . import coredata as cdata
@@ -61,17 +62,17 @@
     coredata = cdata.load(options.builddir)
     backend = coredata.get_option(OptionKey('backend'))
     for k, v in sorted(coredata.__dict__.items()):
-        if k in ('backend_options', 'base_options', 'builtins', 'compiler_options', 'user_options'):
+        if k in {'backend_options', 'base_options', 'builtins', 'compiler_options', 'user_options'}:
             # use `meson configure` to view these
             pass
-        elif k in 'install_guid', 'test_guid', 'regen_guid':
+        elif k in {'install_guid', 'test_guid', 'regen_guid'}:
             if all_backends or backend.startswith('vs'):
                 print(k + ': ' + v)
         elif k == 'target_guids':
             if all_backends or backend.startswith('vs'):
                 print(k + ':')
                 dump_guids(v)
-        elif k in 'lang_guids':
+        elif k == 'lang_guids':
             if all_backends or backend.startswith('vs') or backend == 'xcode':
                 print(k + ':')
                 dump_guids(v)
@@ -103,7 +104,7 @@
                 print('      version: ' + repr(dep.get_version()))
 
             for for_machine in iter(MachineChoice):
-                items_list = list(sorted(vfor_machine.items()))
+                items_list = sorted(vfor_machine.items())
                 if items_list:
                     print(f'Cached dependencies for {for_machine.get_lower_case_name()} machine')
                     for dep_key, deps in items_list:

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/programs.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/programs.py Changed

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/rewriter.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/rewriter.py Changed

@@ -399,7 +399,7 @@
         def check_list(name: str) -> T.ListBaseNode:
             result = 
             for i in self.interpreter.targets:
-                if name == i'name' or name == i'id':
+                if name in {i'name', i'id'}:
                     result += i
             return result
 
@@ -420,7 +420,7 @@
         if target in self.interpreter.assignments:
             node = self.interpreter.assignmentstarget
             if isinstance(node, FunctionNode):
-                if node.func_name in 'executable', 'jar', 'library', 'shared_library', 'shared_module', 'static_library', 'both_libraries':
+                if node.func_name in {'executable', 'jar', 'library', 'shared_library', 'shared_module', 'static_library', 'both_libraries'}:
                     tgt = self.interpreter.assign_valstarget
 
         return tgt
@@ -440,7 +440,7 @@
         if dependency in self.interpreter.assignments:
             node = self.interpreter.assignmentsdependency
             if isinstance(node, FunctionNode):
-                if node.func_name in 'dependency':
+                if node.func_name == 'dependency':
                     name = self.interpreter.flatten_args(node.args)0
                     dep = check_list(name)
 
@@ -884,7 +884,7 @@
         # Sort based on line and column in reversed order
         work_nodes = {'node': x, 'action': 'modify'} for x in self.modified_nodes
         work_nodes += {'node': x, 'action': 'rm'} for x in self.to_remove_nodes
-        work_nodes = list(sorted(work_nodes, key=lambda x: (x'node'.lineno, x'node'.colno), reverse=True))
+        work_nodes = sorted(work_nodes, key=lambda x: (x'node'.lineno, x'node'.colno), reverse=True)
         work_nodes += {'node': x, 'action': 'add'} for x in self.to_add_nodes
 
         # Generating the new replacement string
@@ -952,15 +952,15 @@
                 while rawend != '=':
                     end += 1
                 end += 1 # Handle the '='
-                while rawend in ' ', '\n', '\t':
+                while rawend in {' ', '\n', '\t'}:
                     end += 1
 
             filesi'file''raw' = raw:start + i'str' + rawend:
 
         for i in str_list:
-            if i'action' in 'modify', 'rm':
+            if i'action' in {'modify', 'rm'}:
                 remove_node(i)
-            elif i'action' in 'add':
+            elif i'action' == 'add':
                 filesi'file''raw' += i'str' + '\n'
 
         # Write the files back

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/scripts/clangformat.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/scripts/clangformat.py Changed

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/scripts/clangtidy.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/scripts/clangtidy.py Changed

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/scripts/cleantrees.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/scripts/cleantrees.py Changed

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/scripts/cmake_run_ctgt.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/scripts/cmake_run_ctgt.py Changed

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/scripts/cmd_or_ps.ps1 -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/scripts/cmd_or_ps.ps1 Changed

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/scripts/copy.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/scripts/copy.py Changed

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/scripts/coverage.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/scripts/coverage.py Changed

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/scripts/delwithsuffix.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/scripts/delwithsuffix.py Changed

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/scripts/depfixer.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/scripts/depfixer.py Changed

@@ -11,6 +11,7 @@
 # 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.
+from __future__ import annotations
 
 
 import sys
@@ -21,7 +22,7 @@
 import subprocess
 import typing as T
 
-from ..mesonlib import OrderedSet, generate_list
+from ..mesonlib import OrderedSet, generate_list, Popen_safe
 
 SHT_STRTAB = 3
 DT_NEEDED = 1
@@ -83,10 +84,8 @@
 class SectionHeader(DataSizes):
     def __init__(self, ifile: T.BinaryIO, ptrsize: int, is_le: bool) -> None:
         super().__init__(ptrsize, is_le)
-        if ptrsize == 64:
-            is_64 = True
-        else:
-            is_64 = False
+        is_64 = ptrsize == 64
+
 # Elf64_Word
         self.sh_name = struct.unpack(self.Word, ifile.read(self.WordSize))0
 # Elf64_Word
@@ -306,7 +305,7 @@
             self.bf.seek(offset)
             name = self.read_str()
             if name.startswith(prefix):
-                basename = name.split(b'/')-1
+                basename = name.rsplit(b'/', maxsplit=1)-1
                 padding = b'\0' * (len(name) - len(basename))
                 newname = basename + padding
                 assert len(newname) == len(name)
@@ -391,9 +390,9 @@
             e.fix_rpath(fname, rpath_dirs_to_remove, new_rpath)
 
 def get_darwin_rpaths_to_remove(fname: str) -> T.Liststr:
-    out = subprocess.check_output('otool', '-l', fname,
-                                  universal_newlines=True,
-                                  stderr=subprocess.DEVNULL)
+    p, out, _ = Popen_safe('otool', '-l', fname, stderr=subprocess.DEVNULL)
+    if p.returncode != 0:
+        raise subprocess.CalledProcessError(p.returncode, p.args, out)
     result = 
     current_cmd = 'FOOBAR'
     for line in out.split('\n'):
@@ -459,7 +458,7 @@
         raise SystemExit(err)
 
 def fix_jar(fname: str) -> None:
-    subprocess.check_call('jar', 'xfv', fname, 'META-INF/MANIFEST.MF')
+    subprocess.check_call('jar', 'xf', fname, 'META-INF/MANIFEST.MF')
     with open('META-INF/MANIFEST.MF', 'r+', encoding='utf-8') as f:
         lines = f.readlines()
         f.seek(0)
@@ -467,10 +466,15 @@
             if not line.startswith('Class-Path:'):
                 f.write(line)
         f.truncate()
-    subprocess.check_call('jar', 'ufm', fname, 'META-INF/MANIFEST.MF')
+    # jar -um doesn't allow removing existing attributes.  Use -uM instead,
+    # which a) removes the existing manifest from the jar and b) disables
+    # special-casing for the manifest file, so we can re-add it as a normal
+    # archive member.  This puts the manifest at the end of the jar rather
+    # than the beginning, but the spec doesn't forbid that.
+    subprocess.check_call('jar', 'ufM', fname, 'META-INF/MANIFEST.MF')
 
 def fix_rpath(fname: str, rpath_dirs_to_remove: T.Setbytes, new_rpath: T.Unionstr, bytes, final_path: str, install_name_mappings: T.Dictstr, str, verbose: bool = True) -> None:
-    global INSTALL_NAME_TOOL
+    global INSTALL_NAME_TOOL  # pylint: disable=global-statement
     # Static libraries, import libraries, debug information, headers, etc
     # never have rpaths
     # DLLs and EXE currently do not need runtime path fixing

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/scripts/dirchanger.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/scripts/dirchanger.py Changed

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/scripts/env2mfile.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/scripts/env2mfile.py Changed

@@ -17,51 +17,16 @@
 import shlex
 import typing as T
 
+from .. import envconfig
 from .. import mlog
+from ..compilers import compilers
+from ..compilers.detect import defaults as compiler_names
 
 if T.TYPE_CHECKING:
     import argparse
 
-UNIXY_ENVVARS_COMPILER = {'c': 'CC',
-                          'cpp': 'CXX',
-                          'objc': 'OBJCC',
-                          'objcpp': 'OBJCXX',
-                          'fortran': 'FC',
-                          'rust': 'RUSTC',
-                          'vala': 'VALAC',
-                          'cs': 'CSC',
-                          }
-
-UNIXY_ENVVARS_TOOLS = {'ar': 'AR',
-                       'strip': 'STRIP',
-                       'windres': 'WINDRES',
-                       'pkgconfig': 'PKG_CONFIG',
-                       'vapigen': 'VAPIGEN',
-                       'cmake': 'CMAKE',
-                       'qmake': 'QMAKE',
-                       }
-
-UNIXY_ENVVARS_FLAGS = {'c': 'CFLAGS',
-                       'cpp': 'CXXFLAGS',
-                       'objc': 'OBJCFLAGS',
-                       'objcpp': 'OBJCXXFLAGS',
-                       'fortran': 'FFLAGS',
-                       'rust': 'RUSTFLAGS',
-                       'vala': 'VALAFLAGS',
-                       'cs': 'CSFLAGS', # This one might not be standard.
-                       }
-
-TYPICAL_UNIXY_COMPILER_NAMES = {'c': 'cc', 'gcc', 'clang',
-                                'cpp': 'c++', 'g++', 'clang++',
-                                'objc': 'objc', 'clang',
-                                'objcpp': 'objcpp', 'clang++',
-                                'fortran': 'gfortran',
-                                }
-
-LANGS_USING_CPPFLAGS = {'c', 'cpp', 'objc', 'objcxx'}
-
 def has_for_build() -> bool:
-    for cenv in UNIXY_ENVVARS_COMPILER.values():
+    for cenv in envconfig.ENV_VAR_COMPILER_MAP.values():
         if os.environ.get(cenv + '_FOR_BUILD'):
             return True
     return False
@@ -93,6 +58,7 @@
         self.properties: T.Dictstr, T.Unionstr, T.Liststr = {}
         self.compile_args: T.Dictstr, T.Liststr = {}
         self.link_args: T.Dictstr, T.Liststr = {}
+        self.cmake: T.Dictstr, T.Unionstr, T.Liststr = {}
 
         self.system: T.Optionalstr = None
         self.cpu: T.Optionalstr = None
@@ -119,12 +85,15 @@
             return f
     raise ValueError("%s not found on $PATH" % program)
 
-def write_args_line(ofile: T.TextIO, name: str, args: T.Liststr) -> None:
+def write_args_line(ofile: T.TextIO, name: str, args: T.Unionstr, T.Liststr) -> None:
     if len(args) == 0:
         return
-    ostr = name + ' = '
-    ostr += ', '.join("'" + i + "'" for i in args)
-    ostr += '\n'
+    if isinstance(args, str):
+        ostr = name + "= '" + args + "'\n"
+    else:
+        ostr = name + ' = '
+        ostr += ', '.join("'" + i + "'" for i in args)
+        ostr += '\n'
     ofile.write(ostr)
 
 def get_args_from_envvars(infos: MachineInfo) -> None:
@@ -162,10 +131,24 @@
     if objcpp_link_args:
         infos.link_args'objcpp' = objcpp_link_args
 
-cpu_family_map = dict(mips64el="mips64",
-                      i686='x86')
-cpu_map = dict(armhf="arm7hlf",
-               mips64el="mips64",)
+cpu_family_map = {
+    'mips64el': 'mips64',
+    'i686': 'x86',
+}
+cpu_map = {
+    'armhf': 'arm7hlf',
+    'mips64el': 'mips64'
+}
+
+def deb_detect_cmake(infos: MachineInfo, data: T.Dictstr, str) -> None:
+    system_name_map = {'linux': 'Linux', 'kfreebsd': 'kFreeBSD', 'hurd': 'GNU'}
+    system_processor_map = {'arm': 'armv7l', 'mips64el': 'mips64', 'powerpc64le': 'ppc64le'}
+
+    infos.cmake"CMAKE_C_COMPILER" = infos.compilers'c'
+    infos.cmake"CMAKE_CXX_COMPILER" = infos.compilers'cpp'
+    infos.cmake"CMAKE_SYSTEM_NAME" = system_name_mapdata'DEB_HOST_ARCH_OS'
+    infos.cmake"CMAKE_SYSTEM_PROCESSOR" = system_processor_map.get(data'DEB_HOST_GNU_CPU',
+                                                                     data'DEB_HOST_GNU_CPU')
 
 def deb_compiler_lookup(infos: MachineInfo, compilerstems: T.ListT.Tuplestr, str, host_arch: str, gccsuffix: str) -> None:
     for langname, stem in compilerstems:
@@ -211,6 +194,11 @@
     infos.binaries'objcopy' = locate_path("%s-objcopy" % host_arch)
     infos.binaries'ld' = locate_path("%s-ld" % host_arch)
     try:
+        infos.binaries'cmake' = locate_path("cmake")
+        deb_detect_cmake(infos, data)
+    except ValueError:
+        pass
+    try:
         infos.binaries'pkgconfig' = locate_path("%s-pkg-config" % host_arch)
     except ValueError:
         pass # pkg-config is optional
@@ -228,7 +216,7 @@
 
 def write_machine_file(infos: MachineInfo, ofilename: str, write_system_info: bool) -> None:
     tmpfilename = ofilename + '~'
-    with open(tmpfilename, 'w') as ofile:
+    with open(tmpfilename, 'w', encoding='utf-8') as ofile:
         ofile.write('binaries\n')
         ofile.write('# Compilers\n')
         for langname in sorted(infos.compilers.keys()):
@@ -250,8 +238,16 @@
                 write_args_line(ofile, lang + '_args', infos.compile_argslang)
             if lang in infos.link_args:
                 write_args_line(ofile, lang + '_link_args', infos.link_argslang)
+        for k, v in infos.properties.items():
+            write_args_line(ofile, k, v)
         ofile.write('\n')
 
+        if infos.cmake:
+            ofile.write('cmake\n\n')
+            for k, v in infos.cmake.items():
+                write_args_line(ofile, k, v)
+            ofile.write('\n')
+
         if write_system_info:
             ofile.write('host_machine\n')
             ofile.write(f"cpu = '{infos.cpu}'\n")
@@ -262,8 +258,8 @@
 
 def detect_language_args_from_envvars(langname: str, envvar_suffix: str = '') -> T.TupleT.Liststr, T.Liststr:
     ldflags = tuple(shlex.split(os.environ.get('LDFLAGS' + envvar_suffix, '')))
-    compile_args = shlex.split(os.environ.get(UNIXY_ENVVARS_FLAGSlangname + envvar_suffix, ''))
-    if langname in LANGS_USING_CPPFLAGS:
+    compile_args = shlex.split(os.environ.get(compilers.CFLAGS_MAPPINGlangname + envvar_suffix, ''))
+    if langname in compilers.LANGUAGES_USING_CPPFLAGS:
         cppflags = tuple(shlex.split(os.environ.get('CPPFLAGS' + envvar_suffix, '')))
         lang_compile_args = list(cppflags) + compile_args
     else:
@@ -273,7 +269,7 @@
 
 def detect_compilers_from_envvars(envvar_suffix: str = '') -> MachineInfo:
     infos = MachineInfo()
-    for langname, envvarname in UNIXY_ENVVARS_COMPILER.items():
+    for langname, envvarname in envconfig.ENV_VAR_COMPILER_MAP.items():
         compilerstr = os.environ.get(envvarname + envvar_suffix)
         if not compilerstr:
             continue
@@ -287,7 +283,7 @@
     return infos
 
 def detect_binaries_from_envvars(infos: MachineInfo, envvar_suffix: str = '') -> None:
-    for binname, envvar_base in UNIXY_ENVVARS_TOOLS.items():
+    for binname, envvar_base in envconfig.ENV_VAR_TOOL_MAP.items():
         envvar = envvar_base + envvar_suffix
         binstr = os.environ.get(envvar)
         if binstr:
@@ -328,12 +324,14 @@
 
 def detect_missing_native_compilers(infos: MachineInfo) -> None:
     # T.Any per-platform special detection should go here.
-    for langname, exes in TYPICAL_UNIXY_COMPILER_NAMES.items():
+    for langname, exes in compiler_names.items():
+        if langname not in envconfig.ENV_VAR_COMPILER_MAP:
+            continue
         add_compiler_if_missing(infos, langname, exes)
 
 def detect_missing_native_binaries(infos: MachineInfo) -> None:
     # T.Any per-platform special detection should go here.
-    for toolname in sorted(UNIXY_ENVVARS_TOOLS.keys()):
+    for toolname in sorted(envconfig.ENV_VAR_TOOL_MAP.keys()):
         if toolname in infos.binaries:
             continue
         exe = shutil.which(toolname)

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/scripts/externalproject.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/scripts/externalproject.py Changed

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/scripts/gettext.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/scripts/gettext.py Changed

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/scripts/gtkdochelper.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/scripts/gtkdochelper.py Changed

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/scripts/hotdochelper.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/scripts/hotdochelper.py Changed

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/scripts/itstool.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/scripts/itstool.py Changed

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/scripts/meson_exe.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/scripts/meson_exe.py Changed

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/scripts/msgfmthelper.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/scripts/msgfmthelper.py Changed

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/scripts/regen_checker.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/scripts/regen_checker.py Changed

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/scripts/run_tool.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/scripts/run_tool.py Changed

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/scripts/scanbuild.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/scripts/scanbuild.py Changed

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/scripts/symbolextractor.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/scripts/symbolextractor.py Changed

@@ -19,6 +19,7 @@
 
 # This file is basically a reimplementation of
 # http://cgit.freedesktop.org/libreoffice/core/commit/?id=3213cd54b76bc80a6f0516aac75a48ff3b2ad67c
+from __future__ import annotations
 
 import typing as T
 import os, sys
@@ -53,7 +54,6 @@
         f.write(text)
 
 def print_tool_warning(tools: T.Liststr, msg: str, stderr: T.Optionalstr = None) -> None:
-    global TOOL_WARNING_FILE
     if os.path.exists(TOOL_WARNING_FILE):
         return
     m = f'{tools!r} {msg}. {RELINKING_WARNING}'
@@ -119,7 +119,7 @@
         # Store the size of symbols pointing to data objects so we relink
         # when those change, which is needed because of copy relocations
         # https://github.com/mesonbuild/meson/pull/7132#issuecomment-628353702
-        if line_split1.upper() in ('B', 'G', 'D') and len(line_split) >= 4:
+        if line_split1.upper() in {'B', 'G', 'D'} and len(line_split) >= 4:
             entry += line_split3
         result += ' '.join(entry)
     write_if_changed('\n'.join(result) + '\n', outfilename)
@@ -316,7 +316,7 @@
         dummy_syms(outfilename)
 
 def run(args: T.Liststr) -> int:
-    global TOOL_WARNING_FILE
+    global TOOL_WARNING_FILE  # pylint: disable=global-statement
     options = parser.parse_args(args)
     if len(options.args) != 4:
         print('symbolextractor.py <shared library file> <import library> <output file>')

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/scripts/tags.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/scripts/tags.py Changed

_service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/scripts/test_loaded_modules.py Added

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/scripts/uninstall.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/scripts/uninstall.py Changed

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/scripts/vcstagger.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/scripts/vcstagger.py Changed

_service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/scripts/yasm.py Added

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/templates/cpptemplates.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/templates/cpptemplates.py Changed

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/templates/cstemplates.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/templates/cstemplates.py Changed

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/templates/ctemplates.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/templates/ctemplates.py Changed

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/templates/cudatemplates.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/templates/cudatemplates.py Changed

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/templates/dlangtemplates.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/templates/dlangtemplates.py Changed

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/templates/fortrantemplates.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/templates/fortrantemplates.py Changed

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/templates/javatemplates.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/templates/javatemplates.py Changed

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/templates/mesontemplates.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/templates/mesontemplates.py Changed

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/templates/objcpptemplates.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/templates/objcpptemplates.py Changed

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/templates/objctemplates.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/templates/objctemplates.py Changed

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/templates/rusttemplates.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/templates/rusttemplates.py Changed

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/templates/samplefactory.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/templates/samplefactory.py Changed

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/templates/sampleimpl.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/templates/sampleimpl.py Changed

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/templates/valatemplates.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/templates/valatemplates.py Changed

_service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/utils Added

_service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/utils/__init__.py Added

_service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/utils/core.py Added

@@ -0,0 +1,151 @@
+# Copyright 2012-2022 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.
+
+"""
+Contains the strict minimum to run scripts.
+
+When the backend needs to call back into Meson during compilation for running
+scripts or wrapping commands, it is important to load as little python modules
+as possible for performance reasons.
+"""
+
+from __future__ import annotations
+from dataclasses import dataclass
+import os
+import abc
+import typing as T
+
+if T.TYPE_CHECKING:
+    from typing_extensions import Literal
+    from ..mparser import BaseNode
+    from . import programs
+
+    EnvInitValueType = T.Dictstr, T.Unionstr, T.Liststr
+
+
+class MesonException(Exception):
+    '''Exceptions thrown by Meson'''
+
+    def __init__(self, *args: object, file: T.Optionalstr = None,
+                 lineno: T.Optionalint = None, colno: T.Optionalint = None):
+        super().__init__(*args)
+        self.file = file
+        self.lineno = lineno
+        self.colno = colno
+
+    @classmethod
+    def from_node(cls, *args: object, node: BaseNode) -> MesonException:
+        """Create a MesonException with location data from a BaseNode
+
+        :param node: A BaseNode to set location data from
+        :return: A Meson Exception instance
+        """
+        return cls(*args, file=node.filename, lineno=node.lineno, colno=node.colno)
+
+class MesonBugException(MesonException):
+    '''Exceptions thrown when there is a clear Meson bug that should be reported'''
+
+    def __init__(self, msg: str, file: T.Optionalstr = None,
+                 lineno: T.Optionalint = None, colno: T.Optionalint = None):
+        super().__init__(msg + '\n\n    This is a Meson bug and should be reported!',
+                         file=file, lineno=lineno, colno=colno)
+
+class HoldableObject(metaclass=abc.ABCMeta):
+    ''' Dummy base class for all objects that can be
+        held by an interpreter.baseobjects.ObjectHolder '''
+
+class EnvironmentVariables(HoldableObject):
+    def __init__(self, values: T.OptionalEnvInitValueType = None,
+                 init_method: Literal'set', 'prepend', 'append' = 'set', separator: str = os.pathsep) -> None:
+        self.envvars: T.ListT.TupleT.CallableT.Dictstr, str, str, T.Liststr, str, str, str, T.Liststr, str = 
+        # The set of all env vars we have operations for. Only used for self.has_name()
+        self.varnames: T.Setstr = set()
+
+        if values:
+            init_func = getattr(self, init_method)
+            for name, value in values.items():
+                v = value if isinstance(value, list) else value
+                init_func(name, v, separator)
+
+    def __repr__(self) -> str:
+        repr_str = "<{0}: {1}>"
+        return repr_str.format(self.__class__.__name__, self.envvars)
+
+    def hash(self, hasher: T.Any):
+        myenv = self.get_env({})
+        for key in sorted(myenv.keys()):
+            hasher.update(bytes(key, encoding='utf-8'))
+            hasher.update(b',')
+            hasher.update(bytes(myenvkey, encoding='utf-8'))
+            hasher.update(b';')
+
+    def has_name(self, name: str) -> bool:
+        return name in self.varnames
+
+    def get_names(self) -> T.Setstr:
+        return self.varnames
+
+    def set(self, name: str, values: T.Liststr, separator: str = os.pathsep) -> None:
+        self.varnames.add(name)
+        self.envvars.append((self._set, name, values, separator))
+
+    def append(self, name: str, values: T.Liststr, separator: str = os.pathsep) -> None:
+        self.varnames.add(name)
+        self.envvars.append((self._append, name, values, separator))
+
+    def prepend(self, name: str, values: T.Liststr, separator: str = os.pathsep) -> None:
+        self.varnames.add(name)
+        self.envvars.append((self._prepend, name, values, separator))
+
+    @staticmethod
+    def _set(env: T.Dictstr, str, name: str, values: T.Liststr, separator: str, default_value: T.Optionalstr) -> str:
+        return separator.join(values)
+
+    @staticmethod
+    def _append(env: T.Dictstr, str, name: str, values: T.Liststr, separator: str, default_value: T.Optionalstr) -> str:
+        curr = env.get(name, default_value)
+        return separator.join(values if curr is None else curr + values)
+
+    @staticmethod
+    def _prepend(env: T.Dictstr, str, name: str, values: T.Liststr, separator: str, default_value: T.Optionalstr) -> str:
+        curr = env.get(name, default_value)
+        return separator.join(values if curr is None else values + curr)
+
+    def get_env(self, full_env: T.MutableMappingstr, str, dump: bool = False) -> T.Dictstr, str:
+        env = full_env.copy()
+        for method, name, values, separator in self.envvars:
+            default_value = f'${name}' if dump else None
+            envname = method(env, name, values, separator, default_value)
+        return env
+
+
+@dataclass(eq=False)
+class ExecutableSerialisation:
+
+    # XXX: should capture and feed default to False, instead of None?
+
+    cmd_args: T.Liststr
+    env: T.OptionalEnvironmentVariables = None
+    exe_wrapper: T.Optional'programs.ExternalProgram' = None
+    workdir: T.Optionalstr = None
+    extra_paths: T.OptionalT.List = None
+    capture: T.Optionalbool = None
+    feed: T.Optionalbool = None
+    tag: T.Optionalstr = None
+    verbose: bool = False
+
+    def __post_init__(self) -> None:
+        self.pickled = False
+        self.skip_if_destdir = False
+        self.subproject = ''

_service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/utils/platform.py Added

@@ -0,0 +1,38 @@
+# SPDX-license-identifier: Apache-2.0
+# Copyright 2012-2021 The Meson development team
+# Copyright © 2021 Intel Corporation
+
+# 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.
+from __future__ import annotations
+
+"""base classes providing no-op functionality.."""
+
+import os
+import typing as T
+
+from .. import mlog
+
+__all__ = 'BuildDirLock'
+
+# This needs to be inherited by the specific implementations to make type
+# checking happy
+class BuildDirLock:
+
+    def __init__(self, builddir: str) -> None:
+        self.lockfilename = os.path.join(builddir, 'meson-private/meson.lock')
+
+    def __enter__(self) -> None:
+        mlog.debug('Calling the no-op version of BuildDirLock')
+
+    def __exit__(self, *args: T.Any) -> None:
+        pass

_service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/utils/posix.py Added

@@ -0,0 +1,43 @@
+# SPDX-license-identifier: Apache-2.0
+# Copyright 2012-2021 The Meson development team
+# Copyright © 2021 Intel Corporation
+
+# 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.
+from __future__ import annotations
+
+"""Posix specific implementations of mesonlib functionality."""
+
+import fcntl
+import typing as T
+
+from .universal import MesonException
+from .platform import BuildDirLock as BuildDirLockBase
+
+__all__ = 'BuildDirLock'
+
+class BuildDirLock(BuildDirLockBase):
+
+    def __enter__(self) -> None:
+        self.lockfile = open(self.lockfilename, 'w', encoding='utf-8')
+        try:
+            fcntl.flock(self.lockfile, fcntl.LOCK_EX | fcntl.LOCK_NB)
+        except (BlockingIOError, PermissionError):
+            self.lockfile.close()
+            raise MesonException('Some other Meson process is already using this build directory. Exiting.')
+        except OSError as e:
+            self.lockfile.close()
+            raise MesonException(f'Failed to lock the build directory: {e.strerror}')
+
+    def __exit__(self, *args: T.Any) -> None:
+        fcntl.flock(self.lockfile, fcntl.LOCK_UN)
+        self.lockfile.close()

_service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/utils/universal.py Added

@@ -0,0 +1,2365 @@
+# Copyright 2012-2020 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.
+
+"""A library of random helper functionality."""
+
+from __future__ import annotations
+from pathlib import Path
+import argparse
+import enum
+import sys
+import stat
+import time
+import abc
+import platform, subprocess, operator, os, shlex, shutil, re
+import collections
+from functools import lru_cache, wraps, total_ordering
+from itertools import tee
+from tempfile import TemporaryDirectory, NamedTemporaryFile
+import typing as T
+import textwrap
+import copy
+import pickle
+import errno
+
+from mesonbuild import mlog
+from .core import MesonException, HoldableObject
+
+if T.TYPE_CHECKING:
+    from typing_extensions import Literal
+
+    from .._typing import ImmutableListProtocol
+    from ..build import ConfigurationData
+    from ..coredata import KeyedOptionDictType, UserOption
+    from ..compilers.compilers import Compiler
+
+FileOrString = T.Union'File', str
+
+_T = T.TypeVar('_T')
+_U = T.TypeVar('_U')
+
+__all__ = 
+    'GIT',
+    'python_command',
+    'project_meson_versions',
+    'SecondLevelHolder',
+    'File',
+    'FileMode',
+    'GitException',
+    'LibType',
+    'MachineChoice',
+    'EnvironmentException',
+    'FileOrString',
+    'GitException',
+    'OptionKey',
+    'dump_conf_header',
+    'OptionOverrideProxy',
+    'OptionType',
+    'OrderedSet',
+    'PerMachine',
+    'PerMachineDefaultable',
+    'PerThreeMachine',
+    'PerThreeMachineDefaultable',
+    'ProgressBar',
+    'RealPathAction',
+    'TemporaryDirectoryWinProof',
+    'Version',
+    'check_direntry_issues',
+    'classify_unity_sources',
+    'current_vs_supports_modules',
+    'darwin_get_object_archs',
+    'default_libdir',
+    'default_libexecdir',
+    'default_prefix',
+    'default_datadir',
+    'default_includedir',
+    'default_infodir',
+    'default_localedir',
+    'default_mandir',
+    'default_sbindir',
+    'default_sysconfdir',
+    'detect_subprojects',
+    'detect_vcs',
+    'do_conf_file',
+    'do_conf_str',
+    'do_replacement',
+    'exe_exists',
+    'expand_arguments',
+    'extract_as_list',
+    'first',
+    'generate_list',
+    'get_compiler_for_source',
+    'get_filenames_templates_dict',
+    'get_variable_regex',
+    'get_wine_shortpath',
+    'git',
+    'has_path_sep',
+    'is_aix',
+    'is_android',
+    'is_ascii_string',
+    'is_cygwin',
+    'is_debianlike',
+    'is_dragonflybsd',
+    'is_freebsd',
+    'is_haiku',
+    'is_hurd',
+    'is_irix',
+    'is_linux',
+    'is_netbsd',
+    'is_openbsd',
+    'is_osx',
+    'is_qnx',
+    'is_sunos',
+    'is_windows',
+    'is_wsl',
+    'iter_regexin_iter',
+    'join_args',
+    'listify',
+    'partition',
+    'path_is_in_root',
+    'pickle_load',
+    'Popen_safe',
+    'quiet_git',
+    'quote_arg',
+    'relative_to_if_possible',
+    'relpath',
+    'replace_if_different',
+    'run_once',
+    'get_meson_command',
+    'set_meson_command',
+    'split_args',
+    'stringlistify',
+    'substitute_values',
+    'substring_is_in_list',
+    'typeslistify',
+    'verbose_git',
+    'version_compare',
+    'version_compare_condition_with_min',
+    'version_compare_many',
+    'search_version',
+    'windows_detect_native_arch',
+    'windows_proof_rm',
+    'windows_proof_rmtree',
+
+
+
+# TODO: this is such a hack, this really should be either in coredata or in the
+# interpreter
+# {subproject: project_meson_version}
+project_meson_versions = collections.defaultdict(str)  # type: T.DefaultDictstr, str
+
+
+from glob import glob
+
+if os.path.basename(sys.executable) == 'meson.exe':
+    # In Windows and using the MSI installed executable.
+    python_command = sys.executable, 'runpython'
+else:
+    python_command = sys.executable
+_meson_command: T.Optional'ImmutableListProtocolstr' = None
+
+
+class EnvironmentException(MesonException):
+    '''Exceptions thrown while processing and creating the build environment'''
+
+class GitException(MesonException):
+    def __init__(self, msg: str, output: T.Optionalstr = None):
+        super().__init__(msg)
+        self.output = output.strip() if output else ''
+
+GIT = shutil.which('git')
+def git(cmd: T.Liststr, workingdir: T.Unionstr, bytes, os.PathLike, check: bool = False, **kwargs: T.Any) -> T.Tuplesubprocess.Popen, str, str:
+    cmd = GIT + cmd
+    p, o, e = Popen_safe(cmd, cwd=workingdir, **kwargs)
+    if check and p.returncode != 0:
+        raise GitException('Git command failed: ' + str(cmd), e)
+    return p, o, e
+
+def quiet_git(cmd: T.Liststr, workingdir: T.Unionstr, bytes, os.PathLike, check: bool = False) -> T.Tuplebool, str:
+    if not GIT:
+        m = 'Git program not found.'
+        if check:
+            raise GitException(m)
+        return False, m
+    p, o, e = git(cmd, workingdir, check)
+    if p.returncode != 0:
+        return False, e
+    return True, o
+
+def verbose_git(cmd: T.Liststr, workingdir: T.Unionstr, bytes, os.PathLike, check: bool = False) -> bool:
+    if not GIT:
+        m = 'Git program not found.'
+        if check:
+            raise GitException(m)
+        return False
+    p, _, _ = git(cmd, workingdir, check, stdout=None, stderr=None)
+    return p.returncode == 0
+
+def set_meson_command(mainfile: str) -> None:
+    global _meson_command  # pylint: disable=global-statement
+    # On UNIX-like systems `meson` is a Python script
+    # On Windows `meson` and `meson.exe` are wrapper exes
+    if not mainfile.endswith('.py'):
+        _meson_command = mainfile
+    elif os.path.isabs(mainfile) and mainfile.endswith('mesonmain.py'):
+        # Can't actually run meson with an absolute path to mesonmain.py, it must be run as -m mesonbuild.mesonmain
+        _meson_command = python_command + '-m', 'mesonbuild.mesonmain'
+    else:
+        # Either run uninstalled, or full path to meson-script.py
+        _meson_command = python_command + mainfile
+    # We print this value for unit tests.
+    if 'MESON_COMMAND_TESTS' in os.environ:
+        mlog.log(f'meson_command is {_meson_command!r}')
+
+
+def get_meson_command() -> T.Optional'ImmutableListProtocolstr':
+    return _meson_command
+
+
+def is_ascii_string(astring: T.Unionstr, bytes) -> bool:
+    try:
+        if isinstance(astring, str):
+            astring.encode('ascii')
+        elif isinstance(astring, bytes):
+            astring.decode('ascii')
+    except UnicodeDecodeError:
+        return False
+    return True
+
+
+def check_direntry_issues(direntry_array: T.UnionT.IterableT.Unionstr, bytes, str, bytes) -> None:
+    import locale
+    # Warn if the locale is not UTF-8. This can cause various unfixable issues
+    # such as os.stat not being able to decode filenames with unicode in them.
+    # There is no way to reset both the preferred encoding and the filesystem
+    # encoding, so we can just warn about it.
+    e = locale.getpreferredencoding()
+    if e.upper() != 'UTF-8' and not is_windows():
+        if isinstance(direntry_array, (str, bytes)):
+            direntry_array = direntry_array
+        for de in direntry_array:
+            if is_ascii_string(de):
+                continue
+            mlog.warning(textwrap.dedent(f'''
+                You are using {e!r} which is not a Unicode-compatible
+                locale but you are trying to access a file system entry called {de!r} which is
+                not pure ASCII. This may cause problems.
+                '''), file=sys.stderr)
+
+class SecondLevelHolder(HoldableObject, metaclass=abc.ABCMeta):
+    ''' A second level object holder. The primary purpose
+        of such objects is to hold multiple objects with one
+        default option. '''
+
+    @abc.abstractmethod
+    def get_default_object(self) -> HoldableObject: ...
+
+class FileMode:
+    # The first triad is for owner permissions, the second for group permissions,
+    # and the third for others (everyone else).
+    # For the 1st character:
+    #  'r' means can read
+    #  '-' means not allowed
+    # For the 2nd character:
+    #  'w' means can write
+    #  '-' means not allowed
+    # For the 3rd character:
+    #  'x' means can execute
+    #  's' means can execute and setuid/setgid is set (owner/group triads only)
+    #  'S' means cannot execute and setuid/setgid is set (owner/group triads only)
+    #  't' means can execute and sticky bit is set ("others" triads only)
+    #  'T' means cannot execute and sticky bit is set ("others" triads only)
+    #  '-' means none of these are allowed
+    #
+    # The meanings of 'rwx' perms is not obvious for directories; see:
+    # https://www.hackinglinuxexposed.com/articles/20030424.html
+    #
+    # For information on this notation such as setuid/setgid/sticky bits, see:
+    # https://en.wikipedia.org/wiki/File_system_permissions#Symbolic_notation
+    symbolic_perms_regex = re.compile('r-w-xsS-' # Owner perms
+                                      'r-w-xsS-' # Group perms
+                                      'r-w-xtT-') # Others perms
+
+    def __init__(self, perms: T.Optionalstr = None, owner: T.Unionstr, int, None = None,
+                 group: T.Unionstr, int, None = None):
+        self.perms_s = perms
+        self.perms = self.perms_s_to_bits(perms)
+        self.owner = owner
+        self.group = group
+
+    def __repr__(self) -> str:
+        ret = '<FileMode: {!r} owner={} group={}'
+        return ret.format(self.perms_s, self.owner, self.group)
+
+    @classmethod
+    def perms_s_to_bits(cls, perms_s: T.Optionalstr) -> int:
+        '''
+        Does the opposite of stat.filemode(), converts strings of the form
+        'rwxr-xr-x' to st_mode enums which can be passed to os.chmod()
+        '''
+        if perms_s is None:
+            # No perms specified, we will not touch the permissions
+            return -1
+        eg = 'rwxr-xr-x'
+        if not isinstance(perms_s, str):
+            raise MesonException(f'Install perms must be a string. For example, {eg!r}')
+        if len(perms_s) != 9 or not cls.symbolic_perms_regex.match(perms_s):
+            raise MesonException(f'File perms {perms_s!r} must be exactly 9 chars. For example, {eg!r}')
+        perms = 0
+        # Owner perms
+        if perms_s0 == 'r':
+            perms |= stat.S_IRUSR
+        if perms_s1 == 'w':
+            perms |= stat.S_IWUSR
+        if perms_s2 == 'x':
+            perms |= stat.S_IXUSR
+        elif perms_s2 == 'S':
+            perms |= stat.S_ISUID
+        elif perms_s2 == 's':
+            perms |= stat.S_IXUSR
+            perms |= stat.S_ISUID
+        # Group perms
+        if perms_s3 == 'r':
+            perms |= stat.S_IRGRP
+        if perms_s4 == 'w':
+            perms |= stat.S_IWGRP
+        if perms_s5 == 'x':
+            perms |= stat.S_IXGRP
+        elif perms_s5 == 'S':
+            perms |= stat.S_ISGID
+        elif perms_s5 == 's':
+            perms |= stat.S_IXGRP
+            perms |= stat.S_ISGID
+        # Others perms
+        if perms_s6 == 'r':
+            perms |= stat.S_IROTH
+        if perms_s7 == 'w':
+            perms |= stat.S_IWOTH
+        if perms_s8 == 'x':
+            perms |= stat.S_IXOTH
+        elif perms_s8 == 'T':
+            perms |= stat.S_ISVTX
+        elif perms_s8 == 't':
+            perms |= stat.S_IXOTH
+            perms |= stat.S_ISVTX
+        return perms
+
+dot_C_dot_H_warning = """You are using .C or .H files in your project. This is deprecated.
+         Currently, Meson treats this as C++ code, but they
+            used to be treated as C code.
+         Note that the situation is a bit more complex if you are using the
+         Visual Studio compiler, as it treats .C files as C code, unless you add
+         the /TP compiler flag, but this is unreliable.
+         See https://github.com/mesonbuild/meson/pull/8747 for the discussions."""
+class File(HoldableObject):
+    def __init__(self, is_built: bool, subdir: str, fname: str):
+        if fname.endswith(".C") or fname.endswith(".H"):
+            mlog.warning(dot_C_dot_H_warning, once=True)
+        self.is_built = is_built
+        self.subdir = subdir
+        self.fname = fname
+        self.hash = hash((is_built, subdir, fname))
+
+    def __str__(self) -> str:
+        return self.relative_name()
+
+    def __repr__(self) -> str:
+        ret = '<File: {0}'
+        if not self.is_built:
+            ret += ' (not built)'
+        ret += '>'
+        return ret.format(self.relative_name())
+
+    @staticmethod
+    @lru_cache(maxsize=None)
+    def from_source_file(source_root: str, subdir: str, fname: str) -> 'File':
+        if not os.path.isfile(os.path.join(source_root, subdir, fname)):
+            raise MesonException(f'File {fname} does not exist.')
+        return File(False, subdir, fname)
+
+    @staticmethod
+    def from_built_file(subdir: str, fname: str) -> 'File':
+        return File(True, subdir, fname)
+
+    @staticmethod
+    def from_built_relative(relative: str) -> 'File':
+        dirpart, fnamepart = os.path.split(relative)
+        return File(True, dirpart, fnamepart)
+
+    @staticmethod
+    def from_absolute_file(fname: str) -> 'File':
+        return File(False, '', fname)
+
+    @lru_cache(maxsize=None)
+    def rel_to_builddir(self, build_to_src: str) -> str:
+        if self.is_built:
+            return self.relative_name()
+        else:
+            return os.path.join(build_to_src, self.subdir, self.fname)
+
+    @lru_cache(maxsize=None)
+    def absolute_path(self, srcdir: str, builddir: str) -> str:
+        absdir = srcdir
+        if self.is_built:
+            absdir = builddir
+        return os.path.join(absdir, self.relative_name())
+
+    @property
+    def suffix(self) -> str:
+        return os.path.splitext(self.fname)11:.lower()
+
+    def endswith(self, ending: T.Unionstr, T.Tuplestr, ...) -> bool:
+        return self.fname.endswith(ending)
+
+    def split(self, s: str, maxsplit: int = -1) -> T.Liststr:
+        return self.fname.split(s, maxsplit=maxsplit)
+
+    def rsplit(self, s: str, maxsplit: int = -1) -> T.Liststr:
+        return self.fname.rsplit(s, maxsplit=maxsplit)
+
+    def __eq__(self, other: object) -> bool:
+        if not isinstance(other, File):
+            return NotImplemented
+        if self.hash != other.hash:
+            return False
+        return (self.fname, self.subdir, self.is_built) == (other.fname, other.subdir, other.is_built)
+
+    def __hash__(self) -> int:
+        return self.hash
+
+    @lru_cache(maxsize=None)
+    def relative_name(self) -> str:
+        return os.path.join(self.subdir, self.fname)
+
+
+def get_compiler_for_source(compilers: T.Iterable'Compiler', src: 'FileOrString') -> 'Compiler':
+    """Given a set of compilers and a source, find the compiler for that source type."""
+    for comp in compilers:
+        if comp.can_compile(src):
+            return comp
+    raise MesonException(f'No specified compiler can handle file {src!s}')
+
+
+def classify_unity_sources(compilers: T.Iterable'Compiler', sources: T.Sequence'FileOrString') -> T.Dict'Compiler', T.List'FileOrString':
+    compsrclist: T.Dict'Compiler', T.List'FileOrString' = {}
+    for src in sources:
+        comp = get_compiler_for_source(compilers, src)
+        if comp not in compsrclist:
+            compsrclistcomp = src
+        else:
+            compsrclistcomp.append(src)
+    return compsrclist
+
+
+class MachineChoice(enum.IntEnum):
+
+    """Enum class representing one of the two abstract machine names used in
+    most places: the build, and host, machines.
+    """
+
+    BUILD = 0
+    HOST = 1
+
+    def get_lower_case_name(self) -> str:
+        return PerMachine('build', 'host')self
+
+    def get_prefix(self) -> str:
+        return PerMachine('build.', '')self
+
+
+class PerMachine(T.Generic_T):
+    def __init__(self, build: _T, host: _T) -> None:
+        self.build = build
+        self.host = host
+
+    def __getitem__(self, machine: MachineChoice) -> _T:
+        return {
+            MachineChoice.BUILD:  self.build,
+            MachineChoice.HOST:   self.host,
+        }machine
+
+    def __setitem__(self, machine: MachineChoice, val: _T) -> None:
+        setattr(self, machine.get_lower_case_name(), val)
+
+    def miss_defaulting(self) -> "PerMachineDefaultableT.Optional_T":
+        """Unset definition duplicated from their previous to None
+
+        This is the inverse of ''default_missing''. By removing defaulted
+        machines, we can elaborate the original and then redefault them and thus
+        avoid repeating the elaboration explicitly.
+        """
+        unfreeze = PerMachineDefaultable() # type: PerMachineDefaultableT.Optional_T
+        unfreeze.build = self.build
+        unfreeze.host = self.host
+        if unfreeze.host == unfreeze.build:
+            unfreeze.host = None
+        return unfreeze
+
+    def __repr__(self) -> str:
+        return f'PerMachine({self.build!r}, {self.host!r})'
+
+
+class PerThreeMachine(PerMachine_T):
+    """Like `PerMachine` but includes `target` too.
+
+    It turns out just one thing do we need track the target machine. There's no
+    need to computer the `target` field so we don't bother overriding the
+    `__getitem__`/`__setitem__` methods.
+    """
+    def __init__(self, build: _T, host: _T, target: _T) -> None:
+        super().__init__(build, host)
+        self.target = target
+
+    def miss_defaulting(self) -> "PerThreeMachineDefaultableT.Optional_T":
+        """Unset definition duplicated from their previous to None
+
+        This is the inverse of ''default_missing''. By removing defaulted
+        machines, we can elaborate the original and then redefault them and thus
+        avoid repeating the elaboration explicitly.
+        """
+        unfreeze = PerThreeMachineDefaultable() # type: PerThreeMachineDefaultableT.Optional_T
+        unfreeze.build = self.build
+        unfreeze.host = self.host
+        unfreeze.target = self.target
+        if unfreeze.target == unfreeze.host:
+            unfreeze.target = None
+        if unfreeze.host == unfreeze.build:
+            unfreeze.host = None
+        return unfreeze
+
+    def matches_build_machine(self, machine: MachineChoice) -> bool:
+        return self.build == selfmachine
+
+    def __repr__(self) -> str:
+        return f'PerThreeMachine({self.build!r}, {self.host!r}, {self.target!r})'
+
+
+class PerMachineDefaultable(PerMachineT.Optional_T):
+    """Extends `PerMachine` with the ability to default from `None`s.
+    """
+    def __init__(self, build: T.Optional_T = None, host: T.Optional_T = None) -> None:
+        super().__init__(build, host)
+
+    def default_missing(self) -> "PerMachine_T":
+        """Default host to build
+
+        This allows just specifying nothing in the native case, and just host in the
+        cross non-compiler case.
+        """
+        freeze = PerMachine(self.build, self.host)
+        if freeze.host is None:
+            freeze.host = freeze.build
+        return freeze
+
+    def __repr__(self) -> str:
+        return f'PerMachineDefaultable({self.build!r}, {self.host!r})'
+
+    @classmethod
+    def default(cls, is_cross: bool, build: _T, host: _T) -> PerMachine_T:
+        """Easy way to get a defaulted value
+
+        This allows simplifying the case where you can control whether host and
+        build are separate or not with a boolean. If the is_cross value is set
+        to true then the optional host value will be used, otherwise the host
+        will be set to the build value.
+        """
+        m = cls(build)
+        if is_cross:
+            m.host = host
+        return m.default_missing()
+
+
+class PerThreeMachineDefaultable(PerMachineDefaultable, PerThreeMachineT.Optional_T):
+    """Extends `PerThreeMachine` with the ability to default from `None`s.
+    """
+    def __init__(self) -> None:
+        PerThreeMachine.__init__(self, None, None, None)
+
+    def default_missing(self) -> "PerThreeMachineT.Optional_T":
+        """Default host to build and target to host.
+
+        This allows just specifying nothing in the native case, just host in the
+        cross non-compiler case, and just target in the native-built
+        cross-compiler case.
+        """
+        freeze = PerThreeMachine(self.build, self.host, self.target)
+        if freeze.host is None:
+            freeze.host = freeze.build
+        if freeze.target is None:
+            freeze.target = freeze.host
+        return freeze
+
+    def __repr__(self) -> str:
+        return f'PerThreeMachineDefaultable({self.build!r}, {self.host!r}, {self.target!r})'
+
+
+def is_sunos() -> bool:
+    return platform.system().lower() == 'sunos'
+
+
+def is_osx() -> bool:
+    return platform.system().lower() == 'darwin'
+
+
+def is_linux() -> bool:
+    return platform.system().lower() == 'linux'
+
+
+def is_android() -> bool:
+    return platform.system().lower() == 'android'
+
+
+def is_haiku() -> bool:
+    return platform.system().lower() == 'haiku'
+
+
+def is_openbsd() -> bool:
+    return platform.system().lower() == 'openbsd'
+
+
+def is_windows() -> bool:
+    platname = platform.system().lower()
+    return platname == 'windows'
+
+def is_wsl() -> bool:
+    return is_linux() and 'microsoft' in platform.release().lower()
+
+def is_cygwin() -> bool:
+    return sys.platform == 'cygwin'
+
+
+def is_debianlike() -> bool:
+    return os.path.isfile('/etc/debian_version')
+
+
+def is_dragonflybsd() -> bool:
+    return platform.system().lower() == 'dragonfly'
+
+
+def is_netbsd() -> bool:
+    return platform.system().lower() == 'netbsd'
+
+
+def is_freebsd() -> bool:
+    return platform.system().lower() == 'freebsd'
+
+def is_irix() -> bool:
+    return platform.system().startswith('irix')
+
+def is_hurd() -> bool:
+    return platform.system().lower() == 'gnu'
+
+def is_qnx() -> bool:
+    return platform.system().lower() == 'qnx'
+
+def is_aix() -> bool:
+    return platform.system().lower() == 'aix'
+
+def exe_exists(arglist: T.Liststr) -> bool:
+    try:
+        if subprocess.run(arglist, timeout=10).returncode == 0:
+            return True
+    except (FileNotFoundError, subprocess.TimeoutExpired):
+        pass
+    return False
+
+
+@lru_cache(maxsize=None)
+def darwin_get_object_archs(objpath: str) -> 'ImmutableListProtocolstr':
+    '''
+    For a specific object (executable, static library, dylib, etc), run `lipo`
+    to fetch the list of archs supported by it. Supports both thin objects and
+    'fat' objects.
+    '''
+    _, stdo, stderr = Popen_safe('lipo', '-info', objpath)
+    if not stdo:
+        mlog.debug(f'lipo {objpath}: {stderr}')
+        return None
+    stdo = stdo.rsplit(': ', 1)1
+    # Convert from lipo-style archs to meson-style CPUs
+    stdo = stdo.replace('i386', 'x86')
+    stdo = stdo.replace('arm64', 'aarch64')
+    stdo = stdo.replace('ppc7400', 'ppc')
+    stdo = stdo.replace('ppc970', 'ppc')
+    # Add generic name for armv7 and armv7s
+    if 'armv7' in stdo:
+        stdo += ' arm'
+    return stdo.split()
+
+def windows_detect_native_arch() -> str:
+    """
+    The architecture of Windows itself: x86, amd64 or arm64
+    """
+    if sys.platform != 'win32':
+        return ''
+    try:
+        import ctypes
+        process_arch = ctypes.c_ushort()
+        native_arch = ctypes.c_ushort()
+        kernel32 = ctypes.windll.kernel32
+        process = ctypes.c_void_p(kernel32.GetCurrentProcess())
+        # This is the only reliable way to detect an arm system if we are an x86/x64 process being emulated
+        if kernel32.IsWow64Process2(process, ctypes.byref(process_arch), ctypes.byref(native_arch)):
+            # https://docs.microsoft.com/en-us/windows/win32/sysinfo/image-file-machine-constants
+            if native_arch.value == 0x8664:
+                return 'amd64'
+            elif native_arch.value == 0x014C:
+                return 'x86'
+            elif native_arch.value == 0xAA64:
+                return 'arm64'
+            elif native_arch.value == 0x01C4:
+                return 'arm'
+    except (OSError, AttributeError):
+        pass
+    # These env variables are always available. See:
+    # https://msdn.microsoft.com/en-us/library/aa384274(VS.85).aspx
+    # https://blogs.msdn.microsoft.com/david.wang/2006/03/27/howto-detect-process-bitness/
+    arch = os.environ.get('PROCESSOR_ARCHITEW6432', '').lower()
+    if not arch:
+        try:
+            # If this doesn't exist, something is messing with the environment
+            arch = os.environ'PROCESSOR_ARCHITECTURE'.lower()
+        except KeyError:
+            raise EnvironmentException('Unable to detect native OS architecture')
+    return arch
+
+def detect_vcs(source_dir: T.Unionstr, Path) -> T.OptionalT.Dictstr, str:
+    vcs_systems = 
+        {
+            'name': 'git',
+            'cmd': 'git',
+            'repo_dir': '.git',
+            'get_rev': 'git describe --dirty=+',
+            'rev_regex': '(.*)',
+            'dep': '.git/logs/HEAD'
+        },
+        {
+            'name': 'mercurial',
+            'cmd': 'hg',
+            'repo_dir': '.hg',
+            'get_rev': 'hg id -i',
+            'rev_regex': '(.*)',
+            'dep': '.hg/dirstate'
+        },
+        {
+            'name': 'subversion',
+            'cmd': 'svn',
+            'repo_dir': '.svn',
+            'get_rev': 'svn info',
+            'rev_regex': 'Revision: (.*)',
+            'dep': '.svn/wc.db'
+        },
+        {
+            'name': 'bazaar',
+            'cmd': 'bzr',
+            'repo_dir': '.bzr',
+            'get_rev': 'bzr revno',
+            'rev_regex': '(.*)',
+            'dep': '.bzr'
+        },
+    
+    if isinstance(source_dir, str):
+        source_dir = Path(source_dir)
+
+    parent_paths_and_self = collections.deque(source_dir.parents)
+    # Prepend the source directory to the front so we can check it;
+    # source_dir.parents doesn't include source_dir
+    parent_paths_and_self.appendleft(source_dir)
+    for curdir in parent_paths_and_self:
+        for vcs in vcs_systems:
+            if Path.is_dir(curdir.joinpath(vcs'repo_dir')) and shutil.which(vcs'cmd'):
+                vcs'wc_dir' = str(curdir)
+                return vcs
+    return None
+
+def current_vs_supports_modules() -> bool:
+    vsver = os.environ.get('VSCMD_VER', '')
+    nums = vsver.split('.', 2)
+    major = int(nums0)
+    if major >= 17:
+        return True
+    if major == 16 and int(nums1) >= 10:
+        return True
+    return vsver.startswith('16.9.0') and '-pre.' in vsver
+
+# a helper class which implements the same version ordering as RPM
+class Version:
+    def __init__(self, s: str) -> None:
+        self._s = s
+
+        # split into numeric, alphabetic and non-alphanumeric sequences
+        sequences1 = re.finditer(r'(\d+|a-zA-Z+|^a-zA-Z\d+)', s)
+
+        # non-alphanumeric separators are discarded
+        sequences2 = m for m in sequences1 if not re.match(r'^a-zA-Z\d+', m.group(1))
+
+        # numeric sequences are converted from strings to ints
+        sequences3 = int(m.group(1)) if m.group(1).isdigit() else m.group(1) for m in sequences2
+
+        self._v = sequences3
+
+    def __str__(self) -> str:
+        return '{} (V={})'.format(self._s, str(self._v))
+
+    def __repr__(self) -> str:
+        return f'<Version: {self._s}>'
+
+    def __lt__(self, other: object) -> bool:
+        if isinstance(other, Version):
+            return self.__cmp(other, operator.lt)
+        return NotImplemented
+
+    def __gt__(self, other: object) -> bool:
+        if isinstance(other, Version):
+            return self.__cmp(other, operator.gt)
+        return NotImplemented
+
+    def __le__(self, other: object) -> bool:
+        if isinstance(other, Version):
+            return self.__cmp(other, operator.le)
+        return NotImplemented
+
+    def __ge__(self, other: object) -> bool:
+        if isinstance(other, Version):
+            return self.__cmp(other, operator.ge)
+        return NotImplemented
+
+    def __eq__(self, other: object) -> bool:
+        if isinstance(other, Version):
+            return self._v == other._v
+        return NotImplemented
+
+    def __ne__(self, other: object) -> bool:
+        if isinstance(other, Version):
+            return self._v != other._v
+        return NotImplemented
+
+    def __cmp(self, other: 'Version', comparator: T.CallableT.Any, T.Any, bool) -> bool:
+        # compare each sequence in order
+        for ours, theirs in zip(self._v, other._v):
+            # sort a non-digit sequence before a digit sequence
+            ours_is_int = isinstance(ours, int)
+            theirs_is_int = isinstance(theirs, int)
+            if ours_is_int != theirs_is_int:
+                return comparator(ours_is_int, theirs_is_int)
+
+            if ours != theirs:
+                return comparator(ours, theirs)
+
+        # if equal length, all components have matched, so equal
+        # otherwise, the version with a suffix remaining is greater
+        return comparator(len(self._v), len(other._v))
+
+
+def _version_extract_cmpop(vstr2: str) -> T.TupleT.CallableT.Any, T.Any, bool, str:
+    if vstr2.startswith('>='):
+        cmpop = operator.ge
+        vstr2 = vstr22:
+    elif vstr2.startswith('<='):
+        cmpop = operator.le
+        vstr2 = vstr22:
+    elif vstr2.startswith('!='):
+        cmpop = operator.ne
+        vstr2 = vstr22:
+    elif vstr2.startswith('=='):
+        cmpop = operator.eq
+        vstr2 = vstr22:
+    elif vstr2.startswith('='):
+        cmpop = operator.eq
+        vstr2 = vstr21:
+    elif vstr2.startswith('>'):
+        cmpop = operator.gt
+        vstr2 = vstr21:
+    elif vstr2.startswith('<'):
+        cmpop = operator.lt
+        vstr2 = vstr21:
+    else:
+        cmpop = operator.eq
+
+    return (cmpop, vstr2)
+
+
+def version_compare(vstr1: str, vstr2: str) -> bool:
+    (cmpop, vstr2) = _version_extract_cmpop(vstr2)
+    return cmpop(Version(vstr1), Version(vstr2))
+
+
+def version_compare_many(vstr1: str, conditions: T.Unionstr, T.Iterablestr) -> T.Tuplebool, T.Liststr, T.Liststr:
+    if isinstance(conditions, str):
+        conditions = conditions
+    found = 
+    not_found = 
+    for req in conditions:
+        if not version_compare(vstr1, req):
+            not_found.append(req)
+        else:
+            found.append(req)
+    return not not_found, not_found, found
+
+
+# determine if the minimum version satisfying the condition |condition| exceeds
+# the minimum version for a feature |minimum|
+def version_compare_condition_with_min(condition: str, minimum: str) -> bool:
+    if condition.startswith('>='):
+        cmpop = operator.le
+        condition = condition2:
+    elif condition.startswith('<='):
+        return False
+    elif condition.startswith('!='):
+        return False
+    elif condition.startswith('=='):
+        cmpop = operator.le
+        condition = condition2:
+    elif condition.startswith('='):
+        cmpop = operator.le
+        condition = condition1:
+    elif condition.startswith('>'):
+        cmpop = operator.lt
+        condition = condition1:
+    elif condition.startswith('<'):
+        return False
+    else:
+        cmpop = operator.le
+
+    # Declaring a project(meson_version: '>=0.46') and then using features in
+    # 0.46.0 is valid, because (knowing the meson versioning scheme) '0.46.0' is
+    # the lowest version which satisfies the constraint '>=0.46'.
+    #
+    # But this will fail here, because the minimum version required by the
+    # version constraint ('0.46') is strictly less (in our version comparison)
+    # than the minimum version needed for the feature ('0.46.0').
+    #
+    # Map versions in the constraint of the form '0.46' to '0.46.0', to embed
+    # this knowledge of the meson versioning scheme.
+    condition = condition.strip()
+    if re.match(r'^\d+.\d+$', condition):
+        condition += '.0'
+
+    return T.cast('bool', cmpop(Version(minimum), Version(condition)))
+
+def search_version(text: str) -> str:
+    # Usually of the type 4.1.4 but compiler output may contain
+    # stuff like this:
+    # (Sourcery CodeBench Lite 2014.05-29) 4.8.3 20140320 (prerelease)
+    # Limiting major version number to two digits seems to work
+    # thus far. When we get to GCC 100, this will break, but
+    # if we are still relevant when that happens, it can be
+    # considered an achievement in itself.
+    #
+    # This regex is reaching magic levels. If it ever needs
+    # to be updated, do not complexify but convert to something
+    # saner instead.
+    # We'll demystify it a bit with a verbose definition.
+    version_regex = re.compile(r"""
+    (?<!                # Zero-width negative lookbehind assertion
+        (
+            \d          # One digit
+            | \.        # Or one period
+        )               # One occurrence
+    )
+    # Following pattern must not follow a digit or period
+    (
+        \d{1,2}         # One or two digits
+        (
+            \.\d+       # Period and one or more digits
+        )+              # One or more occurrences
+        (
+            -a-zA-Z0-9+   # Hyphen and one or more alphanumeric
+        )?              # Zero or one occurrence
+    )                   # One occurrence
+    """, re.VERBOSE)
+    match = version_regex.search(text)
+    if match:
+        return match.group(0)
+
+    # try a simpler regex that has like "blah 2020.01.100 foo" or "blah 2020.01 foo"
+    version_regex = re.compile(r"(\d{1,4}\.\d{1,4}\.?\d{0,4})")
+    match = version_regex.search(text)
+    if match:
+        return match.group(0)
+
+    return 'unknown version'
+
+
+def default_libdir() -> str:
+    if is_debianlike():
+        try:
+            pc = subprocess.Popen('dpkg-architecture', '-qDEB_HOST_MULTIARCH',
+                                  stdout=subprocess.PIPE,
+                                  stderr=subprocess.DEVNULL)
+            (stdo, _) = pc.communicate()
+            if pc.returncode == 0:
+                archpath = stdo.decode().strip()
+                return 'lib/' + archpath
+        except Exception:
+            pass
+    if is_freebsd() or is_irix():
+        return 'lib'
+    if os.path.isdir('/usr/lib64') and not os.path.islink('/usr/lib64'):
+        return 'lib64'
+    return 'lib'
+
+
+def default_libexecdir() -> str:
+    if is_haiku():
+        return 'lib'
+    # There is no way to auto-detect this, so it must be set at build time
+    return 'libexec'
+
+
+def default_prefix() -> str:
+    if is_windows():
+        return 'c:/'
+    if is_haiku():
+        return '/boot/system/non-packaged'
+    return '/usr/local'
+
+
+def default_datadir() -> str:
+    if is_haiku():
+        return 'data'
+    return 'share'
+
+
+def default_includedir() -> str:
+    if is_haiku():
+        return 'develop/headers'
+    return 'include'
+
+
+def default_infodir() -> str:
+    if is_haiku():
+        return 'documentation/info'
+    return 'share/info'
+
+
+def default_localedir() -> str:
+    if is_haiku():
+        return 'data/locale'
+    return 'share/locale'
+
+
+def default_mandir() -> str:
+    if is_haiku():
+        return 'documentation/man'
+    return 'share/man'
+
+
+def default_sbindir() -> str:
+    if is_haiku():
+        return 'bin'
+    return 'sbin'
+
+
+def default_sysconfdir() -> str:
+    if is_haiku():
+        return 'settings'
+    return 'etc'
+
+
+def has_path_sep(name: str, sep: str = '/\\') -> bool:
+    'Checks if any of the specified @sep path separators are in @name'
+    for each in sep:
+        if each in name:
+            return True
+    return False
+
+
+if is_windows():
+    # shlex.split is not suitable for splitting command line on Window (https://bugs.python.org/issue1724822);
+    # shlex.quote is similarly problematic. Below are "proper" implementations of these functions according to
+    # https://docs.microsoft.com/en-us/cpp/c-language/parsing-c-command-line-arguments and
+    # https://blogs.msdn.microsoft.com/twistylittlepassagesallalike/2011/04/23/everyone-quotes-command-line-arguments-the-wrong-way/
+
+    _whitespace = ' \t\n\r'
+    _find_unsafe_char = re.compile(fr'{_whitespace}"').search
+
+    def quote_arg(arg: str) -> str:
+        if arg and not _find_unsafe_char(arg):
+            return arg
+
+        result = '"'
+        num_backslashes = 0
+        for c in arg:
+            if c == '\\':
+                num_backslashes += 1
+            else:
+                if c == '"':
+                    # Escape all backslashes and the following double quotation mark
+                    num_backslashes = num_backslashes * 2 + 1
+
+                result += num_backslashes * '\\' + c
+                num_backslashes = 0
+
+        # Escape all backslashes, but let the terminating double quotation
+        # mark we add below be interpreted as a metacharacter
+        result += (num_backslashes * 2) * '\\' + '"'
+        return result
+
+    def split_args(cmd: str) -> T.Liststr:
+        result = 
+        arg = ''
+        num_backslashes = 0
+        num_quotes = 0
+        in_quotes = False
+        for c in cmd:
+            if c == '\\':
+                num_backslashes += 1
+            else:
+                if c == '"' and not num_backslashes % 2:
+                    # unescaped quote, eat it
+                    arg += (num_backslashes // 2) * '\\'
+                    num_quotes += 1
+                    in_quotes = not in_quotes
+                elif c in _whitespace and not in_quotes:
+                    if arg or num_quotes:
+                        # reached the end of the argument
+                        result.append(arg)
+                        arg = ''
+                        num_quotes = 0
+                else:
+                    if c == '"':
+                        # escaped quote
+                        num_backslashes = (num_backslashes - 1) // 2
+
+                    arg += num_backslashes * '\\' + c
+
+                num_backslashes = 0
+
+        if arg or num_quotes:
+            result.append(arg)
+
+        return result
+else:
+    def quote_arg(arg: str) -> str:
+        return shlex.quote(arg)
+
+    def split_args(cmd: str) -> T.Liststr:
+        return shlex.split(cmd)
+
+
+def join_args(args: T.Iterablestr) -> str:
+    return ' '.join(quote_arg(x) for x in args)
+
+
+def do_replacement(regex: T.Patternstr, line: str,
+                   variable_format: Literal'meson', 'cmake', 'cmake@',
+                   confdata: T.UnionT.Dictstr, T.Tuplestr, T.Optionalstr, 'ConfigurationData') -> T.Tuplestr, T.Setstr:
+    missing_variables = set()  # type: T.Setstr
+    if variable_format == 'cmake':
+        start_tag = '${'
+        backslash_tag = '\\${'
+    else:
+        start_tag = '@'
+        backslash_tag = '\\@'
+
+    def variable_replace(match: T.Matchstr) -> str:
+        # Pairs of escape characters before '@' or '\@'
+        if match.group(0).endswith('\\'):
+            num_escapes = match.end(0) - match.start(0)
+            return '\\' * (num_escapes // 2)
+        # Single escape character and '@'
+        elif match.group(0) == backslash_tag:
+            return start_tag
+        # Template variable to be replaced
+        else:
+            varname = match.group(1)
+            var_str = ''
+            if varname in confdata:
+                var, _ = confdata.get(varname)
+                if isinstance(var, str):
+                    var_str = var
+                elif isinstance(var, int):
+                    var_str = str(var)
+                else:
+                    msg = f'Tried to replace variable {varname!r} value with ' \
+                          f'something other than a string or int: {var!r}'
+                    raise MesonException(msg)
+            else:
+                missing_variables.add(varname)
+            return var_str
+    return re.sub(regex, variable_replace, line), missing_variables
+
+def do_define(regex: T.Patternstr, line: str, confdata: 'ConfigurationData',
+              variable_format: Literal'meson', 'cmake', 'cmake@') -> str:
+    def get_cmake_define(line: str, confdata: 'ConfigurationData') -> str:
+        arr = line.split()
+        define_value = 
+        for token in arr2::
+            try:
+                (v, desc) = confdata.get(token)
+                define_value += str(v)
+            except KeyError:
+                define_value += token
+        return ' '.join(define_value)
+
+    arr = line.split()
+    if variable_format == 'meson' and len(arr) != 2:
+        raise MesonException('#mesondefine does not contain exactly two tokens: %s' % line.strip())
+
+    varname = arr1
+    try:
+        (v, desc) = confdata.get(varname)
+    except KeyError:
+        return '/* #undef %s */\n' % varname
+    if isinstance(v, bool):
+        if v:
+            return '#define %s\n' % varname
+        else:
+            return '#undef %s\n' % varname
+    elif isinstance(v, int):
+        return '#define %s %d\n' % (varname, v)
+    elif isinstance(v, str):
+        if variable_format == 'meson':
+            result = v
+        else:
+            result = get_cmake_define(line, confdata)
+        result = f'#define {varname} {result}\n'
+        (result, missing_variable) = do_replacement(regex, result, variable_format, confdata)
+        return result
+    else:
+        raise MesonException('#mesondefine argument "%s" is of unknown type.' % varname)
+
+def get_variable_regex(variable_format: Literal'meson', 'cmake', 'cmake@' = 'meson') -> T.Patternstr:
+    # Only allow (a-z, A-Z, 0-9, _, -) as valid characters for a define
+    # Also allow escaping '@' with '\@'
+    if variable_format in {'meson', 'cmake@'}:
+        regex = re.compile(r'(?:\\\\)+(?=\\?@)|\\@|@(-a-zA-Z0-9_+)@')
+    else:
+        regex = re.compile(r'(?:\\\\)+(?=\\?\$)|\\\${|\${(-a-zA-Z0-9_+)}')
+    return regex
+
+def do_conf_str(src: str, data: list, confdata: 'ConfigurationData',
+                variable_format: Literal'meson', 'cmake', 'cmake@',
+                encoding: str = 'utf-8') -> T.TupleT.Liststr, T.Setstr, bool:
+    def line_is_valid(line: str, variable_format: str) -> bool:
+        if variable_format == 'meson':
+            if '#cmakedefine' in line:
+                return False
+        else: # cmake format
+            if '#mesondefine' in line:
+                return False
+        return True
+
+    regex = get_variable_regex(variable_format)
+
+    search_token = '#mesondefine'
+    if variable_format != 'meson':
+        search_token = '#cmakedefine'
+
+    result = 
+    missing_variables = set()
+    # Detect when the configuration data is empty and no tokens were found
+    # during substitution so we can warn the user to use the `copy:` kwarg.
+    confdata_useless = not confdata.keys()
+    for line in data:
+        if line.startswith(search_token):
+            confdata_useless = False
+            line = do_define(regex, line, confdata, variable_format)
+        else:
+            if not line_is_valid(line, variable_format):
+                raise MesonException(f'Format error in {src}: saw "{line.strip()}" when format set to "{variable_format}"')
+            line, missing = do_replacement(regex, line, variable_format, confdata)
+            missing_variables.update(missing)
+            if missing:
+                confdata_useless = False
+        result.append(line)
+
+    return result, missing_variables, confdata_useless
+
+def do_conf_file(src: str, dst: str, confdata: 'ConfigurationData',
+                 variable_format: Literal'meson', 'cmake', 'cmake@',
+                 encoding: str = 'utf-8') -> T.TupleT.Setstr, bool:
+    try:
+        with open(src, encoding=encoding, newline='') as f:
+            data = f.readlines()
+    except Exception as e:
+        raise MesonException(f'Could not read input file {src}: {e!s}')
+
+    (result, missing_variables, confdata_useless) = do_conf_str(src, data, confdata, variable_format, encoding)
+    dst_tmp = dst + '~'
+    try:
+        with open(dst_tmp, 'w', encoding=encoding, newline='') as f:
+            f.writelines(result)
+    except Exception as e:
+        raise MesonException(f'Could not write output file {dst}: {e!s}')
+    shutil.copymode(src, dst_tmp)
+    replace_if_different(dst, dst_tmp)
+    return missing_variables, confdata_useless
+
+CONF_C_PRELUDE = '''/*
+ * Autogenerated by the Meson build system.
+ * Do not edit, your changes will be lost.
+ */
+
+#pragma once
+
+'''
+
+CONF_NASM_PRELUDE = '''; Autogenerated by the Meson build system.
+; Do not edit, your changes will be lost.
+
+'''
+
+def dump_conf_header(ofilename: str, cdata: 'ConfigurationData', output_format: T.Literal'c', 'nasm') -> None:
+    if output_format == 'c':
+        prelude = CONF_C_PRELUDE
+        prefix = '#'
+    else:
+        prelude = CONF_NASM_PRELUDE
+        prefix = '%'
+
+    ofilename_tmp = ofilename + '~'
+    with open(ofilename_tmp, 'w', encoding='utf-8') as ofile:
+        ofile.write(prelude)
+        for k in sorted(cdata.keys()):
+            (v, desc) = cdata.get(k)
+            if desc:
+                if output_format == 'c':
+                    ofile.write('/* %s */\n' % desc)
+                elif output_format == 'nasm':
+                    for line in desc.split('\n'):
+                        ofile.write('; %s\n' % line)
+            if isinstance(v, bool):
+                if v:
+                    ofile.write(f'{prefix}define {k}\n\n')
+                else:
+                    ofile.write(f'{prefix}undef {k}\n\n')
+            elif isinstance(v, (int, str)):
+                ofile.write(f'{prefix}define {k} {v}\n\n')
+            else:
+                raise MesonException('Unknown data type in configuration file entry: ' + k)
+    replace_if_different(ofilename, ofilename_tmp)
+
+
+def replace_if_different(dst: str, dst_tmp: str) -> None:
+    # If contents are identical, don't touch the file to prevent
+    # unnecessary rebuilds.
+    different = True
+    try:
+        with open(dst, 'rb') as f1, open(dst_tmp, 'rb') as f2:
+            if f1.read() == f2.read():
+                different = False
+    except FileNotFoundError:
+        pass
+    if different:
+        os.replace(dst_tmp, dst)
+    else:
+        os.unlink(dst_tmp)
+
+
+def listify(item: T.Any, flatten: bool = True) -> T.ListT.Any:
+    '''
+    Returns a list with all args embedded in a list if they are not a list.
+    This function preserves order.
+    @flatten: Convert lists of lists to a flat list
+    '''
+    if not isinstance(item, list):
+        return item
+    result =   # type: T.ListT.Any
+    for i in item:
+        if flatten and isinstance(i, list):
+            result += listify(i, flatten=True)
+        else:
+            result.append(i)
+    return result
+
+
+def extract_as_list(dict_object: T.Dict_T, _U, key: _T, pop: bool = False) -> T.List_U:
+    '''
+    Extracts all values from given dict_object and listifies them.
+    '''
+    fetch: T.Callable_T, _U = dict_object.get
+    if pop:
+        fetch = dict_object.pop
+    # If there's only one key, we don't return a list with one element
+    return listify(fetch(key) or , flatten=True)
+
+
+def typeslistify(item: 'T.Union_T, T.Sequence_T',
+                 types: 'T.UnionT.Type_T, T.TupleT.Type_T') -> T.List_T:
+    '''
+    Ensure that type(@item) is one of @types or a
+    list of items all of which are of type @types
+    '''
+    if isinstance(item, types):
+        item = T.cast('T.List_T', item)
+    if not isinstance(item, list):
+        raise MesonException('Item must be a list or one of {!r}, not {!r}'.format(types, type(item)))
+    for i in item:
+        if i is not None and not isinstance(i, types):
+            raise MesonException('List item must be one of {!r}, not {!r}'.format(types, type(i)))
+    return item
+
+
+def stringlistify(item: T.UnionT.Any, T.SequenceT.Any) -> T.Liststr:
+    return typeslistify(item, str)
+
+
+def expand_arguments(args: T.Iterablestr) -> T.OptionalT.Liststr:
+    expended_args =   # type: T.Liststr
+    for arg in args:
+        if not arg.startswith('@'):
+            expended_args.append(arg)
+            continue
+
+        args_file = arg1:
+        try:
+            with open(args_file, encoding='utf-8') as f:
+                extended_args = f.read().split()
+            expended_args += extended_args
+        except Exception as e:
+            mlog.error('Expanding command line arguments:',  args_file, 'not found')
+            mlog.exception(e)
+            return None
+    return expended_args
+
+
+def partition(pred: T.Callable_T, object, iterable: T.Iterable_T) -> T.TupleT.Iterator_T, T.Iterator_T:
+    """Use a predicate to partition entries into false entries and true
+    entries.
+
+    >>> x, y = partition(is_odd, range(10))
+    >>> (list(x), list(y))
+    (0, 2, 4, 6, 8, 1, 3, 5, 7, 9)
+    """
+    t1, t2 = tee(iterable)
+    return (t for t in t1 if not pred(t)), (t for t in t2 if pred(t))
+
+
+def Popen_safe(args: T.Liststr, write: T.Optionalstr = None,
+               stdin: T.UnionT.TextIO, T.BinaryIO, int = subprocess.DEVNULL,
+               stdout: T.UnionT.TextIO, T.BinaryIO, int = subprocess.PIPE,
+               stderr: T.UnionT.TextIO, T.BinaryIO, int = subprocess.PIPE,
+               **kwargs: T.Any) -> T.Tuple'subprocess.Popenstr', str, str:
+    import locale
+    encoding = locale.getpreferredencoding()
+    # Stdin defaults to DEVNULL otherwise the command run by us here might mess
+    # up the console and ANSI colors will stop working on Windows.
+    # If write is not None, set stdin to PIPE so data can be sent.
+    if write is not None:
+        stdin = subprocess.PIPE
+
+    try:
+        if not sys.stdout.encoding or encoding.upper() != 'UTF-8':
+            p, o, e = Popen_safe_legacy(args, write=write, stdin=stdin, stdout=stdout, stderr=stderr, **kwargs)
+        else:
+            p = subprocess.Popen(args, universal_newlines=True, encoding=encoding, close_fds=False,
+                                 stdin=stdin, stdout=stdout, stderr=stderr, **kwargs)
+            o, e = p.communicate(write)
+    except OSError as oserr:
+        if oserr.errno == errno.ENOEXEC:
+            raise MesonException(f'Failed running {args0!r}, binary or interpreter not executable.\n'
+                                 'Possibly wrong architecture or the executable bit is not set.')
+        raise
+    # Sometimes the command that we run will call another command which will be
+    # without the above stdin workaround, so set the console mode again just in
+    # case.
+    mlog.setup_console()
+    return p, o, e
+
+
+def Popen_safe_legacy(args: T.Liststr, write: T.Optionalstr = None,
+                      stdin: T.UnionT.TextIO, T.BinaryIO, int = subprocess.DEVNULL,
+                      stdout: T.UnionT.TextIO, T.BinaryIO, int = subprocess.PIPE,
+                      stderr: T.UnionT.TextIO, T.BinaryIO, int = subprocess.PIPE,
+                      **kwargs: T.Any) -> T.Tuple'subprocess.Popenstr', str, str:
+    p = subprocess.Popen(args, universal_newlines=False, close_fds=False,
+                         stdin=stdin, stdout=stdout, stderr=stderr, **kwargs)
+    input_ = None  # type: T.Optionalbytes
+    if write is not None:
+        input_ = write.encode('utf-8')
+    o, e = p.communicate(input_)
+    if o is not None:
+        if sys.stdout.encoding is not None:
+            o = o.decode(encoding=sys.stdout.encoding, errors='replace').replace('\r\n', '\n')
+        else:
+            o = o.decode(errors='replace').replace('\r\n', '\n')
+    if e is not None:
+        if sys.stderr is not None and sys.stderr.encoding:
+            e = e.decode(encoding=sys.stderr.encoding, errors='replace').replace('\r\n', '\n')
+        else:
+            e = e.decode(errors='replace').replace('\r\n', '\n')
+    return p, o, e
+
+
+def iter_regexin_iter(regexiter: T.Iterablestr, initer: T.Iterablestr) -> T.Optionalstr:
+    '''
+    Takes each regular expression in @regexiter and tries to search for it in
+    every item in @initer. If there is a match, returns that match.
+    Else returns False.
+    '''
+    for regex in regexiter:
+        for ii in initer:
+            if not isinstance(ii, str):
+                continue
+            match = re.search(regex, ii)
+            if match:
+                return match.group()
+    return None
+
+
+def _substitute_values_check_errors(command: T.Liststr, values: T.Dictstr, T.Unionstr, T.Liststr) -> None:
+    # Error checking
+    inregex = '@INPUT(0-9+)?@', '@PLAINNAME@', '@BASENAME@'  # type: T.Liststr
+    outregex = '@OUTPUT(0-9+)?@', '@OUTDIR@'                 # type: T.Liststr
+    if '@INPUT@' not in values:
+        # Error out if any input-derived templates are present in the command
+        match = iter_regexin_iter(inregex, command)
+        if match:
+            raise MesonException(f'Command cannot have {match!r}, since no input files were specified')
+    else:
+        if len(values'@INPUT@') > 1:
+            # Error out if @PLAINNAME@ or @BASENAME@ is present in the command
+            match = iter_regexin_iter(inregex1:, command)
+            if match:
+                raise MesonException(f'Command cannot have {match!r} when there is '
+                                     'more than one input file')
+        # Error out if an invalid @INPUTnn@ template was specified
+        for each in command:
+            if not isinstance(each, str):
+                continue
+            match2 = re.search(inregex0, each)
+            if match2 and match2.group() not in values:
+                m = 'Command cannot have {!r} since there are only {!r} inputs'
+                raise MesonException(m.format(match2.group(), len(values'@INPUT@')))
+    if '@OUTPUT@' not in values:
+        # Error out if any output-derived templates are present in the command
+        match = iter_regexin_iter(outregex, command)
+        if match:
+            raise MesonException(f'Command cannot have {match!r} since there are no outputs')
+    else:
+        # Error out if an invalid @OUTPUTnn@ template was specified
+        for each in command:
+            if not isinstance(each, str):
+                continue
+            match2 = re.search(outregex0, each)
+            if match2 and match2.group() not in values:
+                m = 'Command cannot have {!r} since there are only {!r} outputs'
+                raise MesonException(m.format(match2.group(), len(values'@OUTPUT@')))
+
+
+def substitute_values(command: T.Liststr, values: T.Dictstr, T.Unionstr, T.Liststr) -> T.Liststr:
+    '''
+    Substitute the template strings in the @values dict into the list of
+    strings @command and return a new list. For a full list of the templates,
+    see get_filenames_templates_dict()
+
+    If multiple inputs/outputs are given in the @values dictionary, we
+    substitute @INPUT@ and @OUTPUT@ only if they are the entire string, not
+    just a part of it, and in that case we substitute *all* of them.
+
+    The typing of this function is difficult, as only @OUTPUT@ and @INPUT@ can
+    be lists, everything else is a string. However, TypeDict cannot represent
+    this, as you can have optional keys, but not extra keys. We end up just
+    having to us asserts to convince type checkers that this is okay.
+
+    https://github.com/python/mypy/issues/4617
+    '''
+
+    def replace(m: T.Matchstr) -> str:
+        v = valuesm.group(0)
+        assert isinstance(v, str), 'for mypy'
+        return v
+
+    # Error checking
+    _substitute_values_check_errors(command, values)
+
+    # Substitution
+    outcmd =   # type: T.Liststr
+    rx_keys = re.escape(key) for key in values if key not in ('@INPUT@', '@OUTPUT@')
+    value_rx = re.compile('|'.join(rx_keys)) if rx_keys else None
+    for vv in command:
+        more: T.Optionalstr = None
+        if not isinstance(vv, str):
+            outcmd.append(vv)
+        elif '@INPUT@' in vv:
+            inputs = values'@INPUT@'
+            if vv == '@INPUT@':
+                outcmd += inputs
+            elif len(inputs) == 1:
+                outcmd.append(vv.replace('@INPUT@', inputs0))
+            else:
+                raise MesonException("Command has '@INPUT@' as part of a "
+                                     "string and more than one input file")
+        elif '@OUTPUT@' in vv:
+            outputs = values'@OUTPUT@'
+            if vv == '@OUTPUT@':
+                outcmd += outputs
+            elif len(outputs) == 1:
+                outcmd.append(vv.replace('@OUTPUT@', outputs0))
+            else:
+                raise MesonException("Command has '@OUTPUT@' as part of a "
+                                     "string and more than one output file")
+
+        # Append values that are exactly a template string.
+        # This is faster than a string replace.
+        elif vv in values:
+            o = valuesvv
+            assert isinstance(o, str), 'for mypy'
+            more = o
+        # Substitute everything else with replacement
+        elif value_rx:
+            more = value_rx.sub(replace, vv)
+        else:
+            more = vv
+
+        if more is not None:
+            outcmd.append(more)
+
+    return outcmd
+
+
+def get_filenames_templates_dict(inputs: T.Liststr, outputs: T.Liststr) -> T.Dictstr, T.Unionstr, T.Liststr:
+    '''
+    Create a dictionary with template strings as keys and values as values for
+    the following templates:
+
+    @INPUT@  - the full path to one or more input files, from @inputs
+    @OUTPUT@ - the full path to one or more output files, from @outputs
+    @OUTDIR@ - the full path to the directory containing the output files
+
+    If there is only one input file, the following keys are also created:
+
+    @PLAINNAME@ - the filename of the input file
+    @BASENAME@ - the filename of the input file with the extension removed
+
+    If there is more than one input file, the following keys are also created:
+
+    @INPUT0@, @INPUT1@, ... one for each input file
+
+    If there is more than one output file, the following keys are also created:
+
+    @OUTPUT0@, @OUTPUT1@, ... one for each output file
+    '''
+    values = {}  # type: T.Dictstr, T.Unionstr, T.Liststr
+    # Gather values derived from the input
+    if inputs:
+        # We want to substitute all the inputs.
+        values'@INPUT@' = inputs
+        for (ii, vv) in enumerate(inputs):
+            # Write out @INPUT0@, @INPUT1@, ...
+            valuesf'@INPUT{ii}@' = vv
+        if len(inputs) == 1:
+            # Just one value, substitute @PLAINNAME@ and @BASENAME@
+            values'@PLAINNAME@' = plain = os.path.basename(inputs0)
+            values'@BASENAME@' = os.path.splitext(plain)0
+    if outputs:
+        # Gather values derived from the outputs, similar to above.
+        values'@OUTPUT@' = outputs
+        for (ii, vv) in enumerate(outputs):
+            valuesf'@OUTPUT{ii}@' = vv
+        # Outdir should be the same for all outputs
+        values'@OUTDIR@' = os.path.dirname(outputs0)
+        # Many external programs fail on empty arguments.
+        if values'@OUTDIR@' == '':
+            values'@OUTDIR@' = '.'
+    return values
+
+
+def _make_tree_writable(topdir: str) -> None:
+    # Ensure all files and directories under topdir are writable
+    # (and readable) by owner.
+    for d, _, files in os.walk(topdir):
+        os.chmod(d, os.stat(d).st_mode | stat.S_IWRITE | stat.S_IREAD)
+        for fname in files:
+            fpath = os.path.join(d, fname)
+            if os.path.isfile(fpath):
+                os.chmod(fpath, os.stat(fpath).st_mode | stat.S_IWRITE | stat.S_IREAD)
+
+
+def windows_proof_rmtree(f: str) -> None:
+    # On Windows if anyone is holding a file open you can't
+    # delete it. As an example an anti virus scanner might
+    # be scanning files you are trying to delete. The only
+    # way to fix this is to try again and again.
+    delays = 0.1, 0.1, 0.2, 0.2, 0.2, 0.5, 0.5, 1, 1, 1, 1, 2
+    writable = False
+    for d in delays:
+        try:
+            # Start by making the tree writable.
+            if not writable:
+                _make_tree_writable(f)
+                writable = True
+        except PermissionError:
+            time.sleep(d)
+            continue
+        try:
+            shutil.rmtree(f)
+            return
+        except FileNotFoundError:
+            return
+        except OSError:
+            time.sleep(d)
+    # Try one last time and throw if it fails.
+    shutil.rmtree(f)
+
+
+def windows_proof_rm(fpath: str) -> None:
+    """Like windows_proof_rmtree, but for a single file."""
+    if os.path.isfile(fpath):
+        os.chmod(fpath, os.stat(fpath).st_mode | stat.S_IWRITE | stat.S_IREAD)
+    delays = 0.1, 0.1, 0.2, 0.2, 0.2, 0.5, 0.5, 1, 1, 1, 1, 2
+    for d in delays:
+        try:
+            os.unlink(fpath)
+            return
+        except FileNotFoundError:
+            return
+        except OSError:
+            time.sleep(d)
+    os.unlink(fpath)
+
+
+class TemporaryDirectoryWinProof(TemporaryDirectory):
+    """
+    Like TemporaryDirectory, but cleans things up using
+    windows_proof_rmtree()
+    """
+
+    def __exit__(self, exc: T.Any, value: T.Any, tb: T.Any) -> None:
+        try:
+            super().__exit__(exc, value, tb)
+        except OSError:
+            windows_proof_rmtree(self.name)
+
+    def cleanup(self) -> None:
+        try:
+            super().cleanup()
+        except OSError:
+            windows_proof_rmtree(self.name)
+
+
+def detect_subprojects(spdir_name: str, current_dir: str = '',
+                       result: T.OptionalT.Dictstr, T.Liststr = None) -> T.Dictstr, T.Liststr:
+    if result is None:
+        result = {}
+    spdir = os.path.join(current_dir, spdir_name)
+    if not os.path.exists(spdir):
+        return result
+    for trial in glob(os.path.join(spdir, '*')):
+        basename = os.path.basename(trial)
+        if trial == 'packagecache':
+            continue
+        append_this = True
+        if os.path.isdir(trial):
+            detect_subprojects(spdir_name, trial, result)
+        elif trial.endswith('.wrap') and os.path.isfile(trial):
+            basename = os.path.splitext(basename)0
+        else:
+            append_this = False
+        if append_this:
+            if basename in result:
+                resultbasename.append(trial)
+            else:
+                resultbasename = trial
+    return result
+
+
+def substring_is_in_list(substr: str, strlist: T.Liststr) -> bool:
+    for s in strlist:
+        if substr in s:
+            return True
+    return False
+
+
+class OrderedSet(T.MutableSet_T):
+    """A set that preserves the order in which items are added, by first
+    insertion.
+    """
+    def __init__(self, iterable: T.OptionalT.Iterable_T = None):
+        self.__container: T.OrderedDict_T, None = collections.OrderedDict()
+        if iterable:
+            self.update(iterable)
+
+    def __contains__(self, value: object) -> bool:
+        return value in self.__container
+
+    def __iter__(self) -> T.Iterator_T:
+        return iter(self.__container.keys())
+
+    def __len__(self) -> int:
+        return len(self.__container)
+
+    def __repr__(self) -> str:
+        # Don't print 'OrderedSet("")' for an empty set.
+        if self.__container:
+            return 'OrderedSet("{}")'.format(
+                '", "'.join(repr(e) for e in self.__container.keys()))
+        return 'OrderedSet()'
+
+    def __reversed__(self) -> T.Iterator_T:
+        return reversed(self.__container.keys())
+
+    def add(self, value: _T) -> None:
+        self.__containervalue = None
+
+    def discard(self, value: _T) -> None:
+        if value in self.__container:
+            del self.__containervalue
+
+    def move_to_end(self, value: _T, last: bool = True) -> None:
+        self.__container.move_to_end(value, last)
+
+    def pop(self, last: bool = True) -> _T:
+        item, _ = self.__container.popitem(last)
+        return item
+
+    def update(self, iterable: T.Iterable_T) -> None:
+        for item in iterable:
+            self.__containeritem = None
+
+    def difference(self, set_: T.Iterable_T) -> 'OrderedSet_T':
+        return type(self)(e for e in self if e not in set_)
+
+    def difference_update(self, iterable: T.Iterable_T) -> None:
+        for item in iterable:
+            self.discard(item)
+
+def relpath(path: str, start: str) -> str:
+    # On Windows a relative path can't be evaluated for paths on two different
+    # drives (i.e. c:\foo and f:\bar).  The only thing left to do is to use the
+    # original absolute path.
+    try:
+        return os.path.relpath(path, start)
+    except (TypeError, ValueError):
+        return path
+
+def path_is_in_root(path: Path, root: Path, resolve: bool = False) -> bool:
+    # Check whether a path is within the root directory root
+    try:
+        if resolve:
+            path.resolve().relative_to(root.resolve())
+        else:
+            path.relative_to(root)
+    except ValueError:
+        return False
+    return True
+
+def relative_to_if_possible(path: Path, root: Path, resolve: bool = False) -> Path:
+    try:
+        if resolve:
+            return path.resolve().relative_to(root.resolve())
+        else:
+            return path.relative_to(root)
+    except ValueError:
+        return path
+
+class LibType(enum.IntEnum):
+
+    """Enumeration for library types."""
+
+    SHARED = 0
+    STATIC = 1
+    PREFER_SHARED = 2
+    PREFER_STATIC = 3
+
+
+class ProgressBarFallback:  # lgtm py/iter-returns-non-self
+    '''
+    Fallback progress bar implementation when tqdm is not found
+
+    Since this class is not an actual iterator, but only provides a minimal
+    fallback, it is safe to ignore the 'Iterator does not return self from
+    __iter__ method' warning.
+    '''
+    def __init__(self, iterable: T.OptionalT.Iterablestr = None, total: T.Optionalint = None,
+                 bar_type: T.Optionalstr = None, desc: T.Optionalstr = None):
+        if iterable is not None:
+            self.iterable = iter(iterable)
+            return
+        self.total = total
+        self.done = 0
+        self.printed_dots = 0
+        if self.total and bar_type == 'download':
+            print('Download size:', self.total)
+        if desc:
+            print(f'{desc}: ', end='')
+
+    # Pretend to be an iterator when called as one and don't print any
+    # progress
+    def __iter__(self) -> T.Iteratorstr:
+        return self.iterable
+
+    def __next__(self) -> str:
+        return next(self.iterable)
+
+    def print_dot(self) -> None:
+        print('.', end='')
+        sys.stdout.flush()
+        self.printed_dots += 1
+
+    def update(self, progress: int) -> None:
+        self.done += progress
+        if not self.total:
+            # Just print one dot per call if we don't have a total length
+            self.print_dot()
+            return
+        ratio = int(self.done / self.total * 10)
+        while self.printed_dots < ratio:
+            self.print_dot()
+
+    def close(self) -> None:
+        print('')
+
+try:
+    from tqdm import tqdm
+except ImportError:
+    # ideally we would use a typing.Protocol here, but it's part of typing_extensions until 3.8
+    ProgressBar = ProgressBarFallback  # type: T.UnionT.TypeProgressBarFallback, T.TypeProgressBarTqdm
+else:
+    class ProgressBarTqdm(tqdm):
+        def __init__(self, *args: T.Any, bar_type: T.Optionalstr = None, **kwargs: T.Any) -> None:
+            if bar_type == 'download':
+                kwargs.update({'unit': 'bytes', 'leave': True})
+            else:
+                kwargs.update({'leave': False})
+            kwargs'ncols' = 100
+            super().__init__(*args, **kwargs)
+
+    ProgressBar = ProgressBarTqdm
+
+
+class RealPathAction(argparse.Action):
+    def __init__(self, option_strings: T.Liststr, dest: str, default: str = '.', **kwargs: T.Any):
+        default = os.path.abspath(os.path.realpath(default))
+        super().__init__(option_strings, dest, nargs=None, default=default, **kwargs)
+
+    def __call__(self, parser: argparse.ArgumentParser, namespace: argparse.Namespace,
+                 values: T.Unionstr, T.SequenceT.Any, None, option_string: str = None) -> None:
+        assert isinstance(values, str)
+        setattr(namespace, self.dest, os.path.abspath(os.path.realpath(values)))
+
+
+def get_wine_shortpath(winecmd: T.Liststr, wine_paths: T.Liststr,
+                       workdir: T.Optionalstr = None) -> str:
+    '''
+    WINEPATH size is limited to 1024 bytes which can easily be exceeded when
+    adding the path to every dll inside build directory. See
+    https://bugs.winehq.org/show_bug.cgi?id=45810.
+
+    To shorten it as much as possible we use path relative to `workdir`
+    where possible and convert absolute paths to Windows shortpath (e.g.
+    "/usr/x86_64-w64-mingw32/lib" to "Z:\\usr\\X86_~FWL\\lib").
+
+    This limitation reportedly has been fixed with wine >= 6.4
+    '''
+
+    # Remove duplicates
+    wine_paths = list(OrderedSet(wine_paths))
+
+    # Check if it's already short enough
+    wine_path = ';'.join(wine_paths)
+    if len(wine_path) <= 1024:
+        return wine_path
+
+    # Check if we have wine >= 6.4
+    from ..programs import ExternalProgram
+    wine = ExternalProgram('wine', winecmd, silent=True)
+    if version_compare(wine.get_version(), '>=6.4'):
+        return wine_path
+
+    # Check paths that can be reduced by making them relative to workdir.
+    rel_paths = 
+    if workdir:
+        abs_paths = 
+        for p in wine_paths:
+            try:
+                rel = Path(p).relative_to(workdir)
+                rel_paths.append(str(rel))
+            except ValueError:
+                abs_paths.append(p)
+        wine_paths = abs_paths
+
+    if wine_paths:
+        # BAT script that takes a list of paths in argv and prints semi-colon separated shortpaths
+        with NamedTemporaryFile('w', suffix='.bat', encoding='utf-8', delete=False) as bat_file:
+            bat_file.write('''
+            @ECHO OFF
+            for %%x in (%*) do (
+                echo|set /p=;%~sx
+            )
+            ''')
+        try:
+            stdout = subprocess.check_output(winecmd + 'cmd', '/C', bat_file.name + wine_paths,
+                                             encoding='utf-8', stderr=subprocess.DEVNULL)
+            stdout = stdout.strip(';')
+            if stdout:
+                wine_paths = stdout.split(';')
+            else:
+                mlog.warning('Could not shorten WINEPATH: empty stdout')
+        except subprocess.CalledProcessError as e:
+            mlog.warning(f'Could not shorten WINEPATH: {str(e)}')
+        finally:
+            os.unlink(bat_file.name)
+    wine_path = ';'.join(rel_paths + wine_paths)
+    if len(wine_path) > 1024:
+        mlog.warning('WINEPATH exceeds 1024 characters which could cause issues')
+    return wine_path
+
+
+def run_once(func: T.Callable..., _T) -> T.Callable..., _T:
+    ret =   # type: T.List_T
+
+    @wraps(func)
+    def wrapper(*args: T.Any, **kwargs: T.Any) -> _T:
+        if ret:
+            return ret0
+
+        val = func(*args, **kwargs)
+        ret.append(val)
+        return val
+
+    return wrapper
+
+
+def generate_list(func: T.Callable..., T.Generator_T, None, None) -> T.Callable..., T.List_T:
+    @wraps(func)
+    def wrapper(*args: T.Any, **kwargs: T.Any) -> T.List_T:
+        return list(func(*args, **kwargs))
+
+    return wrapper
+
+
+class OptionOverrideProxy(collections.abc.Mapping):
+    '''Mimic an option list but transparently override selected option
+    values.
+    '''
+
+    # TODO: the typing here could be made more explicit using a TypeDict from
+    # python 3.8 or typing_extensions
+
+    def __init__(self, overrides: T.Dict'OptionKey', T.Any, options: 'KeyedOptionDictType',
+                 subproject: T.Optionalstr = None):
+        self.overrides = overrides
+        self.options = options
+        self.subproject = subproject
+
+    def __getitem__(self, key: 'OptionKey') -> 'UserOption':
+        # FIXME: This is fundamentally the same algorithm than interpreter.get_option_internal().
+        # We should try to share the code somehow.
+        key = key.evolve(subproject=self.subproject)
+        if not key.is_project():
+            opt = self.options.get(key)
+            if opt is None or opt.yielding:
+                opt = self.optionskey.as_root()
+        else:
+            opt = self.optionskey
+            if opt.yielding:
+                opt = self.options.get(key.as_root(), opt)
+        override_value = self.overrides.get(key.as_root())
+        if override_value is not None:
+            opt = copy.copy(opt)
+            opt.set_value(override_value)
+        return opt
+
+    def __iter__(self) -> T.Iterator'OptionKey':
+        return iter(self.options)
+
+    def __len__(self) -> int:
+        return len(self.options)
+
+    def __eq__(self, other: object) -> bool:
+        if not isinstance(other, OptionOverrideProxy):
+            return NotImplemented
+        t1 = (self.overrides, self.subproject, self.options)
+        t2 = (other.overrides, other.subproject, other.options)
+        return t1 == t2
+
+
+class OptionType(enum.IntEnum):
+
+    """Enum used to specify what kind of argument a thing is."""
+
+    BUILTIN = 0
+    BACKEND = 1
+    BASE = 2
+    COMPILER = 3
+    PROJECT = 4
+
+# This is copied from coredata. There is no way to share this, because this
+# is used in the OptionKey constructor, and the coredata lists are
+# OptionKeys...
+_BUILTIN_NAMES = {
+    'prefix',
+    'bindir',
+    'datadir',
+    'includedir',
+    'infodir',
+    'libdir',
+    'libexecdir',
+    'localedir',
+    'localstatedir',
+    'mandir',
+    'sbindir',
+    'sharedstatedir',
+    'sysconfdir',
+    'auto_features',
+    'backend',
+    'buildtype',
+    'debug',
+    'default_library',
+    'errorlogs',
+    'install_umask',
+    'layout',
+    'optimization',
+    'prefer_static',
+    'stdsplit',
+    'strip',
+    'unity',
+    'unity_size',
+    'warning_level',
+    'werror',
+    'wrap_mode',
+    'force_fallback_for',
+    'pkg_config_path',
+    'cmake_prefix_path',
+}
+
+
+def _classify_argument(key: 'OptionKey') -> OptionType:
+    """Classify arguments into groups so we know which dict to assign them to."""
+
+    if key.name.startswith('b_'):
+        return OptionType.BASE
+    elif key.lang is not None:
+        return OptionType.COMPILER
+    elif key.name in _BUILTIN_NAMES or key.module:
+        return OptionType.BUILTIN
+    elif key.name.startswith('backend_'):
+        assert key.machine is MachineChoice.HOST, str(key)
+        return OptionType.BACKEND
+    else:
+        assert key.machine is MachineChoice.HOST, str(key)
+        return OptionType.PROJECT
+
+
+@total_ordering
+class OptionKey:
+
+    """Represents an option key in the various option dictionaries.
+
+    This provides a flexible, powerful way to map option names from their
+    external form (things like subproject:build.option) to something that
+    internally easier to reason about and produce.
+    """
+
+    __slots__ = 'name', 'subproject', 'machine', 'lang', '_hash', 'type', 'module'
+
+    name: str
+    subproject: str
+    machine: MachineChoice
+    lang: T.Optionalstr
+    _hash: int
+    type: OptionType
+    module: T.Optionalstr
+
+    def __init__(self, name: str, subproject: str = '',
+                 machine: MachineChoice = MachineChoice.HOST,
+                 lang: T.Optionalstr = None,
+                 module: T.Optionalstr = None,
+                 _type: T.OptionalOptionType = None):
+        # the _type option to the constructor is kinda private. We want to be
+        # able tos ave the state and avoid the lookup function when
+        # pickling/unpickling, but we need to be able to calculate it when
+        # constructing a new OptionKey
+        object.__setattr__(self, 'name', name)
+        object.__setattr__(self, 'subproject', subproject)
+        object.__setattr__(self, 'machine', machine)
+        object.__setattr__(self, 'lang', lang)
+        object.__setattr__(self, 'module', module)
+        object.__setattr__(self, '_hash', hash((name, subproject, machine, lang, module)))
+        if _type is None:
+            _type = _classify_argument(self)
+        object.__setattr__(self, 'type', _type)
+
+    def __setattr__(self, key: str, value: T.Any) -> None:
+        raise AttributeError('OptionKey instances do not support mutation.')
+
+    def __getstate__(self) -> T.Dictstr, T.Any:
+        return {
+            'name': self.name,
+            'subproject': self.subproject,
+            'machine': self.machine,
+            'lang': self.lang,
+            '_type': self.type,
+            'module': self.module,
+        }
+
+    def __setstate__(self, state: T.Dictstr, T.Any) -> None:
+        """De-serialize the state of a pickle.
+
+        This is very clever. __init__ is not a constructor, it's an
+        initializer, therefore it's safe to call more than once. We create a
+        state in the custom __getstate__ method, which is valid to pass
+        splatted to the initializer.
+        """
+        # Mypy doesn't like this, because it's so clever.
+        self.__init__(**state)  # type: ignore
+
+    def __hash__(self) -> int:
+        return self._hash
+
+    def _to_tuple(self) -> T.Tuplestr, OptionType, str, str, MachineChoice, str:
+        return (self.subproject, self.type, self.lang or '', self.module or '', self.machine, self.name)
+
+    def __eq__(self, other: object) -> bool:
+        if isinstance(other, OptionKey):
+            return self._to_tuple() == other._to_tuple()
+        return NotImplemented
+
+    def __lt__(self, other: object) -> bool:
+        if isinstance(other, OptionKey):
+            return self._to_tuple() < other._to_tuple()
+        return NotImplemented
+
+    def __str__(self) -> str:
+        out = self.name
+        if self.lang:
+            out = f'{self.lang}_{out}'
+        if self.machine is MachineChoice.BUILD:
+            out = f'build.{out}'
+        if self.module:
+            out = f'{self.module}.{out}'
+        if self.subproject:
+            out = f'{self.subproject}:{out}'
+        return out
+
+    def __repr__(self) -> str:
+        return f'OptionKey({self.name!r}, {self.subproject!r}, {self.machine!r}, {self.lang!r}, {self.module!r}, {self.type!r})'
+
+    @classmethod
+    def from_string(cls, raw: str) -> 'OptionKey':
+        """Parse the raw command line format into a three part tuple.
+
+        This takes strings like `mysubproject:build.myoption` and Creates an
+        OptionKey out of them.
+        """
+        try:
+            subproject, raw2 = raw.split(':')
+        except ValueError:
+            subproject, raw2 = '', raw
+
+        module = None
+        for_machine = MachineChoice.HOST
+        try:
+            prefix, raw3 = raw2.split('.')
+            if prefix == 'build':
+                for_machine = MachineChoice.BUILD
+            else:
+                module = prefix
+        except ValueError:
+            raw3 = raw2
+
+        from ..compilers import all_languages
+        if any(raw3.startswith(f'{l}_') for l in all_languages):
+            lang, opt = raw3.split('_', 1)
+        else:
+            lang, opt = None, raw3
+        assert ':' not in opt
+        assert '.' not in opt
+
+        return cls(opt, subproject, for_machine, lang, module)
+
+    def evolve(self, name: T.Optionalstr = None, subproject: T.Optionalstr = None,
+               machine: T.OptionalMachineChoice = None, lang: T.Optionalstr = '',
+               module: T.Optionalstr = '') -> 'OptionKey':
+        """Create a new copy of this key, but with alterted members.
+
+        For example:
+        >>> a = OptionKey('foo', '', MachineChoice.Host)
+        >>> b = OptionKey('foo', 'bar', MachineChoice.Host)
+        >>> b == a.evolve(subproject='bar')
+        True
+        """
+        # We have to be a little clever with lang here, because lang is valid
+        # as None, for non-compiler options
+        return OptionKey(
+            name if name is not None else self.name,
+            subproject if subproject is not None else self.subproject,
+            machine if machine is not None else self.machine,
+            lang if lang != '' else self.lang,
+            module if module != '' else self.module
+        )
+
+    def as_root(self) -> 'OptionKey':
+        """Convenience method for key.evolve(subproject='')."""
+        return self.evolve(subproject='')
+
+    def as_build(self) -> 'OptionKey':
+        """Convenience method for key.evolve(machine=MachinceChoice.BUILD)."""
+        return self.evolve(machine=MachineChoice.BUILD)
+
+    def as_host(self) -> 'OptionKey':
+        """Convenience method for key.evolve(machine=MachinceChoice.HOST)."""
+        return self.evolve(machine=MachineChoice.HOST)
+
+    def is_backend(self) -> bool:
+        """Convenience method to check if this is a backend option."""
+        return self.type is OptionType.BACKEND
+
+    def is_builtin(self) -> bool:
+        """Convenience method to check if this is a builtin option."""
+        return self.type is OptionType.BUILTIN
+
+    def is_compiler(self) -> bool:
+        """Convenience method to check if this is a builtin option."""
+        return self.type is OptionType.COMPILER
+
+    def is_project(self) -> bool:
+        """Convenience method to check if this is a project option."""
+        return self.type is OptionType.PROJECT
+
+    def is_base(self) -> bool:
+        """Convenience method to check if this is a base option."""
+        return self.type is OptionType.BASE
+
+def pickle_load(filename: str, object_name: str, object_type: T.Type) -> T.Any:
+    load_fail_msg = f'{object_name} file {filename!r} is corrupted. Try with a fresh build tree.'
+    try:
+        with open(filename, 'rb') as f:
+            obj = pickle.load(f)
+    except (pickle.UnpicklingError, EOFError):
+        raise MesonException(load_fail_msg)
+    except (TypeError, ModuleNotFoundError, AttributeError):
+        build_dir = os.path.dirname(os.path.dirname(filename))
+        raise MesonException(
+            f"{object_name} file {filename!r} references functions or classes that don't "
+            "exist. This probably means that it was generated with an old "
+            "version of meson. Try running from the source directory "
+            f'meson setup {build_dir} --wipe')
+    if not isinstance(obj, object_type):
+        raise MesonException(load_fail_msg)
+    from ..coredata import version as coredata_version
+    from ..coredata import major_versions_differ, MesonVersionMismatchException
+    version = getattr(obj, 'version', None)
+    if version is None:
+        version = obj.environment.coredata.version
+    if major_versions_differ(version, coredata_version):
+        raise MesonVersionMismatchException(version, coredata_version)
+    return obj
+
+
+def first(iter: T.Iterable_T, predicate: T.Callable_T, bool) -> T.Optional_T:
+    """Find the first entry in an iterable where the given predicate is true
+
+    :param iter: The iterable to search
+    :param predicate: A finding function that takes an element from the iterable
+        and returns True if found, otherwise False
+    :return: The first found element, or None if it is not found
+    """
+    for i in iter:
+        if predicate(i):
+            return i
+    return None

_service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/utils/vsenv.py Added

@@ -0,0 +1,123 @@
+from __future__ import annotations
+
+import os
+import subprocess
+import json
+import pathlib
+import shutil
+import tempfile
+
+from .. import mlog
+from .universal import MesonException, is_windows, windows_detect_native_arch
+
+
+__all__ = 
+    'setup_vsenv',
+
+
+
+bat_template = '''@ECHO OFF
+
+call "{}"
+
+ECHO {}
+SET
+'''
+
+# If on Windows and VS is installed but not set up in the environment,
+# set it to be runnable. In this way Meson can be directly invoked
+# from any shell, VS Code etc.
+def _setup_vsenv(force: bool) -> bool:
+    if not is_windows():
+        return False
+    if os.environ.get('OSTYPE') == 'cygwin':
+        return False
+    if 'MESON_FORCE_VSENV_FOR_UNITTEST' not in os.environ:
+        # VSINSTALL is set when running setvars from a Visual Studio installation
+        # Tested with Visual Studio 2012 and 2017
+        if 'VSINSTALLDIR' in os.environ:
+            return False
+        # Check explicitly for cl when on Windows
+        if shutil.which('cl.exe'):
+            return False
+    if not force:
+        if shutil.which('cc'):
+            return False
+        if shutil.which('gcc'):
+            return False
+        if shutil.which('clang'):
+            return False
+        if shutil.which('clang-cl'):
+            return False
+
+    root = os.environ.get("ProgramFiles(x86)") or os.environ.get("ProgramFiles")
+    bat_locator_bin = pathlib.Path(root, 'Microsoft Visual Studio/Installer/vswhere.exe')
+    if not bat_locator_bin.exists():
+        raise MesonException(f'Could not find {bat_locator_bin}')
+    bat_json = subprocess.check_output(
+        
+            str(bat_locator_bin),
+            '-latest',
+            '-prerelease',
+            '-requiresAny',
+            '-requires', 'Microsoft.VisualStudio.Component.VC.Tools.x86.x64',
+            '-requires', 'Microsoft.VisualStudio.Workload.WDExpress',
+            '-products', '*',
+            '-utf8',
+            '-format',
+            'json'
+        
+    )
+    bat_info = json.loads(bat_json)
+    if not bat_info:
+        # VS installer instelled but not VS itself maybe?
+        raise MesonException('Could not parse vswhere.exe output')
+    bat_root = pathlib.Path(bat_info0'installationPath')
+    if windows_detect_native_arch() == 'arm64':
+        bat_path = bat_root / 'VC/Auxiliary/Build/vcvarsarm64.bat'
+        if not bat_path.exists():
+            bat_path = bat_root / 'VC/Auxiliary/Build/vcvarsx86_arm64.bat'
+    else:
+        bat_path = bat_root / 'VC/Auxiliary/Build/vcvars64.bat'
+        # if VS is not found try VS Express
+        if not bat_path.exists():
+            bat_path = bat_root / 'VC/Auxiliary/Build/vcvarsx86_amd64.bat'
+    if not bat_path.exists():
+        raise MesonException(f'Could not find {bat_path}')
+
+    mlog.log('Activating VS', bat_info0'catalog''productDisplayVersion')
+    bat_separator = '---SPLIT---'
+    bat_contents = bat_template.format(bat_path, bat_separator)
+    bat_file = tempfile.NamedTemporaryFile('w', suffix='.bat', encoding='utf-8', delete=False)
+    bat_file.write(bat_contents)
+    bat_file.flush()
+    bat_file.close()
+    bat_output = subprocess.check_output(bat_file.name, universal_newlines=True)
+    os.unlink(bat_file.name)
+    bat_lines = bat_output.split('\n')
+    bat_separator_seen = False
+    for bat_line in bat_lines:
+        if bat_line == bat_separator:
+            bat_separator_seen = True
+            continue
+        if not bat_separator_seen:
+            continue
+        if not bat_line:
+            continue
+        try:
+            k, v = bat_line.split('=', 1)
+        except ValueError:
+            # there is no "=", ignore junk data
+            pass
+        else:
+            os.environk = v
+    return True
+
+def setup_vsenv(force: bool = False) -> bool:
+    try:
+        return _setup_vsenv(force)
+    except MesonException as e:
+        if force:
+            raise
+        mlog.warning('Failed to activate VS environment:', str(e))
+        return False

_service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/utils/win32.py Added

@@ -0,0 +1,40 @@
+# SPDX-license-identifier: Apache-2.0
+# Copyright 2012-2021 The Meson development team
+# Copyright © 2021 Intel Corporation
+
+# 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.
+from __future__ import annotations
+
+"""Windows specific implementations of mesonlib functionality."""
+
+import msvcrt
+import typing as T
+
+from .universal import MesonException
+from .platform import BuildDirLock as BuildDirLockBase
+
+__all__ = 'BuildDirLock'
+
+class BuildDirLock(BuildDirLockBase):
+
+    def __enter__(self) -> None:
+        self.lockfile = open(self.lockfilename, 'w', encoding='utf-8')
+        try:
+            msvcrt.locking(self.lockfile.fileno(), msvcrt.LK_NBLCK, 1)
+        except (BlockingIOError, PermissionError):
+            self.lockfile.close()
+            raise MesonException('Some other Meson process is already using this build directory. Exiting.')
+
+    def __exit__(self, *args: T.Any) -> None:
+        msvcrt.locking(self.lockfile.fileno(), msvcrt.LK_UNLCK, 1)
+        self.lockfile.close()

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/wrap/wrap.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/wrap/wrap.py Changed

@@ -11,6 +11,7 @@
 # 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.
+from __future__ import annotations
 
 from .. import mlog
 import contextlib
@@ -29,8 +30,12 @@
 import time
 import typing as T
 import textwrap
+import json
 
+from base64 import b64encode
+from netrc import netrc
 from pathlib import Path
+
 from . import WrapMode
 from .. import coredata
 from ..mesonlib import quiet_git, GIT, ProgressBar, MesonException, windows_proof_rmtree, Popen_safe
@@ -91,7 +96,7 @@
         raise WrapException(f'SSL module not available in {sys.executable}: Cannot contact the WrapDB.{insecure_msg}')
     else:
         # following code is only for those without Python SSL
-        global SSL_WARNING_PRINTED
+        global SSL_WARNING_PRINTED  # pylint: disable=global-statement
         if not SSL_WARNING_PRINTED:
             mlog.warning(f'SSL module not available in {sys.executable}: WrapDB traffic not authenticated.')
             SSL_WARNING_PRINTED = True
@@ -103,6 +108,36 @@
     except urllib.error.URLError as excp:
         raise WrapException(f'WrapDB connection failed to {urlstring} with error {excp}')
 
+def get_releases_data(allow_insecure: bool) -> bytes:
+    url = open_wrapdburl('https://wrapdb.mesonbuild.com/v2/releases.json', allow_insecure, True)
+    return url.read()
+
+def get_releases(allow_insecure: bool) -> T.Dictstr, T.Any:
+    data = get_releases_data(allow_insecure)
+    return T.cast('T.Dictstr, T.Any', json.loads(data.decode()))
+
+def update_wrap_file(wrapfile: str, name: str, new_version: str, new_revision: str, allow_insecure: bool) -> None:
+    url = open_wrapdburl(f'https://wrapdb.mesonbuild.com/v2/{name}_{new_version}-{new_revision}/{name}.wrap',
+                         allow_insecure, True)
+    with open(wrapfile, 'wb') as f:
+        f.write(url.read())
+
+def parse_patch_url(patch_url: str) -> T.Tuplestr, str:
+    u = urllib.parse.urlparse(patch_url)
+    if u.netloc != 'wrapdb.mesonbuild.com':
+        raise WrapException(f'URL {patch_url} does not seems to be a wrapdb patch')
+    arr = u.path.strip('/').split('/')
+    if arr0 == 'v1':
+        # e.g. https://wrapdb.mesonbuild.com/v1/projects/zlib/1.2.11/5/get_zip
+        return arr-3, arr-2
+    elif arr0 == 'v2':
+        # e.g. https://wrapdb.mesonbuild.com/v2/zlib_1.2.11-5/get_patch
+        tag = arr-2
+        _, version = tag.rsplit('_', 1)
+        version, revision = version.rsplit('-', 1)
+        return version, revision
+    else:
+        raise WrapException(f'Invalid wrapdb URL {patch_url}')
 
 class WrapException(MesonException):
     pass
@@ -122,19 +157,21 @@
         self.basename = os.path.basename(fname)
         self.has_wrap = self.basename.endswith('.wrap')
         self.name = self.basename:-5 if self.has_wrap else self.basename
-        self.directory = self.name
-        self.provided_depsself.name = None
+        # must be lowercase for consistency with dep=variable assignment
+        self.provided_depsself.name.lower() = None
+        # What the original file name was before redirection
         self.original_filename = fname
         self.redirected = False
         if self.has_wrap:
             self.parse_wrap()
+            with open(fname, 'r', encoding='utf-8') as file:
+                self.wrapfile_hash = hashlib.sha256(file.read().encode('utf-8')).hexdigest()
         self.directory = self.values.get('directory', self.name)
         if os.path.dirname(self.directory):
             raise WrapException('Directory key must be a name and not a path')
         if self.type and self.type not in ALL_TYPES:
             raise WrapException(f'Unknown wrap type {self.type!r}')
         self.filesdir = os.path.join(os.path.dirname(self.filename), 'packagefiles')
-        # What the original file name was before redirection
 
     def parse_wrap(self) -> None:
         try:
@@ -195,8 +232,9 @@
             for k, v in config'provide'.items():
                 if k == 'dependency_names':
                     # A comma separated list of dependency names that does not
-                    # need a variable name
-                    names_dict = {n.strip(): None for n in v.split(',')}
+                    # need a variable name; must be lowercase for consistency with
+                    # dep=variable assignment
+                    names_dict = {n.strip().lower(): None for n in v.split(',')}
                     self.provided_deps.update(names_dict)
                     continue
                 if k == 'program_names':
@@ -217,6 +255,14 @@
         except KeyError:
             raise WrapException(f'Missing key {key!r} in {self.basename}')
 
+    def get_hashfile(self, subproject_directory: str) -> str:
+        return os.path.join(subproject_directory, '.meson-subproject-wrap-hash.txt')
+
+    def update_hash_cache(self, subproject_directory: str) -> None:
+        if self.has_wrap:
+            with open(self.get_hashfile(subproject_directory), 'w', encoding='utf-8') as file:
+                file.write(self.wrapfile_hash + '\n')
+
 def get_directory(subdir_root: str, packagename: str) -> str:
     fname = os.path.join(subdir_root, packagename + '.wrap')
     if os.path.isfile(fname):
@@ -246,43 +292,87 @@
         self.subdir_root = os.path.join(self.source_dir, self.subdir)
         self.cachedir = os.path.join(self.subdir_root, 'packagecache')
         self.wraps = {} # type: T.Dictstr, PackageDefinition
+        self.netrc: T.Optionalnetrc = None
         self.provided_deps = {} # type: T.Dictstr, PackageDefinition
         self.provided_programs = {} # type: T.Dictstr, PackageDefinition
+        self.wrapdb: T.Dictstr, T.Any = {}
+        self.wrapdb_provided_deps: T.Dictstr, str = {}
+        self.wrapdb_provided_programs: T.Dictstr, str = {}
         self.load_wraps()
+        self.load_netrc()
+        self.load_wrapdb()
+
+    def load_netrc(self) -> None:
+        try:
+            self.netrc = netrc()
+        except FileNotFoundError:
+            return
+        except Exception as e:
+            mlog.warning(f'failed to process netrc file: {e}.', fatal=False)
 
     def load_wraps(self) -> None:
         if not os.path.isdir(self.subdir_root):
             return
         root, dirs, files = next(os.walk(self.subdir_root))
+        ignore_dirs = {'packagecache', 'packagefiles'}
         for i in files:
             if not i.endswith('.wrap'):
                 continue
             fname = os.path.join(self.subdir_root, i)
             wrap = PackageDefinition(fname, self.subproject)
             self.wrapswrap.name = wrap
-            if wrap.directory in dirs:
-                dirs.remove(wrap.directory)
+            ignore_dirs |= {wrap.directory, wrap.name}
         # Add dummy package definition for directories not associated with a wrap file.
         for i in dirs:
-            if i in 'packagecache', 'packagefiles':
+            if i in ignore_dirs:
                 continue
             fname = os.path.join(self.subdir_root, i)
             wrap = PackageDefinition(fname, self.subproject)
             self.wrapswrap.name = wrap
 
         for wrap in self.wraps.values():
-            for k in wrap.provided_deps.keys():
-                if k in self.provided_deps:
-                    prev_wrap = self.provided_depsk
-                    m = f'Multiple wrap files provide {k!r} dependency: {wrap.basename} and {prev_wrap.basename}'
-                    raise WrapException(m)
-                self.provided_depsk = wrap
-            for k in wrap.provided_programs:
-                if k in self.provided_programs:
-                    prev_wrap = self.provided_programsk
-                    m = f'Multiple wrap files provide {k!r} program: {wrap.basename} and {prev_wrap.basename}'
-                    raise WrapException(m)
-                self.provided_programsk = wrap
+            self.add_wrap(wrap)
+
+    def add_wrap(self, wrap: PackageDefinition) -> None:
+        for k in wrap.provided_deps.keys():
+            if k in self.provided_deps:
+                prev_wrap = self.provided_depsk
+                m = f'Multiple wrap files provide {k!r} dependency: {wrap.basename} and {prev_wrap.basename}'
+                raise WrapException(m)
+            self.provided_depsk = wrap
+        for k in wrap.provided_programs:
+            if k in self.provided_programs:
+                prev_wrap = self.provided_programsk
+                m = f'Multiple wrap files provide {k!r} program: {wrap.basename} and {prev_wrap.basename}'
+                raise WrapException(m)
+            self.provided_programsk = wrap
+
+    def load_wrapdb(self) -> None:
+        try:
+            with Path(self.subdir_root, 'wrapdb.json').open('r', encoding='utf-8') as f:
+                self.wrapdb = json.load(f)
+        except FileNotFoundError:
+            return
+        for name, info in self.wrapdb.items():
+            self.wrapdb_provided_deps.update({i: name for i in info.get('dependency_names', )})
+            self.wrapdb_provided_programs.update({i: name for i in info.get('program_names', )})
+
+    def get_from_wrapdb(self, subp_name: str) -> PackageDefinition:
+        info = self.wrapdb.get(subp_name)
+        if not info:
+            return None
+        self.check_can_download()
+        latest_version = info'versions'0
+        version, revision = latest_version.rsplit('-', 1)
+        url = urllib.request.urlopen(f'https://wrapdb.mesonbuild.com/v2/{subp_name}_{version}-{revision}/{subp_name}.wrap')
+        fname = Path(self.subdir_root, f'{subp_name}.wrap')
+        with fname.open('wb') as f:
+            f.write(url.read())
+        mlog.log(f'Installed {subp_name} version {version} revision {revision}')
+        wrap = PackageDefinition(str(fname))
+        self.wrapswrap.name = wrap
+        self.add_wrap(wrap)
+        return wrap
 
     def merge_wraps(self, other_resolver: 'Resolver') -> None:
         for k, v in other_resolver.wraps.items():
@@ -300,7 +390,8 @@
         if wrap:
             dep_var = wrap.provided_deps.get(packagename)
             return wrap.name, dep_var
-        return None, None
+        wrap_name = self.wrapdb_provided_deps.get(packagename)
+        return wrap_name, None
 
     def get_varname(self, subp_name: str, depname: str) -> T.Optionalstr:
         wrap = self.wraps.get(subp_name)
@@ -311,6 +402,9 @@
             wrap = self.provided_programs.get(name)
             if wrap:
                 return wrap.name
+            wrap_name = self.wrapdb_provided_programs.get(name)
+            if wrap_name:
+                return wrap_name
         return None
 
     def resolve(self, packagename: str, method: str) -> str:
@@ -318,15 +412,20 @@
         self.directory = packagename
         self.wrap = self.wraps.get(packagename)
         if not self.wrap:
+            self.wrap = self.get_from_wrapdb(packagename)
+        if not self.wrap:
             m = f'Neither a subproject directory nor a {self.packagename}.wrap file was found.'
             raise WrapNotFoundException(m)
         self.directory = self.wrap.directory
 
         if self.wrap.has_wrap:
-            # We have a .wrap file, source code will be placed into main
-            # project's subproject_dir even if the wrap file comes from another
-            # subproject.
-            self.dirname = os.path.join(self.subdir_root, self.directory)
+            # We have a .wrap file, use directory relative to the location of
+            # the wrap file if it exists, otherwise source code will be placed
+            # into main project's subproject_dir even if the wrap file comes
+            # from another subproject.
+            self.dirname = os.path.join(os.path.dirname(self.wrap.filename), self.wrap.directory)
+            if not os.path.exists(self.dirname):
+                self.dirname = os.path.join(self.subdir_root, self.directory)
             # Check if the wrap comes from the main project.
             main_fname = os.path.join(self.subdir_root, self.wrap.basename)
             if self.wrap.filename != main_fname:
@@ -345,16 +444,16 @@
             self.dirname = self.wrap.filename
         rel_path = os.path.relpath(self.dirname, self.source_dir)
 
-        meson_file = os.path.join(self.dirname, 'meson.build')
-        cmake_file = os.path.join(self.dirname, 'CMakeLists.txt')
-
-        if method not in 'meson', 'cmake':
+        if method == 'meson':
+            buildfile = os.path.join(self.dirname, 'meson.build')
+        elif method == 'cmake':
+            buildfile = os.path.join(self.dirname, 'CMakeLists.txt')
+        else:
             raise WrapException('Only the methods "meson" and "cmake" are supported')
 
         # The directory is there and has meson.build? Great, use it.
-        if method == 'meson' and os.path.exists(meson_file):
-            return rel_path
-        if method == 'cmake' and os.path.exists(cmake_file):
+        if os.path.exists(buildfile):
+            self.validate()
             return rel_path
 
         # Check if the subproject is a git submodule
@@ -384,10 +483,13 @@
                 raise
 
         # A meson.build or CMakeLists.txt file is required in the directory
-        if method == 'meson' and not os.path.exists(meson_file):
-            raise WrapException('Subproject exists but has no meson.build file')
-        if method == 'cmake' and not os.path.exists(cmake_file):
-            raise WrapException('Subproject exists but has no CMakeLists.txt file')
+        if not os.path.exists(buildfile):
+            raise WrapException(f'Subproject exists but has no {os.path.basename(buildfile)} file')
+
+        # At this point, the subproject has been successfully resolved for the
+        # first time so save off the hash of the entire wrap file for future
+        # reference.
+        self.wrap.update_hash_cache(self.dirname)
 
         return rel_path
 
@@ -481,8 +583,11 @@
                         verbose_git('fetch', self.wrap.get('url'), revno, self.dirname, check=True)
                         verbose_git(checkout_cmd, self.dirname, check=True)
             else:
-                verbose_git('-c', 'advice.detachedHead=false', 'clone', *depth_option, '--branch', revno, self.wrap.get('url'),
-                             self.directory, self.subdir_root, check=True)
+                args = '-c', 'advice.detachedHead=false', 'clone', *depth_option
+                if revno.lower() != 'head':
+                    args += '--branch', revno
+                args += self.wrap.get('url'), self.directory
+                verbose_git(args, self.subdir_root, check=True)
             if self.wrap.values.get('clone-recursive', '').lower() == 'true':
                 verbose_git('submodule', 'update', '--init', '--checkout', '--recursive', *depth_option,
                             self.dirname, check=True)
@@ -490,9 +595,29 @@
             if push_url:
                 verbose_git('remote', 'set-url', '--push', 'origin', push_url, self.dirname, check=True)
 
+    def validate(self) -> None:
+        # This check is only for subprojects with wraps.
+        if not self.wrap.has_wrap:
+            return
+
+        # Retrieve original hash, if it exists.
+        hashfile = self.wrap.get_hashfile(self.dirname)
+        if os.path.isfile(hashfile):
+            with open(hashfile, 'r', encoding='utf-8') as file:
+                expected_hash = file.read().strip()
+        else:
+            # If stored hash doesn't exist then don't warn.
+            return
+
+        actual_hash = self.wrap.wrapfile_hash
+
+        # Compare hashes and warn the user if they don't match.
+        if expected_hash != actual_hash:
+            mlog.warning(f'Subproject {self.wrap.name}\'s revision may be out of date; its wrap file has changed since it was first configured')
+
     def is_git_full_commit_id(self, revno: str) -> bool:
         result = False
-        if len(revno) in (40, 64): # 40 for sha1, 64 for upcoming sha256
+        if len(revno) in {40, 64}: # 40 for sha1, 64 for upcoming sha256
             result = all(ch in '0123456789AaBbCcDdEeFf' for ch in revno)
         return result
 
@@ -515,6 +640,16 @@
         subprocess.check_call(svn, 'checkout', '-r', revno, self.wrap.get('url'),
                                self.directory, cwd=self.subdir_root)
 
+    def get_netrc_credentials(self, netloc: str) -> T.OptionalT.Tuplestr, str:
+        if self.netrc is None or netloc not in self.netrc.hosts:
+            return None
+
+        login, account, password = self.netrc.authenticators(netloc)
+        if account is not None:
+            login = account
+
+        return login, password
+
     def get_data(self, urlstring: str) -> T.Tuplestr, str:
         blocksize = 10 * 1024
         h = hashlib.sha256()
@@ -525,13 +660,27 @@
         elif WHITELIST_SUBDOMAIN in urlstring:
             raise WrapException(f'{urlstring} may be a WrapDB-impersonating URL')
         else:
+            headers = {'User-Agent': f'mesonbuild/{coredata.version}'}
+            creds = self.get_netrc_credentials(url.netloc)
+
+            if creds is not None and '@' not in url.netloc:
+                login, password = creds
+                if url.scheme == 'https':
+                    enc_creds = b64encode(f'{login}:{password}'.encode()).decode()
+                    headers.update({'Authorization': f'Basic {enc_creds}'})
+                elif url.scheme == 'ftp':
+                    urlstring = urllib.parse.urlunparse(url._replace(netloc=f'{login}:{password}@{url.netloc}'))
+                else:
+                    mlog.warning('Meson is not going to use netrc credentials for protocols other than https/ftp',
+                                 fatal=False)
+
             try:
-                req = urllib.request.Request(urlstring, headers={'User-Agent': f'mesonbuild/{coredata.version}'})
+                req = urllib.request.Request(urlstring, headers=headers)
                 resp = urllib.request.urlopen(req, timeout=REQ_TIMEOUT)
             except urllib.error.URLError as e:
                 mlog.log(str(e))
                 raise WrapException(f'could not get {urlstring} is the internet available?')
-        with contextlib.closing(resp) as resp:
+        with contextlib.closing(resp) as resp, tmpfile as tmpfile:
             try:
                 dlsize = int(resp.info()'Content-Length')
             except TypeError:

_service:tar_scm:meson-0.63.2.tar.gz/mesonbuild/wrap/wraptool.py -> _service:tar_scm:meson-1.0.1.tar.gz/mesonbuild/wrap/wraptool.py Changed

@@ -11,18 +11,19 @@
 # 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.
+from __future__ import annotations
 
-import json
 import sys, os
 import configparser
 import shutil
 import typing as T
 
 from glob import glob
-from urllib.parse import urlparse
-from .wrap import open_wrapdburl, WrapException
+from .wrap import (open_wrapdburl, WrapException, get_releases, get_releases_data,
+                   update_wrap_file, parse_patch_url)
+from pathlib import Path
 
-from .. import mesonlib
+from .. import mesonlib, msubprojects
 
 if T.TYPE_CHECKING:
     import argparse
@@ -48,11 +49,8 @@
     p.add_argument('name')
     p.set_defaults(wrap_func=install)
 
-    p = subparsers.add_parser('update', help='update the project to its newest available release')
-    p.add_argument('--allow-insecure', default=False, action='store_true',
-                   help='Allow insecure server connections.')
-    p.add_argument('name')
-    p.set_defaults(wrap_func=update)
+    p = msubprojects.add_wrap_update_parser(subparsers)
+    p.set_defaults(wrap_func=msubprojects.run)
 
     p = subparsers.add_parser('info', help='show available versions of a project')
     p.add_argument('--allow-insecure', default=False, action='store_true',
@@ -69,9 +67,10 @@
     p.add_argument('project_path')
     p.set_defaults(wrap_func=promote)
 
-def get_releases(allow_insecure: bool) -> T.Dictstr, T.Any:
-    url = open_wrapdburl('https://wrapdb.mesonbuild.com/v2/releases.json', allow_insecure, True)
-    return T.cast('T.Dictstr, T.Any', json.loads(url.read().decode()))
+    p = subparsers.add_parser('update-db', help='Update list of projects available in WrapDB (Since 0.61.0)')
+    p.add_argument('--allow-insecure', default=False, action='store_true',
+                   help='Allow insecure server connections.')
+    p.set_defaults(wrap_func=update_db)
 
 def list_projects(options: 'argparse.Namespace') -> None:
     releases = get_releases(options.allow_insecure)
@@ -113,23 +112,6 @@
         f.write(url.read())
     print(f'Installed {name} version {version} revision {revision}')
 
-def parse_patch_url(patch_url: str) -> T.Tuplestr, str:
-    u = urlparse(patch_url)
-    if u.netloc != 'wrapdb.mesonbuild.com':
-        raise WrapException(f'URL {patch_url} does not seems to be a wrapdb patch')
-    arr = u.path.strip('/').split('/')
-    if arr0 == 'v1':
-        # e.g. https://wrapdb.mesonbuild.com/v1/projects/zlib/1.2.11/5/get_zip
-        return arr-3, arr-2
-    elif arr0 == 'v2':
-        # e.g. https://wrapdb.mesonbuild.com/v2/zlib_1.2.11-5/get_patch
-        tag = arr-2
-        _, version = tag.rsplit('_', 1)
-        version, revision = version.rsplit('-', 1)
-        return version, revision
-    else:
-        raise WrapException(f'Invalid wrapdb URL {patch_url}')
-
 def get_current_version(wrapfile: str) -> T.Tuplestr, str, str, str, T.Optionalstr:
     cp = configparser.ConfigParser(interpolation=None)
     cp.read(wrapfile)
@@ -150,12 +132,6 @@
         patch_filename = wrap_data'patch_filename'
     return branch, revision, wrap_data'directory', wrap_data'source_filename', patch_filename
 
-def update_wrap_file(wrapfile: str, name: str, new_version: str, new_revision: str, allow_insecure: bool) -> None:
-    url = open_wrapdburl(f'https://wrapdb.mesonbuild.com/v2/{name}_{new_version}-{new_revision}/{name}.wrap',
-                         allow_insecure, True)
-    with open(wrapfile, 'wb') as f:
-        f.write(url.read())
-
 def update(options: 'argparse.Namespace') -> None:
     name = options.name
     if not os.path.isdir('subprojects'):
@@ -244,6 +220,12 @@
         else:
             print('', name, f'not up to date. Have {current_branch} {current_revision}, but {latest_branch} {latest_revision} is available.')
 
+def update_db(options: 'argparse.Namespace') -> None:
+    data = get_releases_data(options.allow_insecure)
+    Path('subprojects').mkdir(exist_ok=True)
+    with Path('subprojects/wrapdb.json').open('wb') as f:
+        f.write(data)
+
 def run(options: 'argparse.Namespace') -> int:
     options.wrap_func(options)
     return 0

_service:tar_scm:meson-1.0.1.tar.gz/run_format_tests.py Added

@@ -0,0 +1,82 @@
+#!/usr/bin/env python3
+
+# Copyright 2012-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.
+
+# some simple checks on the file format of:
+# - python code
+# - code samples in tests
+# - markdown documentation
+#
+# checks are:
+# - no use of tabs
+# - no use of DOS line endings
+
+import os
+import re
+from pathlib import Path
+
+def check_file(file: Path) -> None:
+    lines = file.read_bytes().split(b'\n')
+    tabdetector = re.compile(br' *\t')
+    for i, line in enumerate(lines):
+        if re.match(tabdetector, line):
+            raise SystemExit("File {} contains a tab indent on line {:d}. Only spaces are permitted.".format(file, i + 1))
+        if line.endswith(b'\r'):
+            raise SystemExit("File {} contains DOS line ending on line {:d}. Only unix-style line endings are permitted.".format(file, i + 1))
+
+def check_format() -> None:
+    check_suffixes = {'.c',
+                      '.cpp',
+                      '.cxx',
+                      '.cc',
+                      '.rs',
+                      '.f90',
+                      '.vala',
+                      '.d',
+                      '.s',
+                      '.m',
+                      '.mm',
+                      '.asm',
+                      '.java',
+                      '.txt',
+                      '.py',
+                      '.swift',
+                      '.build',
+                      '.md',
+                      }
+    skip_dirs = {
+        '.dub',                         # external deps are here
+        '.pytest_cache',
+        'meson-logs', 'meson-private',
+        'work area',
+        '.eggs', '_cache',              # e.g. .mypy_cache
+        'venv',                         # virtualenvs have DOS line endings
+    }
+    for (root, _, filenames) in os.walk('.'):
+        if any(x in root for x in skip_dirs):
+            continue
+        for fname in filenames:
+            file = Path(fname)
+            if file.suffix.lower() in check_suffixes:
+                if file.name in ('sitemap.txt', 'meson-test-run.txt'):
+                    continue
+                check_file(root / file)
+
+
+if __name__ == '__main__':
+    script_dir = os.path.split(__file__)0
+    if script_dir != '':
+        os.chdir(script_dir)
+    check_format()

_service:tar_scm:meson-0.63.2.tar.gz/run_meson_command_tests.py -> _service:tar_scm:meson-1.0.1.tar.gz/run_meson_command_tests.py Changed

@@ -19,29 +19,44 @@
 import unittest
 import subprocess
 import zipapp
+import sysconfig
 from pathlib import Path
 
 from mesonbuild.mesonlib import windows_proof_rmtree, python_command, is_windows
 from mesonbuild.coredata import version as meson_version
 
-# Handle the scheme that Debian patches in the as default
-import sysconfig
-# This function was renamed and made public in Python 3.10
-if hasattr(sysconfig, 'get_default_scheme'):
-    scheme = sysconfig.get_default_scheme()
-else:
-    scheme = sysconfig._get_default_scheme()
-if scheme == 'posix_local':
-    scheme = 'posix_prefix'
+scheme = None
+
+def needs_debian_path_hack():
+    try:
+        import setuptools
+        return int(setuptools.__version__.split('.')0) < 65
+    except ModuleNotFoundError:
+        return False
+
+if needs_debian_path_hack():
+    # Handle the scheme that Debian patches in the as default
+    # This function was renamed and made public in Python 3.10
+    if hasattr(sysconfig, 'get_default_scheme'):
+        scheme = sysconfig.get_default_scheme()
+    else:
+        scheme = sysconfig._get_default_scheme()
+    if scheme == 'posix_local':
+        scheme = 'posix_prefix'
 
 def get_pypath():
-    pypath = sysconfig.get_path('purelib', scheme=scheme, vars={'base': ''})
+    if scheme:
+        pypath = sysconfig.get_path('purelib', scheme=scheme, vars={'base': ''})
+    else:
+        pypath = sysconfig.get_path('purelib', vars={'base': ''})
     # Ensure that / is the path separator and not \, then strip /
     return Path(pypath).as_posix().strip('/')
 
 def get_pybindir():
     # 'Scripts' on Windows and 'bin' on other platforms including MSYS
-    return sysconfig.get_path('scripts', scheme=scheme, vars={'base': ''}).strip('\\/')
+    if scheme:
+        return sysconfig.get_path('scripts', scheme=scheme, vars={'base': ''}).strip('\\/')
+    return sysconfig.get_path('scripts', vars={'base': ''}).strip('\\/')
 
 class CommandTests(unittest.TestCase):
     '''
@@ -69,7 +84,7 @@
         os.chdir(str(self.orig_dir))
         super().tearDown()
 
-    def _run(self, command, workdir=None):
+    def _run(self, command, workdir=None, env=None):
         '''
         Run a command while printing the stdout, and also return a copy of it
         '''
@@ -77,7 +92,7 @@
         # between CI issue and test bug in that case. Set timeout and fail loud
         # instead.
         p = subprocess.run(command, stdout=subprocess.PIPE,
-                           env=os.environ.copy(), text=True,
+                           env=env, text=True,
                            cwd=workdir, timeout=60 * 5)
         print(p.stdout)
         if p.returncode != 0:
@@ -117,13 +132,17 @@
         bindir = (self.tmpdir / 'bin')
         bindir.mkdir()
         (bindir / 'meson').symlink_to(self.src_root / 'meson.py')
+        (bindir / 'python3').symlink_to(python_command0)
         os.environ'PATH' = str(bindir) + os.pathsep + os.environ'PATH'
+        # use our overridden PATH-compatible python
+        path_resolved_meson_command = resolved_meson_command.copy()
+        path_resolved_meson_command0 = str(bindir / 'python3')
         # See if it works!
         meson_py = 'meson'
         meson_setup = meson_py, 'setup'
         meson_command = meson_setup + self.meson_args
         stdo = self._run(meson_command + self.testdir, builddir)
-        self.assertMesonCommandIs(stdo.split('\n')0, resolved_meson_command)
+        self.assertMesonCommandIs(stdo.split('\n')0, path_resolved_meson_command)
 
     def test_meson_installed(self):
         # Install meson
@@ -191,6 +210,21 @@
         self._run(script.as_posix(), source, '--outfile', target, '--interpreter', python_command0)
         self._run(target.as_posix(), '--help')
 
+    def test_meson_runpython(self):
+        meson_command = str(self.src_root / 'meson.py')
+        script_file = str(self.src_root / 'foo.py')
+        test_command = 'import sys; print(sys.argv1)'
+        env = os.environ.copy()
+        del env'MESON_COMMAND_TESTS'
+        with open(script_file, 'w') as f:
+            f.write('#!/usr/bin/env python3\n\n')
+            f.write(f'{test_command}\n')
+
+        for cmd in '-c', test_command, 'fake argument', script_file, 'fake argument':
+            pyout = self._run(python_command + cmd)
+            mesonout = self._run(python_command + meson_command, 'runpython' + cmd, env=env)
+            self.assertEqual(pyout, mesonout)
+
 
 if __name__ == '__main__':
     print('Meson build system', meson_version, 'Command Tests')

_service:tar_scm:meson-1.0.1.tar.gz/run_mypy.py Added

@@ -0,0 +1,133 @@
+#!/usr/bin/env python3
+
+from pathlib import Path
+import argparse
+import os
+import subprocess
+import sys
+import typing as T
+
+from mesonbuild.mesonlib import version_compare
+
+modules = 
+    # fully typed submodules
+    # 'mesonbuild/ast/',
+    'mesonbuild/cmake/',
+    'mesonbuild/compilers/',
+    'mesonbuild/dependencies/',
+    'mesonbuild/interpreter/primitives/',
+    'mesonbuild/interpreterbase/',
+    'mesonbuild/linkers/',
+    'mesonbuild/scripts/',
+    'mesonbuild/wrap/',
+
+    # specific files
+    'mesonbuild/arglist.py',
+    'mesonbuild/backend/backends.py',
+    # 'mesonbuild/coredata.py',
+    'mesonbuild/depfile.py',
+    'mesonbuild/envconfig.py',
+    'mesonbuild/interpreter/compiler.py',
+    'mesonbuild/interpreter/mesonmain.py',
+    'mesonbuild/interpreter/interpreterobjects.py',
+    'mesonbuild/interpreter/type_checking.py',
+    'mesonbuild/mcompile.py',
+    'mesonbuild/mdevenv.py',
+    'mesonbuild/utils/platform.py',
+    'mesonbuild/utils/universal.py',
+    'mesonbuild/minit.py',
+    'mesonbuild/minstall.py',
+    'mesonbuild/mintro.py',
+    'mesonbuild/mlog.py',
+    'mesonbuild/msubprojects.py',
+    'mesonbuild/modules/external_project.py',
+    'mesonbuild/modules/fs.py',
+    'mesonbuild/modules/gnome.py',
+    'mesonbuild/modules/i18n.py',
+    'mesonbuild/modules/icestorm.py',
+    'mesonbuild/modules/java.py',
+    'mesonbuild/modules/keyval.py',
+    'mesonbuild/modules/modtest.py',
+    'mesonbuild/modules/pkgconfig.py',
+    'mesonbuild/modules/qt.py',
+    'mesonbuild/modules/rust.py',
+    'mesonbuild/modules/sourceset.py',
+    'mesonbuild/modules/wayland.py',
+    'mesonbuild/modules/windows.py',
+    'mesonbuild/mparser.py',
+    'mesonbuild/msetup.py',
+    'mesonbuild/mtest.py',
+    'mesonbuild/optinterpreter.py',
+    'mesonbuild/programs.py',
+
+    'run_mypy.py',
+    'run_project_tests.py',
+    'run_single_test.py',
+    'tools',
+    'docs/genrefman.py',
+    'docs/refman',
+
+
+if os.name == 'posix':
+    modules.append('mesonbuild/utils/posix.py')
+elif os.name == 'nt':
+    modules.append('mesonbuild/utils/win32.py')
+
+def check_mypy() -> None:
+    try:
+        import mypy
+    except ImportError:
+        print('Failed import mypy')
+        sys.exit(1)
+    from mypy.version import __version__ as mypy_version
+    if not version_compare(mypy_version, '>=0.812'):
+        print('mypy >=0.812 is required, older versions report spurious errors')
+        sys.exit(1)
+
+def main() -> int:
+    check_mypy()
+
+    root = Path(__file__).absolute().parent
+    args =   # type: T.Liststr
+
+    parser = argparse.ArgumentParser(description='Process some integers.')
+    parser.add_argument('files', nargs='*')
+    parser.add_argument('-q', '--quiet', action='store_true', help='do not print informational messages')
+    parser.add_argument('-p', '--pretty', action='store_true', help='pretty print mypy errors')
+    parser.add_argument('-C', '--clear', action='store_true', help='clear the terminal before running mypy')
+
+    opts = parser.parse_args()
+    if opts.pretty:
+        args.append('--pretty')
+
+    if opts.clear:
+        print('\x1bc', end='', flush=True)
+
+    to_check =  # type: T.Liststr
+    if opts.files:
+        for f in opts.files:
+            if f in modules:
+                to_check.append(f)
+            elif any(f.startswith(i) for i in modules):
+                to_check.append(f)
+            else:
+                if not opts.quiet:
+                    print(f'skipping {f!r} because it is not yet typed')
+    else:
+        to_check.extend(modules)
+
+    if to_check:
+        if not opts.quiet:
+            print('Running mypy (this can take some time) ...')
+        p = subprocess.run(
+            sys.executable, '-m', 'mypy', '--python-version', '3.10' + args + to_check,
+            cwd=root,
+        )
+        return p.returncode
+    else:
+        if not opts.quiet:
+            print('nothing to do...')
+        return 0
+
+if __name__ == '__main__':
+    sys.exit(main())

_service:tar_scm:meson-0.63.2.tar.gz/run_project_tests.py -> _service:tar_scm:meson-1.0.1.tar.gz/run_project_tests.py Changed

@@ -177,7 +177,15 @@
                 return p
             if self.typ == 'python_lib':
                 return p.with_suffix(python_suffix)
-        if self.typ in 'file', 'dir':
+            if self.typ == 'py_implib':
+                p = p.with_suffix(python_suffix)
+                if env.machines.host.is_windows() and canonical_compiler == 'msvc':
+                    return p.with_suffix('.lib')
+                elif env.machines.host.is_windows() or env.machines.host.is_cygwin():
+                    return p.with_suffix('.dll.a')
+                else:
+                    return None
+        elif self.typ in {'file', 'dir'}:
             return p
         elif self.typ == 'shared_lib':
             if env.machines.host.is_windows() or env.machines.host.is_cygwin():
@@ -211,15 +219,13 @@
             if self.version:
                 p = p.with_name('{}-{}'.format(p.name, self.version0))
             return p.with_suffix('.pdb') if has_pdb else None
-        elif self.typ in {'implib', 'implibempty', 'py_implib'}:
+        elif self.typ in {'implib', 'implibempty'}:
             if env.machines.host.is_windows() and canonical_compiler == 'msvc':
                 # only MSVC doesn't generate empty implibs
                 if self.typ == 'implibempty' and compiler == 'msvc':
                     return None
                 return p.parent / (re.sub(r'^lib', '', p.name) + '.lib')
             elif env.machines.host.is_windows() or env.machines.host.is_cygwin():
-                if self.typ == 'py_implib':
-                    p = p.with_suffix(python_suffix)
                 return p.with_suffix('.dll.a')
             else:
                 return None
@@ -246,7 +252,7 @@
 
 @functools.total_ordering
 class TestDef:
-    def __init__(self, path: Path, name: T.Optionalstr, args: T.Liststr, skip: bool = False):
+    def __init__(self, path: Path, name: T.Optionalstr, args: T.Liststr, skip: bool = False, skip_category: bool = False):
         self.category = path.parts1
         self.path = path
         self.name = name
@@ -256,6 +262,7 @@
         self.installed_files =   # type: T.ListInstalledFile
         self.do_not_set_opts =   # type: T.Liststr
         self.stdout =  # type: T.ListT.Dictstr, str
+        self.skip_category = skip_category
         self.skip_expected = False
 
         # Always print a stack trace for Meson exceptions
@@ -471,7 +478,7 @@
                     sub = r'\\'
                 else:
                     sub = r'\\\\'
-                expected_line = re.sub(r'/(?=.*(WARNING|ERROR))', sub, expected_line)
+                expected_line = re.sub(r'/(?=.*(WARNING|ERROR|DEPRECATION))', sub, expected_line)
 
             m = OutputMatch(how, expected_line, count)
             if count == 0:
@@ -635,7 +642,7 @@
               should_fail: str) -> TestResult:
     gen_start = time.time()
     # Configure in-process
-    gen_args =   # type: T.Liststr
+    gen_args = 'setup'
     if 'prefix' not in test.do_not_set_opts:
         gen_args += '--prefix', 'x:/usr' if mesonlib.is_windows() else '--prefix', '/usr'
     if 'libdir' not in test.do_not_set_opts:
@@ -783,7 +790,7 @@
     return (skip, skip_expected)
 
 
-def load_test_json(t: TestDef, stdout_mandatory: bool) -> T.ListTestDef:
+def load_test_json(t: TestDef, stdout_mandatory: bool, skip_category: bool = False) -> T.ListTestDef:
     all_tests: T.ListTestDef = 
     test_def = {}
     test_def_file = t.path / 'test.json'
@@ -832,15 +839,15 @@
         t.stdout = stdout
         return t
 
-    new_opt_list: T.ListT.ListT.Tuplestr, bool, bool
+    new_opt_list: T.ListT.ListT.Tuplestr, str, bool, bool
 
     # 'matrix; entry is present, so build multiple tests from matrix definition
-    opt_list =   # type: T.ListT.ListT.Tuplestr, bool, bool
+    opt_list =   # type: T.ListT.ListT.Tuplestr, str, bool, bool
     matrix = test_def'matrix'
     assert "options" in matrix
     for key, val in matrix"options".items():
         assert isinstance(val, list)
-        tmp_opts =   # type: T.ListT.Tuplestr, bool, bool
+        tmp_opts =   # type: T.ListT.Tuplestr, str, bool, bool
         for i in val:
             assert isinstance(i, dict)
             assert "val" in i
@@ -856,10 +863,10 @@
 
             # Add an empty matrix entry
             if i'val' is None:
-                tmp_opts += (None, skip, skip_expected)
+                tmp_opts += (key, None, skip, skip_expected)
                 continue
 
-            tmp_opts += ('{}={}'.format(key, i'val'), skip, skip_expected)
+            tmp_opts += (key, i'val', skip, skip_expected)
 
         if opt_list:
             new_opt_list = 
@@ -876,10 +883,10 @@
         new_opt_list = 
         for i in opt_list:
             exclude = False
-            opt_names = x0 for x in i
+            opt_tuple = (x0, x1) for x in i
             for j in matrix'exclude':
-                ex_list = f'{k}={v}' for k, v in j.items()
-                if all(x in opt_names for x in ex_list):
+                ex_list = (k, v) for k, v in j.items()
+                if all(x in opt_tuple for x in ex_list):
                     exclude = True
                     break
 
@@ -889,11 +896,11 @@
         opt_list = new_opt_list
 
     for i in opt_list:
-        name = ' '.join(x0 for x in i if x0 is not None)
-        opts = '-D' + x0 for x in i if x0 is not None
-        skip = any(x1 for x in i)
-        skip_expected = any(x2 for x in i)
-        test = TestDef(t.path, name, opts, skip or t.skip)
+        name = ' '.join(f'{x0}={x1}' for x in i if x1 is not None)
+        opts = f'-D{x0}={x1}' for x in i if x1 is not None
+        skip = any(x2 for x in i)
+        skip_expected = any(x3 for x in i)
+        test = TestDef(t.path, name, opts, skip or t.skip, skip_category)
         test.env.update(env)
         test.installed_files = installed
         test.do_not_set_opts = do_not_set_opts
@@ -904,7 +911,7 @@
     return all_tests
 
 
-def gather_tests(testdir: Path, stdout_mandatory: bool, only: T.Liststr) -> T.ListTestDef:
+def gather_tests(testdir: Path, stdout_mandatory: bool, only: T.Liststr, skip_category: bool) -> T.ListTestDef:
     all_tests: T.ListTestDef = 
     for t in testdir.iterdir():
         # Filter non-tests files (dot files, etc)
@@ -912,8 +919,8 @@
             continue
         if only and not any(t.name.startswith(prefix) for prefix in only):
             continue
-        test_def = TestDef(t, None, )
-        all_tests.extend(load_test_json(test_def, stdout_mandatory))
+        test_def = TestDef(t, None, , skip_category=skip_category)
+        all_tests.extend(load_test_json(test_def, stdout_mandatory, skip_category))
     return sorted(all_tests)
 
 
@@ -1059,7 +1066,8 @@
                        shutil.which('flang') or
                        shutil.which('pgfortran') or
                        shutil.which('nagfor') or
-                       shutil.which('ifort'))
+                       shutil.which('ifort') or
+                       shutil.which('ifx'))
 
     skip_cmake = ((os.environ.get('compiler') == 'msvc2015' and under_ci) or
                   'cmake' not in tool_vers_map or
@@ -1084,7 +1092,7 @@
         TestCategory('platform-osx', 'osx', not mesonlib.is_osx()),
         TestCategory('platform-windows', 'windows', not mesonlib.is_windows() and not mesonlib.is_cygwin()),
         TestCategory('platform-linux', 'linuxlike', mesonlib.is_osx() or mesonlib.is_windows()),
-        TestCategory('java', 'java', backend is not Backend.ninja or mesonlib.is_osx() or not have_java()),
+        TestCategory('java', 'java', backend is not Backend.ninja or not have_java()),
         TestCategory('C#', 'csharp', skip_csharp(backend)),
         TestCategory('vala', 'vala', backend is not Backend.ninja or not shutil.which(os.environ.get('VALAC', 'valac'))),
         TestCategory('cython', 'cython', backend is not Backend.ninja or not shutil.which(os.environ.get('CYTHON', 'cython'))),
@@ -1096,7 +1104,7 @@
         TestCategory('swift', 'swift', backend not in (Backend.ninja, Backend.xcode) or not shutil.which('swiftc')),
         # CUDA tests on Windows: use Ninja backend:  python run_project_tests.py --only cuda --backend ninja
         TestCategory('cuda', 'cuda', backend not in (Backend.ninja, Backend.xcode) or not shutil.which('nvcc')),
-        TestCategory('python3', 'python3', backend is not Backend.ninja),
+        TestCategory('python3', 'python3', backend is not Backend.ninja or 'python3' not in sys.executable),
         TestCategory('python', 'python'),
         TestCategory('fpga', 'fpga', shutil.which('yosys') is None),
         TestCategory('frameworks', 'frameworks'),
@@ -1113,7 +1121,7 @@
             assert key in categories, f'key `{key}` is not a recognized category'
         all_tests = t for t in all_tests if t.category in only.keys()
 
-    gathered_tests = (t.category, gather_tests(Path('test cases', t.subdir), t.stdout_mandatory, onlyt.category), t.skip) for t in all_tests
+    gathered_tests = (t.category, gather_tests(Path('test cases', t.subdir), t.stdout_mandatory, onlyt.category, t.skip), t.skip) for t in all_tests
     return gathered_tests
 
 def run_tests(all_tests: T.ListT.Tuplestr, T.ListTestDef, bool,
@@ -1315,7 +1323,8 @@
 
         if is_skipped and skip_as_expected:
             f.update_log(TestStatus.SKIP)
-            safe_print(bold('Reason:'), skip_reason)
+            if not t.skip_category:
+                safe_print(bold('Reason:'), skip_reason)
             current_test = ET.SubElement(current_suite, 'testcase', {'name': testname, 'classname': t.category})
             ET.SubElement(current_test, 'skipped', {})
             continue
@@ -1323,7 +1332,7 @@
         if not skip_as_expected:
             failing_tests += 1
             if is_skipped:
-                skip_msg = 'Test asked to be skipped, but was not expected to'
+                skip_msg = f'Test asked to be skipped ({skip_reason}), but was not expected to'
                 status = TestStatus.UNEXSKIP
             else:
                 skip_msg = 'Test ran, but was expected to be skipped'
@@ -1331,6 +1340,7 @@
             result.msg = f"{skip_msg} for MESON_CI_JOBNAME '{ci_jobname}'"
 
             f.update_log(status)
+            safe_print(bold('Reason:'), result.msg)
             current_test = ET.SubElement(current_suite, 'testcase', {'name': testname, 'classname': t.category})
             ET.SubElement(current_test, 'failure', {'message': result.msg})
             continue
@@ -1406,7 +1416,7 @@
     meson_commands = mesonlib.python_command + get_meson_script()
     with TemporaryDirectoryWinProof(prefix='b ', dir=None if use_tmpdir else '.') as build_dir:
         print('Checking that configuring works...')
-        gen_cmd = meson_commands + testdir, build_dir + backend_flags + extra_args
+        gen_cmd = meson_commands + 'setup' , testdir, build_dir + backend_flags + extra_args
         pc, o, e = Popen_safe(gen_cmd)
         if pc.returncode != 0:
             raise RuntimeError(f'Failed to configure {testdir!r}:\n{e}\n{o}')
@@ -1581,7 +1591,7 @@
     clear_transitive_files()
 
     print('Meson build system', meson_version, 'Project Tests')
-    print('Using python', sys.version.split('\n')0)
+    print('Using python', sys.version.split('\n')0, f'({sys.executable!r})')
     if 'VSCMD_VER' in os.environ:
         print('VSCMD version', os.environ'VSCMD_VER')
     setup_commands(options.backend)

_service:tar_scm:meson-1.0.1.tar.gz/run_single_test.py Added

@@ -0,0 +1,105 @@
+#!/usr/bin/env python3
+# SPDX-license-identifier: Apache-2.0
+# Copyright © 2021 Intel Corporation
+
+"""Script for running a single project test.
+
+This script is meant for Meson developers who want to run a single project
+test, with all of the rules from the test.json file loaded.
+"""
+
+import argparse
+import pathlib
+import typing as T
+
+from mesonbuild import mlog
+from run_project_tests import TestDef, load_test_json, run_test, BuildStep, test_emits_skip_msg
+from run_project_tests import setup_commands, detect_system_compiler, print_tool_versions
+
+if T.TYPE_CHECKING:
+    from run_project_tests import CompilerArgumentType
+
+    class ArgumentType(CompilerArgumentType):
+
+        """Typing information for command line arguments."""
+
+        case: pathlib.Path
+        subtests: T.Listint
+        backend: str
+        extra_args: T.Liststr
+
+
+def main() -> None:
+    parser = argparse.ArgumentParser()
+    parser.add_argument('case', type=pathlib.Path, help='The test case to run')
+    parser.add_argument('extra_args', nargs='*',
+                        help='arguments that are passed directly to Meson (remember to have -- before these).')
+    parser.add_argument('--subtest', type=int, action='append', dest='subtests', help='which subtests to run')
+    parser.add_argument('--backend', action='store', help="Which backend to use")
+    parser.add_argument('--cross-file', action='store', help='File describing cross compilation environment.')
+    parser.add_argument('--native-file', action='store', help='File describing native compilation environment.')
+    parser.add_argument('--use-tmpdir', action='store_true', help='Use tmp directory for temporary files.')
+    args = T.cast('ArgumentType', parser.parse_args())
+
+    setup_commands(args.backend)
+    detect_system_compiler(args)
+    print_tool_versions()
+
+    test = TestDef(args.case, args.case.stem, )
+    tests = load_test_json(test, False)
+    if args.subtests:
+        tests = t for i, t in enumerate(tests) if i in args.subtests
+
+    def should_fail(path: pathlib.Path) -> str:
+        dir_ = path.parent.stem
+        # FIXME: warning tets might not be handled correctly still…
+        if dir_.startswith(('failing', 'warning')):
+            if ' ' in dir_:
+                return dir_.split(' ')1
+            return 'meson'
+        return ''
+
+    results = run_test(t, t.args + args.extra_args, should_fail(t.path), args.use_tmpdir) for t in tests
+    failed = False
+    for test, result in zip(tests, results):
+        if result is None:
+            is_skipped = True
+            skip_reason = 'not run because preconditions were not met'
+        else:
+            for l in result.stdo.splitlines():
+                if test_emits_skip_msg(l):
+                    is_skipped = True
+                    offset = l.index('MESON_SKIP_TEST') + 16
+                    skip_reason = loffset:.strip()
+                    break
+            else:
+                is_skipped = False
+                skip_reason = ''
+
+        if is_skipped:
+            msg = mlog.yellow('SKIP:')
+        elif result.msg:
+            msg = mlog.red('FAIL:')
+            failed = True
+        else:
+            msg = mlog.green('PASS:')
+        mlog.log(msg, *test.display_name())
+        if skip_reason:
+            mlog.log(mlog.bold('Reason:'), skip_reason)
+        if result is not None and result.msg and 'MESON_SKIP_TEST' not in result.stdo:
+            mlog.log('reason:', result.msg)
+            if result.step is BuildStep.configure:
+                # For configure failures, instead of printing stdout,
+                # print the meson log if available since it's a superset
+                # of stdout and often has very useful information.
+                mlog.log(result.mlog)
+            else:
+                mlog.log(result.stdo)
+            for cmd_res in result.cicmds:
+                mlog.log(cmd_res)
+            mlog.log(result.stde)
+
+    exit(1 if failed else 0)
+
+if __name__ == "__main__":
+    main()

_service:tar_scm:meson-0.63.2.tar.gz/run_tests.py -> _service:tar_scm:meson-1.0.1.tar.gz/run_tests.py Changed

@@ -34,7 +34,8 @@
 from unittest import mock
 import typing as T
 
-from mesonbuild import compilers
+from mesonbuild.compilers.c import CCompiler
+from mesonbuild.compilers.detect import detect_c_compiler
 from mesonbuild import dependencies
 from mesonbuild import mesonlib
 from mesonbuild import mesonmain
@@ -75,6 +76,15 @@
 os.environ'PYTHONWARNDEFAULTENCODING' = '1'
 # work around https://bugs.python.org/issue34624
 os.environ'MESON_RUNNING_IN_PROJECT_TESTS' = '1'
+# python 3.11 adds a warning that in 3.15, UTF-8 mode will be default.
+# This is fantastic news, we'd love that. Less fantastic: this warning is silly,
+# we *want* these checks to be affected. Plus, the recommended alternative API
+# would (in addition to warning people when UTF-8 mode removed the problem) also
+# require using a minimum python version of 3.11 (in which the warning was added)
+# or add verbose if/else soup.
+if sys.version_info >= (3, 10):
+    import warnings
+    warnings.filterwarnings('ignore', message="UTF-8 Mode affects .*getpreferredencoding", category=EncodingWarning)
 
 def guess_backend(backend_str: str, msbuild_exe: str) -> T.Tuple'Backend', T.Liststr:
     # Auto-detect backend if unspecified
@@ -160,7 +170,7 @@
     Useful for running compiler checks in the unit tests.
     '''
     env = get_fake_env('', bdir, prefix)
-    cc = compilers.detect_c_compiler(env, mesonlib.MachineChoice.HOST)
+    cc = detect_c_compiler(env, mesonlib.MachineChoice.HOST)
     # Detect machine info
     env.machines.host = detect_machine_info({'c':cc})
     return (env, cc)
@@ -290,8 +300,8 @@
     return returncode, stdout.getvalue()
 
 def clear_meson_configure_class_caches() -> None:
-    compilers.CCompiler.find_library_cache = {}
-    compilers.CCompiler.find_framework_cache = {}
+    CCompiler.find_library_cache = {}
+    CCompiler.find_framework_cache = {}
     dependencies.PkgConfigDependency.pkgbin_cache = {}
     dependencies.PkgConfigDependency.class_pkgbin = mesonlib.PerMachine(None, None)
     mesonlib.project_meson_versions = collections.defaultdict(str)
@@ -333,6 +343,10 @@
     print('')
     print(flush=True)
 
+def subprocess_call(cmd, **kwargs):
+    print(f'$ {mesonlib.join_args(cmd)}')
+    return subprocess.call(cmd, **kwargs)
+
 def main():
     print_system_info()
     parser = argparse.ArgumentParser()
@@ -370,7 +384,7 @@
         cmd = mesonlib.python_command + 'run_meson_command_tests.py', '-v'
         if options.failfast:
             cmd += '--failfast'
-        returncode += subprocess.call(cmd, env=env)
+        returncode += subprocess_call(cmd, env=env)
         if options.failfast and returncode != 0:
             return returncode
         if no_unittests:
@@ -383,11 +397,11 @@
             cmd = mesonlib.python_command + 'run_unittests.py', '--backend=' + backend.name, '-v'
             if options.failfast:
                 cmd += '--failfast'
-            returncode += subprocess.call(cmd, env=env)
+            returncode += subprocess_call(cmd, env=env)
             if options.failfast and returncode != 0:
                 return returncode
         cmd = mesonlib.python_command + 'run_project_tests.py' + sys.argv1:
-        returncode += subprocess.call(cmd, env=env)
+        returncode += subprocess_call(cmd, env=env)
     else:
         cross_test_args = mesonlib.python_command + 'run_cross_test.py'
         for cf in options.cross:
@@ -398,7 +412,7 @@
                 cmd += '--failfast'
             if options.cross_only:
                 cmd += '--cross-only'
-            returncode += subprocess.call(cmd, env=env)
+            returncode += subprocess_call(cmd, env=env)
             if options.failfast and returncode != 0:
                 return returncode
     return returncode

_service:tar_scm:meson-0.63.2.tar.gz/setup.cfg -> _service:tar_scm:meson-1.0.1.tar.gz/setup.cfg Changed

@@ -5,29 +5,30 @@
 author = Jussi Pakkanen
 author_email = jpakkane@gmail.com
 url = https://mesonbuild.com
-keywords = 
-	meson
-	mesonbuild
-	build system
-	cmake
+keywords =
+  meson
+  mesonbuild
+  build system
+  cmake
 license = Apache License, Version 2.0
 license_file = COPYING
-classifiers = 
-	Development Status :: 5 - Production/Stable
-	Environment :: Console
-	Intended Audience :: Developers
-	License :: OSI Approved :: Apache Software License
-	Natural Language :: English
-	Operating System :: MacOS :: MacOS X
-	Operating System :: Microsoft :: Windows
-	Operating System :: POSIX :: BSD
-	Operating System :: POSIX :: Linux
-	Programming Language :: Python :: 3 :: Only
-	Programming Language :: Python :: 3.7
-	Programming Language :: Python :: 3.8
-	Programming Language :: Python :: 3.9
-	Programming Language :: Python :: 3.10
-	Topic :: Software Development :: Build Tools
+classifiers =
+  Development Status :: 5 - Production/Stable
+  Environment :: Console
+  Intended Audience :: Developers
+  License :: OSI Approved :: Apache Software License
+  Natural Language :: English
+  Operating System :: MacOS :: MacOS X
+  Operating System :: Microsoft :: Windows
+  Operating System :: POSIX :: BSD
+  Operating System :: POSIX :: Linux
+  Programming Language :: Python :: 3 :: Only
+  Programming Language :: Python :: 3.7
+  Programming Language :: Python :: 3.8
+  Programming Language :: Python :: 3.9
+  Programming Language :: Python :: 3.10
+  Programming Language :: Python :: 3.11
+  Topic :: Software Development :: Build Tools
 long_description = Meson is a cross-platform build system designed to be both as fast and as user friendly as possible. It supports many languages and compilers, including GCC, Clang, PGI, Intel, and Visual Studio. Its build definitions are written in a simple non-Turing complete DSL.
 
 options
@@ -35,18 +36,19 @@
 python_requires = >= 3.7
 
 options.entry_points
-console_scripts = 
-	meson = mesonbuild.mesonmain:main
+console_scripts =
+  meson = mesonbuild.mesonmain:main
 
 options.extras_require
-ninja = 
-	ninja>=1.8.2
-progress = 
-	tqdm
-typing = 
-	mypy
-	typing_extensions; python_version <"3.8"
-
+ninja =
+  ninja>=1.8.2
+progress =
+  tqdm
+typing =
+  mypy
+  typing_extensions; python_version <"3.8"
+
+# this must be synced with packaging/hook-mesonbuild.py
 options.package_data
 mesonbuild.scripts = cmd_or_ps.ps1
 mesonbuild.cmake.data = *
@@ -56,11 +58,6 @@
 include = mesonbuild, mesonbuild.*
 
 tool:pytest
-python_classes = 
-python_files = 
-	run_unittests.py
-
-egg_info
-tag_build = 
-tag_date = 0
-
+python_classes =
+python_files =
+    run_unittests.py

_service:tar_scm:meson-1.0.1.tar.gz/sider.yml Added

_service:tar_scm:meson-1.0.1.tar.gz/skip_ci.py Added

@@ -0,0 +1,76 @@
+#!/usr/bin/env python3
+# 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 argparse
+import os
+import subprocess
+import sys
+import traceback
+
+
+def check_pr(is_pr_env):
+    if is_pr_env not in os.environ:
+        print(f'This is not pull request: {is_pr_env} is not set')
+        sys.exit()
+    elif os.environis_pr_env == 'false':
+        print(f'This is not pull request: {is_pr_env} is false')
+        sys.exit()
+
+
+def get_base_branch(base_env):
+    if base_env not in os.environ:
+        print(f'Unable to determine base branch: {base_env} is not set')
+        sys.exit()
+    return os.environbase_env
+
+
+def get_git_files(base):
+    diff = subprocess.check_output('git', 'diff', '--name-only', base + '...HEAD')
+    return diff.strip().split(b'\n')
+
+
+def is_documentation(filename):
+    return filename.startswith(b'docs/')
+
+
+def main():
+    try:
+        parser = argparse.ArgumentParser(description='CI Skipper')
+        parser.add_argument('--base-branch-env', required=True,
+                            help='Branch push is targeted to')
+        parser.add_argument('--is-pull-env', required=True,
+                            help='Variable set if it is a PR')
+        parser.add_argument('--base-branch-origin', action='store_true',
+                            help='Base branch reference is only in origin remote')
+        args = parser.parse_args()
+        check_pr(args.is_pull_env)
+        base = get_base_branch(args.base_branch_env)
+        if args.base_branch_origin:
+            base = 'origin/' + base
+        if all(is_documentation(f) for f in get_git_files(base)):
+            print("Documentation change, CI skipped.")
+            sys.exit(1)
+    except Exception:
+        # If this script fails we want build to proceed.
+        # Failure likely means some corner case we did not consider or bug.
+        # Either case this should not prevent CI from running if it is needed,
+        # and we tolerate it if it is run where it is not required.
+        traceback.print_exc()
+        print('There is a BUG in skip_ci.py, exiting.')
+        sys.exit()
+
+if __name__ == '__main__':
+    main()

_service:tar_scm:meson-0.63.2.tar.gz/test cases/common/10 man install/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/common/10 man install/meson.build Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/common/101 testframework options/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/common/101 testframework options/meson.build Changed

_service:tar_scm:meson-1.0.1.tar.gz/test cases/common/105 generatorcustom/gen.c Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/common/105 generatorcustom/host.c Added

_service:tar_scm:meson-0.63.2.tar.gz/test cases/common/105 generatorcustom/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/common/105 generatorcustom/meson.build Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/common/106 multiple dir configure file/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/common/106 multiple dir configure file/meson.build Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/common/108 ternary/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/common/108 ternary/meson.build Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/common/109 custom target capture/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/common/109 custom target capture/meson.build Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/common/111 pathjoin/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/common/111 pathjoin/meson.build Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/common/113 interpreter copy mutable var on assignment/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/common/113 interpreter copy mutable var on assignment/meson.build Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/common/114 skip/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/common/114 skip/meson.build Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/common/12 data/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/common/12 data/meson.build Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/common/123 custom target directory install/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/common/123 custom target directory install/meson.build Changed

_service:tar_scm:meson-1.0.1.tar.gz/test cases/common/13 pch/linkwhole Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/common/13 pch/linkwhole/lib1.c Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/common/13 pch/linkwhole/lib2.c Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/common/13 pch/linkwhole/main.c Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/common/13 pch/linkwhole/meson.build Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/common/13 pch/linkwhole/pch1 Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/common/13 pch/linkwhole/pch1/pch_one.h Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/common/13 pch/linkwhole/pch2 Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/common/13 pch/linkwhole/pch2/pch_two.h Added

_service:tar_scm:meson-0.63.2.tar.gz/test cases/common/13 pch/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/common/13 pch/meson.build Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/common/132 get define/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/common/132 get define/meson.build Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/common/136 empty build file/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/common/136 empty build file/meson.build Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/common/139 mesonintrospect from scripts/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/common/139 mesonintrospect from scripts/meson.build Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/common/14 configure file/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/common/14 configure file/meson.build Changed

@@ -1,4 +1,6 @@
-project('configure file test', 'c', meson_version: '>=0.47.0')
+project('configure file test', 'c', meson_version: '>=0.63.0')
+
+fs = import('fs')
 
 conf = configuration_data()
 
@@ -188,6 +190,9 @@
 endif
 # Now the same, but using a File object as an argument.
 inf2 = files('invalid-utf8.bin.in')0
+outf = configure_file(input : inf2,
+  output : 'invalid-utf8.bin',
+  copy: true)
 ret = run_command(check_file, inf2, outf, check: false)
 if ret.returncode() != 0
   error('Error running command: @0@\n@1@'.format(ret.stdout(), ret.stderr()))
@@ -202,6 +207,25 @@
   error('Error running command: @0@\n@1@'.format(ret.stdout(), ret.stderr()))
 endif
 
+# Test the fs replacement
+# Test copying of an empty configuration data object
+inf = 'invalid-utf8.bin.in'
+outf = fs.copyfile(inf, 'invalid-utf8-1.bin',
+  install: true,
+  install_dir: get_option('datadir') / meson.project_name(),
+  install_tag: 'copyfile',
+)
+test('fs.copyfile string', check_file, args: files(inf), outf)
+
+# Test with default outname of string
+outf = fs.copyfile(inf)
+test('fs.copyfile default name', check_file, args: files(inf), outf)
+
+# Now the same, but using a File object as an argument.
+inf2 = files('invalid-utf8.bin.in')0
+outf = fs.copyfile(inf2, 'invalid-utf8-2.bin')
+test('fs.copyfile file', check_file, args: inf2, outf)
+
 # Test non isolatin1 encoded input file which fails to decode with utf-8
 conf8 = configuration_data()
 conf8.set('var', 'foo')

_service:tar_scm:meson-0.63.2.tar.gz/test cases/common/14 configure file/test.json -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/common/14 configure file/test.json Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/common/140 custom target multiple outputs/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/common/140 custom target multiple outputs/meson.build Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/common/143 list of file sources/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/common/143 list of file sources/meson.build Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/common/16 comparison/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/common/16 comparison/meson.build Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/common/162 subdir if_found/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/common/162 subdir if_found/meson.build Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/common/163 default options prefix dependent defaults/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/common/163 default options prefix dependent defaults/meson.build Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/common/166 yield/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/common/166 yield/meson.build Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/common/166 yield/subprojects/sub/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/common/166 yield/subprojects/sub/meson.build Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/common/176 subproject version/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/common/176 subproject version/meson.build Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/common/176 subproject version/subprojects/a/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/common/176 subproject version/subprojects/a/meson.build Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/common/177 subdir_done/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/common/177 subdir_done/meson.build Changed

_service:tar_scm:meson-1.0.1.tar.gz/test cases/common/178 bothlibraries/foo.cpp Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/common/178 bothlibraries/main2.c Added

_service:tar_scm:meson-0.63.2.tar.gz/test cases/common/178 bothlibraries/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/common/178 bothlibraries/meson.build Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/common/190 install_mode/test.json -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/common/190 install_mode/test.json Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/common/191 subproject array version/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/common/191 subproject array version/meson.build Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/common/191 subproject array version/subprojects/foo/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/common/191 subproject array version/subprojects/foo/meson.build Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/common/193 feature option disabled/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/common/193 feature option disabled/meson.build Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/common/202 custom target build by default/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/common/202 custom target build by default/meson.build Changed

_service:tar_scm:meson-1.0.1.tar.gz/test cases/common/215 source set realistic example/dummy.cpp Added

_service:tar_scm:meson-0.63.2.tar.gz/test cases/common/215 source set realistic example/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/common/215 source set realistic example/meson.build Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/common/217 test priorities/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/common/217 test priorities/meson.build Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/common/230 external project/libfoo/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/common/230 external project/libfoo/meson.build Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/common/232 dependency allow_fallback/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/common/232 dependency allow_fallback/meson.build Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/common/237 fstrings/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/common/237 fstrings/meson.build Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/common/238 dependency include_type inconsistency/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/common/238 dependency include_type inconsistency/meson.build Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/common/238 dependency include_type inconsistency/subprojects/baz/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/common/238 dependency include_type inconsistency/subprojects/baz/meson.build Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/common/238 dependency include_type inconsistency/subprojects/foo/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/common/238 dependency include_type inconsistency/subprojects/foo/meson.build Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/common/239 includedir violation/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/common/239 includedir violation/meson.build Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/common/239 includedir violation/subprojects/sub/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/common/239 includedir violation/subprojects/sub/meson.build Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/common/240 dependency native host == build/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/common/240 dependency native host == build/meson.build Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/common/242 custom target feed/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/common/242 custom target feed/meson.build Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/common/246 dependency fallbacks/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/common/246 dependency fallbacks/meson.build Changed

_service:tar_scm:meson-1.0.1.tar.gz/test cases/common/252 install data structured Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/common/252 install data structured/dir1 Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/common/252 install data structured/dir1/bad Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/common/252 install data structured/dir1/file1 Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/common/252 install data structured/dir1/file2 Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/common/252 install data structured/dir1/file3 Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/common/252 install data structured/dir2 Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/common/252 install data structured/dir2/bad Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/common/252 install data structured/dir2/file1 Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/common/252 install data structured/dir2/file2 Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/common/252 install data structured/dir2/file3 Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/common/252 install data structured/dir3 Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/common/252 install data structured/dir3/bad Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/common/252 install data structured/dir3/file1 Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/common/252 install data structured/dir3/file2 Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/common/252 install data structured/dir3/file3 Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/common/252 install data structured/meson.build Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/common/252 install data structured/pysrc Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/common/252 install data structured/pysrc/__init__.py Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/common/252 install data structured/pysrc/bad.py Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/common/252 install data structured/pysrc/bar.py Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/common/252 install data structured/pysrc/foo.py Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/common/252 install data structured/pysrc/meson.build Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/common/252 install data structured/pysrc/submod Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/common/252 install data structured/pysrc/submod/__init__.py Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/common/252 install data structured/pysrc/submod/bad.py Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/common/252 install data structured/pysrc/submod/baz.py Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/common/252 install data structured/test.json Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/common/253 subproject dependency variables Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/common/253 subproject dependency variables/meson.build Changed

_service:tar_scm:meson-1.0.1.tar.gz/test cases/common/253 subproject dependency variables/subprojects Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/common/253 subproject dependency variables/subprojects/subfiles Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/common/253 subproject dependency variables/subprojects/subfiles/foo.c Changed

_service:tar_scm:meson-1.0.1.tar.gz/test cases/common/253 subproject dependency variables/subprojects/subfiles/meson.build Changed

_service:tar_scm:meson-1.0.1.tar.gz/test cases/common/253 subproject dependency variables/subprojects/subfiles/subdir Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/common/253 subproject dependency variables/subprojects/subfiles/subdir/foo.c Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/common/253 subproject dependency variables/subprojects/subfiles/subdir2 Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/common/253 subproject dependency variables/subprojects/subfiles/subdir2/foo.c Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/common/253 subproject dependency variables/test.json Changed

_service:tar_scm:meson-1.0.1.tar.gz/test cases/common/254 long output Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/common/254 long output/dumper.c Changed

_service:tar_scm:meson-1.0.1.tar.gz/test cases/common/254 long output/meson.build Changed

_service:tar_scm:meson-1.0.1.tar.gz/test cases/common/255 module warnings Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/common/255 module warnings/meson.build Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/common/255 module warnings/test.json Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/common/256 subproject extracted objects Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/common/256 subproject extracted objects/foo.c Changed

_service:tar_scm:meson-1.0.1.tar.gz/test cases/common/256 subproject extracted objects/meson.build Changed

_service:tar_scm:meson-1.0.1.tar.gz/test cases/common/256 subproject extracted objects/subprojects Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/common/256 subproject extracted objects/subprojects/myobjects Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/common/256 subproject extracted objects/subprojects/myobjects/cpplib.cpp Changed

_service:tar_scm:meson-1.0.1.tar.gz/test cases/common/256 subproject extracted objects/subprojects/myobjects/cpplib.h Changed

_service:tar_scm:meson-1.0.1.tar.gz/test cases/common/256 subproject extracted objects/subprojects/myobjects/meson.build Changed

_service:tar_scm:meson-1.0.1.tar.gz/test cases/common/256 subproject extracted objects/test.json Changed

_service:tar_scm:meson-1.0.1.tar.gz/test cases/common/257 generated header dep Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/common/257 generated header dep/foo.c Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/common/257 generated header dep/meson.build Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/common/258 subsubproject inplace Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/common/258 subsubproject inplace/meson.build Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/common/258 subsubproject inplace/subprojects Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/common/258 subsubproject inplace/subprojects/sub Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/common/258 subsubproject inplace/subprojects/sub/meson.build Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/common/258 subsubproject inplace/subprojects/sub/subprojects Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/common/258 subsubproject inplace/subprojects/sub/subprojects/subsub-1.0 Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/common/258 subsubproject inplace/subprojects/sub/subprojects/subsub-1.0/meson.build Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/common/258 subsubproject inplace/subprojects/sub/subprojects/subsub.wrap Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/common/259 preprocess Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/common/259 preprocess/bar.c Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/common/259 preprocess/foo.c Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/common/259 preprocess/foo.h Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/common/259 preprocess/meson.build Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/common/259 preprocess/src Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/common/259 preprocess/src/file.map.in Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/common/259 preprocess/src/meson.build Added

_service:tar_scm:meson-0.63.2.tar.gz/test cases/common/26 find program/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/common/26 find program/meson.build Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/common/34 logic ops/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/common/34 logic ops/meson.build Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/common/35 string operations/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/common/35 string operations/meson.build Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/common/43 subproject options/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/common/43 subproject options/meson.build Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/common/43 subproject options/subprojects/subproject/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/common/43 subproject options/subprojects/subproject/meson.build Changed

_service:tar_scm:meson-1.0.1.tar.gz/test cases/common/44 pkgconfig-gen/dependencies/dummy.c Added

_service:tar_scm:meson-0.63.2.tar.gz/test cases/common/44 pkgconfig-gen/dependencies/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/common/44 pkgconfig-gen/dependencies/meson.build Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/common/44 pkgconfig-gen/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/common/44 pkgconfig-gen/meson.build Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/common/44 pkgconfig-gen/test.json -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/common/44 pkgconfig-gen/test.json Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/common/49 custom target/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/common/49 custom target/meson.build Changed

_service:tar_scm:meson-1.0.1.tar.gz/test cases/common/51 run target/.clang-format Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/common/51 run target/.clang-tidy Added

_service:tar_scm:meson-0.63.2.tar.gz/test cases/common/51 run target/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/common/51 run target/meson.build Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/common/56 array methods/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/common/56 array methods/meson.build Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/common/59 install subdir/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/common/59 install subdir/meson.build Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/common/61 number arithmetic/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/common/61 number arithmetic/meson.build Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/common/62 string arithmetic/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/common/62 string arithmetic/meson.build Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/common/63 array arithmetic/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/common/63 array arithmetic/meson.build Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/common/64 arithmetic bidmas/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/common/64 arithmetic bidmas/meson.build Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/common/67 modules/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/common/67 modules/meson.build Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/common/69 configure file in custom target/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/common/69 configure file in custom target/meson.build Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/common/70 external test program/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/common/70 external test program/meson.build Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/common/71 ctarget dependency/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/common/71 ctarget dependency/meson.build Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/common/84 plusassign/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/common/84 plusassign/meson.build Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/common/85 skip subdir/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/common/85 skip subdir/meson.build Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/common/94 threads/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/common/94 threads/meson.build Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/common/94 threads/threadprog.c -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/common/94 threads/threadprog.c Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/common/97 find program path/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/common/97 find program path/meson.build Changed

_service:tar_scm:meson-1.0.1.tar.gz/test cases/cython/2 generated sources/includestuff.pyx Added

_service:tar_scm:meson-0.63.2.tar.gz/test cases/cython/2 generated sources/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/cython/2 generated sources/meson.build Changed

_service:tar_scm:meson-1.0.1.tar.gz/test cases/cython/2 generated sources/simpleinclude.pyx Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/cython/2 generated sources/simplestuff.pxi Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/cython/2 generated sources/stuff.pxi.in Added

_service:tar_scm:meson-0.63.2.tar.gz/test cases/failing/10 out of bounds/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/failing/10 out of bounds/meson.build Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/failing/101 number in combo/test.json -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/failing/101 number in combo/test.json Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/failing/104 no fallback/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/failing/104 no fallback/meson.build Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/failing/105 feature require/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/failing/105 feature require/meson.build Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/failing/106 feature require.bis/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/failing/106 feature require.bis/meson.build Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/failing/108 enter subdir twice/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/failing/108 enter subdir twice/meson.build Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/failing/109 invalid fstring/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/failing/109 invalid fstring/meson.build Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/failing/11 object arithmetic/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/failing/11 object arithmetic/meson.build Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/failing/111 empty fallback/test.json -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/failing/111 empty fallback/test.json Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/failing/112 cmake executable dependency/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/failing/112 cmake executable dependency/meson.build Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/failing/12 string arithmetic/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/failing/12 string arithmetic/meson.build Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/failing/122 cmake subproject error/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/failing/122 cmake subproject error/meson.build Changed

_service:tar_scm:meson-1.0.1.tar.gz/test cases/failing/124 subproject sandbox violation Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/failing/124 subproject sandbox violation/meson.build Changed

_service:tar_scm:meson-1.0.1.tar.gz/test cases/failing/124 subproject sandbox violation/meson_options.txt Changed

_service:tar_scm:meson-1.0.1.tar.gz/test cases/failing/124 subproject sandbox violation/subprojects Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/failing/124 subproject sandbox violation/subprojects/subproj1 Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/failing/124 subproject sandbox violation/subprojects/subproj1/file.txt Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/failing/124 subproject sandbox violation/subprojects/subproj1/meson.build Changed

_service:tar_scm:meson-1.0.1.tar.gz/test cases/failing/124 subproject sandbox violation/subprojects/subproj1/nested Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/failing/124 subproject sandbox violation/subprojects/subproj1/nested/meson.build Changed

_service:tar_scm:meson-1.0.1.tar.gz/test cases/failing/124 subproject sandbox violation/subprojects/subproj2 Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/failing/124 subproject sandbox violation/subprojects/subproj2/file.txt Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/failing/124 subproject sandbox violation/subprojects/subproj2/meson.build Changed

_service:tar_scm:meson-1.0.1.tar.gz/test cases/failing/124 subproject sandbox violation/subprojects/subproj2/nested Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/failing/124 subproject sandbox violation/subprojects/subproj2/nested/meson.build Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/failing/124 subproject sandbox violation/subprojects/subproj3 Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/failing/124 subproject sandbox violation/subprojects/subproj3/file.txt Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/failing/124 subproject sandbox violation/subprojects/subproj3/meson.build Changed

_service:tar_scm:meson-1.0.1.tar.gz/test cases/failing/124 subproject sandbox violation/test.json Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/failing/125 override and add_project_dependency Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/failing/125 override and add_project_dependency/inc Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/failing/125 override and add_project_dependency/inc/lib.h Changed

_service:tar_scm:meson-1.0.1.tar.gz/test cases/failing/125 override and add_project_dependency/lib.c Changed

_service:tar_scm:meson-1.0.1.tar.gz/test cases/failing/125 override and add_project_dependency/meson.build Changed

_service:tar_scm:meson-1.0.1.tar.gz/test cases/failing/125 override and add_project_dependency/subprojects Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/failing/125 override and add_project_dependency/subprojects/a Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/failing/125 override and add_project_dependency/subprojects/a/meson.build Changed

_service:tar_scm:meson-1.0.1.tar.gz/test cases/failing/125 override and add_project_dependency/subprojects/a/prog.c Changed

_service:tar_scm:meson-1.0.1.tar.gz/test cases/failing/125 override and add_project_dependency/test.json Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/failing/126 targets before add_project_dependency Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/failing/126 targets before add_project_dependency/inc Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/failing/126 targets before add_project_dependency/inc/lib.h Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/failing/126 targets before add_project_dependency/lib.c Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/failing/126 targets before add_project_dependency/meson.build Changed

_service:tar_scm:meson-1.0.1.tar.gz/test cases/failing/126 targets before add_project_dependency/test.json Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/failing/127 extract from unity Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/failing/127 extract from unity/meson.build Changed

_service:tar_scm:meson-1.0.1.tar.gz/test cases/failing/127 extract from unity/src1.c Changed

_service:tar_scm:meson-1.0.1.tar.gz/test cases/failing/127 extract from unity/src2.c Changed

_service:tar_scm:meson-1.0.1.tar.gz/test cases/failing/127 extract from unity/test.json Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/failing/128 subproject object as a dependency Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/failing/128 subproject object as a dependency/main.c Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/failing/128 subproject object as a dependency/meson.build Changed

_service:tar_scm:meson-1.0.1.tar.gz/test cases/failing/128 subproject object as a dependency/subprojects Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/failing/128 subproject object as a dependency/subprojects/sub Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/failing/128 subproject object as a dependency/subprojects/sub/meson.build Changed

_service:tar_scm:meson-1.0.1.tar.gz/test cases/failing/128 subproject object as a dependency/test.json Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/failing/129 generator host binary Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/failing/129 generator host binary/exe.c Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/failing/129 generator host binary/lib.in Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/failing/129 generator host binary/meson.build Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/failing/129 generator host binary/test.json Added

_service:tar_scm:meson-0.63.2.tar.gz/test cases/failing/13 array arithmetic/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/failing/13 array arithmetic/meson.build Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/failing/14 invalid option name/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/failing/14 invalid option name/meson.build Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/failing/18 wrong plusassign/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/failing/18 wrong plusassign/meson.build Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/failing/20 version/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/failing/20 version/meson.build Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/failing/21 subver/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/failing/21 subver/meson.build Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/failing/21 subver/subprojects/foo/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/failing/21 subver/subprojects/foo/meson.build Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/failing/22 assert/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/failing/22 assert/meson.build Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/failing/24 int conversion/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/failing/24 int conversion/meson.build Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/failing/25 badlang/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/failing/25 badlang/meson.build Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/failing/26 output subdir/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/failing/26 output subdir/meson.build Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/failing/27 noprog use/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/failing/27 noprog use/meson.build Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/failing/28 no crossprop/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/failing/28 no crossprop/meson.build Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/failing/29 nested ternary/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/failing/29 nested ternary/meson.build Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/failing/3 missing subdir/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/failing/3 missing subdir/meson.build Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/failing/30 invalid man extension/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/failing/30 invalid man extension/meson.build Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/failing/31 no man extension/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/failing/31 no man extension/meson.build Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/failing/33 non-root subproject/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/failing/33 non-root subproject/meson.build Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/failing/34 dependency not-required then required/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/failing/34 dependency not-required then required/meson.build Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/failing/38 prefix absolute/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/failing/38 prefix absolute/meson.build Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/failing/4 missing meson.build/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/failing/4 missing meson.build/meson.build Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/failing/40 custom target plainname many inputs/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/failing/40 custom target plainname many inputs/meson.build Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/failing/40 custom target plainname many inputs/test.json -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/failing/40 custom target plainname many inputs/test.json Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/failing/41 custom target outputs not matching install_dirs/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/failing/41 custom target outputs not matching install_dirs/meson.build Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/failing/43 abs subdir/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/failing/43 abs subdir/meson.build Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/failing/44 abspath to srcdir/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/failing/44 abspath to srcdir/meson.build Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/failing/44 abspath to srcdir/test.json -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/failing/44 abspath to srcdir/test.json Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/failing/46 pkgconfig variables zero length/test.json -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/failing/46 pkgconfig variables zero length/test.json Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/failing/47 pkgconfig variables zero length value/test.json -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/failing/47 pkgconfig variables zero length value/test.json Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/failing/48 pkgconfig variables not key value/test.json -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/failing/48 pkgconfig variables not key value/test.json Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/failing/5 misplaced option/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/failing/5 misplaced option/meson.build Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/failing/50 inconsistent comparison/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/failing/50 inconsistent comparison/meson.build Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/failing/55 or on new line/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/failing/55 or on new line/meson.build Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/failing/6 missing incdir/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/failing/6 missing incdir/meson.build Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/failing/60 subproj filegrab/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/failing/60 subproj filegrab/meson.build Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/failing/62 grab sibling/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/failing/62 grab sibling/meson.build Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/failing/62 grab sibling/subprojects/b/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/failing/62 grab sibling/subprojects/b/meson.build Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/failing/67 install_data rename bad size/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/failing/67 install_data rename bad size/meson.build Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/failing/69 dual override/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/failing/69 dual override/meson.build Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/failing/7 go to subproject/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/failing/7 go to subproject/meson.build Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/failing/70 override used/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/failing/70 override used/meson.build Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/failing/71 run_command unclean exit/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/failing/71 run_command unclean exit/meson.build Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/failing/71 run_command unclean exit/test.json -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/failing/71 run_command unclean exit/test.json Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/failing/75 non ascii in ascii encoded configure file/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/failing/75 non ascii in ascii encoded configure file/meson.build Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/failing/78 framework dependency with version/test.json -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/failing/78 framework dependency with version/test.json Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/failing/8 recursive/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/failing/8 recursive/meson.build Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/failing/8 recursive/subprojects/a/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/failing/8 recursive/subprojects/a/meson.build Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/failing/8 recursive/subprojects/b/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/failing/8 recursive/subprojects/b/meson.build Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/failing/80 gl dependency with version/test.json -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/failing/80 gl dependency with version/test.json Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/failing/81 threads dependency with version/test.json -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/failing/81 threads dependency with version/test.json Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/failing/82 gtest dependency with version/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/failing/82 gtest dependency with version/meson.build Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/failing/97 subdir parse error/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/failing/97 subdir parse error/meson.build Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/fpga/1 simple/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/fpga/1 simple/meson.build Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/frameworks/11 gir subproject/test.json -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/frameworks/11 gir subproject/test.json Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/frameworks/24 libgcrypt/test.json -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/frameworks/24 libgcrypt/test.json Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/frameworks/27 gpgme/test.json -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/frameworks/27 gpgme/test.json Changed

_service:tar_scm:meson-1.0.1.tar.gz/test cases/frameworks/28 gir link order 2/samelibname/dummy.c Added

_service:tar_scm:meson-0.63.2.tar.gz/test cases/frameworks/28 gir link order 2/samelibname/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/frameworks/28 gir link order 2/samelibname/meson.build Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/frameworks/35 boost symlinks/boost/include/boost -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/frameworks/35 boost symlinks/boost/include/boost Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/frameworks/35 boost symlinks/boost/lib/boost_python-vc142-mt-gd-x32-0_3.lib -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/frameworks/35 boost symlinks/boost/lib/boost_python-vc142-mt-gd-x32-0_3.lib Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/frameworks/35 boost symlinks/boost/lib/boost_python-vc142-mt-gd-x64-0_3.lib -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/frameworks/35 boost symlinks/boost/lib/boost_python-vc142-mt-gd-x64-0_3.lib Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/frameworks/35 boost symlinks/boost/lib/boost_regex-vc142-mt-gd-x32-0_3.lib -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/frameworks/35 boost symlinks/boost/lib/boost_regex-vc142-mt-gd-x32-0_3.lib Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/frameworks/35 boost symlinks/boost/lib/boost_regex-vc142-mt-gd-x64-0_3.lib -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/frameworks/35 boost symlinks/boost/lib/boost_regex-vc142-mt-gd-x64-0_3.lib Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/frameworks/35 boost symlinks/boost/lib/libboost_python.so.0.3.0 -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/frameworks/35 boost symlinks/boost/lib/libboost_python.so.0.3.0 Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/frameworks/35 boost symlinks/boost/lib/libboost_regex.so.0.3.0 -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/frameworks/35 boost symlinks/boost/lib/libboost_regex.so.0.3.0 Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/frameworks/4 qt/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/frameworks/4 qt/meson.build Changed

_service:tar_scm:meson-1.0.1.tar.gz/test cases/frameworks/7 gnome/copyfile.py Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/frameworks/7 gnome/gdbus/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/frameworks/7 gnome/gdbus/meson.build Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/frameworks/7 gnome/genmarshal/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/frameworks/7 gnome/genmarshal/meson.build Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/frameworks/7 gnome/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/frameworks/7 gnome/meson.build Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/frameworks/7 gnome/resources/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/frameworks/7 gnome/resources/meson.build Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/frameworks/7 gnome/test.json -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/frameworks/7 gnome/test.json Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/java/9 jni/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/java/9 jni/meson.build Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/java/9 jni/src/com/mesonbuild/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/java/9 jni/src/com/mesonbuild/meson.build Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/keyval/1 basic/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/keyval/1 basic/meson.build Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/keyval/1 basic/test.json -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/keyval/1 basic/test.json Changed

_service:tar_scm:meson-1.0.1.tar.gz/test cases/nasm/2 asm language Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/nasm/2 asm language/hello.asm Added

@@ -0,0 +1,31 @@
+;  hello.asm  a first program for nasm for Linux, Intel, gcc
+;
+; assemble:    nasm -f elf -l hello.lst  hello.asm
+; link:        gcc -o hello  hello.o
+; run:            hello
+; output is:    Hello World
+
+%include "config.asm"
+
+%ifdef FOO
+%define RETVAL HELLO
+%endif
+
+    SECTION .data        ; data section
+msg:    db "Hello World",10    ; the string to print, 10=cr
+len:    equ $-msg        ; "$" means "here"
+                ; len is a value, not an address
+
+    SECTION .text        ; code section
+        global main        ; make label available to linker
+main:                ; standard  gcc  entry point
+
+    mov    edx,len        ; arg3, length of string to print
+    mov    ecx,msg        ; arg2, pointer to string
+    mov    ebx,1        ; arg1, where to write, screen
+    mov    eax,4        ; write sysout command to int 80 hex
+    int    0x80        ; interrupt 80 hex, call kernel
+
+    mov    ebx,RETVAL    ; exit code, 0=normal
+    mov    eax,1        ; exit command to kernel
+    int    0x80        ; interrupt 80 hex, call kernel

_service:tar_scm:meson-1.0.1.tar.gz/test cases/nasm/2 asm language/meson.build Added

@@ -0,0 +1,57 @@
+project('test', 'c')
+
+if not host_machine.cpu_family().startswith('x86')
+  assert(not add_languages('nasm', required: false))
+  error('MESON_SKIP_TEST: nasm only supported for x86 and x86_64')
+endif
+
+if not add_languages('nasm', required: false)
+  nasm = find_program('nasm', 'yasm', required: false)
+  assert(not nasm.found())
+  error('MESON_SKIP_TEST: nasm not found')
+endif
+
+nasm = meson.get_compiler('nasm')
+
+code = '''
+SECTION .text
+global main
+main:
+  mov foo,bar ; error: symbol `foo' not defined
+'''
+assert(not nasm.compiles(code, name: 'Invalid NASM code'))
+
+code = '''
+SECTION .text
+global main
+main:
+  mov eax,1
+'''
+assert(nasm.compiles(code, name: 'Valid NASM code'))
+
+config_file = configure_file(
+  output: 'config.asm',
+  configuration: {'HELLO': 0},
+  output_format: 'nasm',
+)
+
+cc = meson.get_compiler('c')
+link_args = cc.get_supported_link_arguments('-no-pie')
+
+exe = executable('hello', 'hello.asm',
+  nasm_args: '-DFOO',
+  link_args: link_args,
+)
+test('hello', exe)
+
+#Test whether pthread dependency gets filtered out
+threads = dependency('threads')
+
+exe2 = executable('hello_w_threads', 'hello.asm',
+  config_file,
+  nasm_args: '-DFOO',
+  link_args: link_args,
+  dependencies: threads
+)
+
+test('hello_w_threads', exe2)

_service:tar_scm:meson-0.63.2.tar.gz/test cases/python/2 extmodule/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/python/2 extmodule/meson.build Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/python/7 install path/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/python/7 install path/meson.build Changed

_service:tar_scm:meson-1.0.1.tar.gz/test cases/python/7 install path/structured Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/python/7 install path/structured/alpha Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/python/7 install path/structured/alpha/one.py Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/python/7 install path/structured/alpha/three.py Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/python/7 install path/structured/alpha/two.py Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/python/7 install path/structured/beta Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/python/7 install path/structured/beta/one.py Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/python/7 install path/structured/meson.build Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/python/7 install path/structured/one.py Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/python/7 install path/structured/two.py Added

_service:tar_scm:meson-0.63.2.tar.gz/test cases/python/7 install path/test.json -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/python/7 install path/test.json Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/python3/3 cython/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/python3/3 cython/meson.build Changed

_service:tar_scm:meson-1.0.1.tar.gz/test cases/rust/12 bindgen/dependencies Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/rust/12 bindgen/dependencies/clib2.c Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/rust/12 bindgen/dependencies/external_dep.h Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/rust/12 bindgen/dependencies/internal_dep.h Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/rust/12 bindgen/dependencies/internal_main.rs Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/rust/12 bindgen/dependencies/meson.build Added

_service:tar_scm:meson-0.63.2.tar.gz/test cases/rust/12 bindgen/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/rust/12 bindgen/meson.build Changed

_service:tar_scm:meson-1.0.1.tar.gz/test cases/rust/12 bindgen/test.json Added

_service:tar_scm:meson-0.63.2.tar.gz/test cases/rust/2 sharedlib/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/rust/2 sharedlib/meson.build Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/rust/2 sharedlib/stuff.rs -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/rust/2 sharedlib/stuff.rs Changed

_service:tar_scm:meson-1.0.1.tar.gz/test cases/rust/2 sharedlib/value.c Added

_service:tar_scm:meson-0.63.2.tar.gz/test cases/rust/3 staticlib/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/rust/3 staticlib/meson.build Changed

_service:tar_scm:meson-1.0.1.tar.gz/test cases/rust/3 staticlib/other.rs Added

_service:tar_scm:meson-0.63.2.tar.gz/test cases/rust/3 staticlib/prog.rs -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/rust/3 staticlib/prog.rs Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/rust/3 staticlib/stuff.rs -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/rust/3 staticlib/stuff.rs Changed

_service:tar_scm:meson-1.0.1.tar.gz/test cases/rust/3 staticlib/value.c Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/rust/5 polyglot static/clib.c Added

_service:tar_scm:meson-0.63.2.tar.gz/test cases/rust/5 polyglot static/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/rust/5 polyglot static/meson.build Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/rust/5 polyglot static/prog.c -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/rust/5 polyglot static/prog.c Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/rust/5 polyglot static/stuff.rs -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/rust/5 polyglot static/stuff.rs Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/rust/5 polyglot static/test.json -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/rust/5 polyglot static/test.json Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/unit/102 python without pkgconfig/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/unit/102 python without pkgconfig/meson.build Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/unit/103 strip/lib.c -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/unit/103 strip/lib.c Changed

_service:tar_scm:meson-1.0.1.tar.gz/test cases/unit/108 configure same noop Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/unit/108 configure same noop/meson.build Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/unit/108 configure same noop/meson_options.txt Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/unit/109 freeze Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/unit/109 freeze/freeze.c Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/unit/109 freeze/meson.build Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/unit/110 classpath Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/unit/110 classpath/com Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/unit/110 classpath/com/mesonbuild Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/unit/110 classpath/com/mesonbuild/Simple.java Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/unit/110 classpath/meson.build Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/unit/15 prebuilt object/cp.py Added

_service:tar_scm:meson-0.63.2.tar.gz/test cases/unit/15 prebuilt object/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/unit/15 prebuilt object/meson.build Changed

_service:tar_scm:meson-1.0.1.tar.gz/test cases/unit/52 pkgconfig static link order/dummy.c Added

_service:tar_scm:meson-0.63.2.tar.gz/test cases/unit/52 pkgconfig static link order/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/unit/52 pkgconfig static link order/meson.build Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/unit/71 summary/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/unit/71 summary/meson.build Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/unit/98 install all targets/meson.build -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/unit/98 install all targets/meson.build Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/vala/5 target glib/GLib.Thread.vala -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/vala/5 target glib/GLib.Thread.vala Changed

_service:tar_scm:meson-0.63.2.tar.gz/test cases/vala/5 target glib/retcode.c -> _service:tar_scm:meson-1.0.1.tar.gz/test cases/vala/5 target glib/retcode.c Changed

_service:tar_scm:meson-1.0.1.tar.gz/test cases/warning/7 module without unstable Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/warning/7 module without unstable/meson.build Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/warning/7 module without unstable/test.json Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/warning/8 target with no sources Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/warning/8 target with no sources/meson.build Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/warning/8 target with no sources/test.json Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/wayland/2 core only Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/wayland/2 core only/core.c Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/wayland/2 core only/meson.build Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/windows/19 msvc cplusplus define Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/windows/19 msvc cplusplus define/main.cpp Changed

_service:tar_scm:meson-1.0.1.tar.gz/test cases/windows/19 msvc cplusplus define/meson.build Changed

_service:tar_scm:meson-1.0.1.tar.gz/test cases/windows/20 vs install static lib with generated obj deps Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/windows/20 vs install static lib with generated obj deps/both_lib_source.c Changed

_service:tar_scm:meson-1.0.1.tar.gz/test cases/windows/20 vs install static lib with generated obj deps/copyfile.py Changed

_service:tar_scm:meson-1.0.1.tar.gz/test cases/windows/20 vs install static lib with generated obj deps/generated_source.c Changed

_service:tar_scm:meson-1.0.1.tar.gz/test cases/windows/20 vs install static lib with generated obj deps/meson.build Changed

_service:tar_scm:meson-1.0.1.tar.gz/test cases/windows/20 vs install static lib with generated obj deps/static_lib_source.c Changed

_service:tar_scm:meson-1.0.1.tar.gz/test cases/windows/20 vs install static lib with generated obj deps/test.json Changed

_service:tar_scm:meson-1.0.1.tar.gz/test cases/windows/21 masm Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/windows/21 masm/hello.masm Added

_service:tar_scm:meson-1.0.1.tar.gz/test cases/windows/21 masm/meson.build Added

_service:tar_scm:meson-0.63.2.tar.gz/unittests/allplatformstests.py -> _service:tar_scm:meson-1.0.1.tar.gz/unittests/allplatformstests.py Changed

@@ -12,7 +12,6 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-from mesonbuild.mesonlib.universal import windows_proof_rm
 import subprocess
 import re
 import json
@@ -42,12 +41,16 @@
     BuildDirLock, MachineChoice, is_windows, is_osx, is_cygwin, is_dragonflybsd,
     is_sunos, windows_proof_rmtree, python_command, version_compare, split_args, quote_arg,
     relpath, is_linux, git, search_version, do_conf_file, do_conf_str, default_prefix,
-    MesonException, EnvironmentException, OptionKey
+    MesonException, EnvironmentException, OptionKey, ExecutableSerialisation, EnvironmentVariables,
+    windows_proof_rm
 )
 
+from mesonbuild.compilers.mixins.clang import ClangCompiler
+from mesonbuild.compilers.mixins.gnu import GnuCompiler
+from mesonbuild.compilers.mixins.intel import IntelGnuLikeCompiler
+from mesonbuild.compilers.c import VisualStudioCCompiler, ClangClCCompiler
+from mesonbuild.compilers.cpp import VisualStudioCPPCompiler, ClangClCPPCompiler
 from mesonbuild.compilers import (
-    GnuCompiler, ClangCompiler, IntelGnuLikeCompiler, VisualStudioCCompiler,
-    VisualStudioCPPCompiler, ClangClCCompiler, ClangClCPPCompiler,
     detect_static_linker, detect_c_compiler, compiler_from_language,
     detect_compiler_for
 )
@@ -578,7 +581,7 @@
         self.assertIn('1/1 subtest 1', out)
 
     def test_long_output(self):
-        testdir = os.path.join(self.common_test_dir, '253 long output')
+        testdir = os.path.join(self.common_test_dir, '254 long output')
         self.init(testdir)
         self.build()
         self.run_tests()
@@ -793,6 +796,26 @@
 
         self.assertFailedTestCount(2, self.mtest_command + '--no-suite', 'subprjfail:fail', '--no-suite', 'subprjmix:fail')
 
+    def test_mtest_reconfigure(self):
+        if self.backend is not Backend.ninja:
+            raise SkipTest(f'mtest can\'t rebuild with {self.backend.name!r}')
+
+        testdir = os.path.join(self.common_test_dir, '206 tap tests')
+        self.init(testdir)
+        self.utime(os.path.join(testdir, 'meson.build'))
+        o = self._run(self.mtest_command + '--list')
+        self.assertIn('Regenerating build files.', o)
+        self.assertIn('test_features / xfail', o)
+        o = self._run(self.mtest_command + '--list')
+        self.assertNotIn('Regenerating build files.', o)
+        # no real targets should have been built
+        tester = os.path.join(self.builddir, 'tester' + exe_suffix)
+        self.assertPathDoesNotExist(tester)
+        # check that we don't reconfigure if --no-rebuild is passed
+        self.utime(os.path.join(testdir, 'meson.build'))
+        o = self._run(self.mtest_command + '--list', '--no-rebuild')
+        self.assertNotIn('Regenerating build files.', o)
+
     def test_build_by_default(self):
         testdir = os.path.join(self.common_test_dir, '129 build by default')
         self.init(testdir)
@@ -810,6 +833,53 @@
         self.build(target=('barprog' + exe_suffix))
         self.assertPathExists(exe2)
 
+    def test_build_generated_pyx_directly(self):
+        # Check that the transpile stage also includes
+        # dependencies for the compilation stage as dependencies
+        testdir = os.path.join("test cases/cython", '2 generated sources')
+        env = get_fake_env(testdir, self.builddir, self.prefix)
+        try:
+            detect_compiler_for(env, "cython", MachineChoice.HOST)
+        except EnvironmentException:
+            raise SkipTest("Cython is not installed")
+        self.init(testdir)
+        # Need to get the full target name of the pyx.c target
+        # (which is unfortunately not provided by introspection :( )
+        # We'll need to dig into the generated sources
+        targets = self.introspect('--targets')
+        name = None
+        for target in targets:
+            for target_sources in target"target_sources":
+                for generated_source in target_sources"generated_sources":
+                    if "includestuff.pyx.c" in generated_source:
+                        name = generated_source
+                        break
+        # Split the path (we only want the includestuff.cpython-blahblahblah)
+        name = os.path.normpath(name).split("/")-2:
+        name = "/".join(name)  # Glue list into a string
+        self.build(target=name)
+
+    def test_build_pyx_depfiles(self):
+        # building regularly and then touching a depfile dependency should rebuild
+        testdir = os.path.join("test cases/cython", '2 generated sources')
+        env = get_fake_env(testdir, self.builddir, self.prefix)
+        try:
+            cython = detect_compiler_for(env, "cython", MachineChoice.HOST)
+            if not version_compare(cython.version, '>=0.29.33'):
+                raise SkipTest('Cython is too old')
+        except EnvironmentException:
+            raise SkipTest("Cython is not installed")
+        self.init(testdir)
+
+        targets = self.introspect('--targets')
+        for target in targets:
+            if target'name'.startswith('simpleinclude'):
+                name = target'name'
+        self.build()
+        self.utime(os.path.join(testdir, 'simplestuff.pxi'))
+        self.assertBuildRelinkedOnlyTarget(name)
+
+
     def test_internal_include_order(self):
         if mesonbuild.environment.detect_msys2_arch() and ('MESON_RSP_THRESHOLD' in os.environ):
             raise SkipTest('Test does not yet support gcc rsp files on msys2')
@@ -1929,24 +1999,26 @@
             r'sub' + os.path.sep + r'meson.build:3: WARNING: Keyword argument "link_with" defined multiple times.',
             r'meson.build:6: WARNING: a warning of some sort',
             r'sub' + os.path.sep + r'meson.build:4: WARNING: subdir warning',
-            r'meson.build:7: WARNING: Module unstable-simd has no backwards or forwards compatibility and might not exist in future releases.',
+            r'meson.build:7: WARNING: Module SIMD has no backwards or forwards compatibility and might not exist in future releases.',
             r"meson.build:11: WARNING: The variable(s) 'MISSING' in the input file 'conf.in' are not present in the given configuration data.",
         :
-            self.assertRegex(out, re.escape(expected))
+            with self.subTest(expected):
+                self.assertRegex(out, re.escape(expected))
 
         for wd in 
             self.src_root,
             self.builddir,
             os.getcwd(),
         :
-            self.new_builddir()
-            out = self.init(tdir, workdir=wd)
-            expected = os.path.join(relpath(tdir, self.src_root), 'meson.build')
-            relwd = relpath(self.src_root, wd)
-            if relwd != '.':
-                expected = os.path.join(relwd, expected)
-                expected = '\n' + expected + ':'
-            self.assertIn(expected, out)
+            with self.subTest(wd):
+                self.new_builddir()
+                out = self.init(tdir, workdir=wd)
+                expected = os.path.join(relpath(tdir, self.src_root), 'meson.build')
+                relwd = relpath(self.src_root, wd)
+                if relwd != '.':
+                    expected = os.path.join(relwd, expected)
+                    expected = '\n' + expected + ':'
+                self.assertIn(expected, out)
 
     def test_error_location_path(self):
         '''Test locations in meson errors contain correct paths'''
@@ -2254,6 +2326,9 @@
         self.setconf('--warnlevel=3')
         obj = mesonbuild.coredata.load(self.builddir)
         self.assertEqual(obj.optionsOptionKey('warning_level').value, '3')
+        self.setconf('--warnlevel=everything')
+        obj = mesonbuild.coredata.load(self.builddir)
+        self.assertEqual(obj.optionsOptionKey('warning_level').value, 'everything')
         self.wipe()
 
         # But when using -D syntax, it should be 'warning_level'
@@ -2263,6 +2338,9 @@
         self.setconf('-Dwarning_level=3')
         obj = mesonbuild.coredata.load(self.builddir)
         self.assertEqual(obj.optionsOptionKey('warning_level').value, '3')
+        self.setconf('-Dwarning_level=everything')
+        obj = mesonbuild.coredata.load(self.builddir)
+        self.assertEqual(obj.optionsOptionKey('warning_level').value, 'everything')
         self.wipe()
 
         # Mixing --option and -Doption is forbidden
@@ -3292,7 +3370,7 @@
                 A number       : 1
                 yes            : YES
                 no             : NO
-                coma list      : a, b, c
+                comma list     : a, b, c
 
               Stuff
                 missing prog   : NO
@@ -3300,9 +3378,10 @@
                 missing dep    : NO
                 external dep   : YES 1.2.3
                 internal dep   : YES
+                disabler       : NO
 
               Plugins
-                long coma list : alpha, alphacolor, apetag, audiofx, audioparsers, auparse,
+                long comma list: alpha, alphacolor, apetag, audiofx, audioparsers, auparse,
                                  autodetect, avi
 
               Subprojects
@@ -3711,10 +3790,26 @@
                   patch_directory = wrap_git_builddef
                   revision = master
                 '''.format(upstream_uri)))
-            self.init(srcdir)
+            out = self.init(srcdir)
             self.build()
             self.run_tests()
 
+            # Make sure the warning does not occur on the first init.
+            out_of_date_warning = 'revision may be out of date'
+            self.assertNotIn(out_of_date_warning, out)
+
+            # Change the wrap's revisions, reconfigure, and make sure it does
+            # warn on the reconfigure.
+            with open(os.path.join(srcdir, 'subprojects', 'wrap_git.wrap'), 'w', encoding='utf-8') as f:
+                f.write(textwrap.dedent('''
+                  wrap-git
+                  url = {}
+                  patch_directory = wrap_git_builddef
+                  revision = not-master
+                '''.format(upstream_uri)))
+            out = self.init(srcdir, extra_args='--reconfigure')
+            self.assertIn(out_of_date_warning, out)
+
     def test_extract_objects_custom_target_no_warning(self):
         testdir = os.path.join(self.common_test_dir, '22 object extraction')
 
@@ -4012,6 +4107,11 @@
             Path(installpath, 'usr/lib/libstatic.a'),
             Path(installpath, 'usr/lib/libboth.a'),
             Path(installpath, 'usr/lib/libboth2.a'),
+            Path(installpath, 'usr/include/ct-header1.h'),
+            Path(installpath, 'usr/include/ct-header3.h'),
+            Path(installpath, 'usr/include/subdir-devel'),
+            Path(installpath, 'usr/include/custom_files'),
+            Path(installpath, 'usr/include/custom_files/data.txt'),
         }
 
         if cc.get_id() in {'msvc', 'clang-cl'}:
@@ -4143,11 +4243,11 @@
         expected = {
             'targets': {
                 f'{self.builddir}/out1-notag.txt': {
-                    'destination': '{prefix}/share/out1-notag.txt',
+                    'destination': '{datadir}/out1-notag.txt',
                     'tag': None,
                 },
                 f'{self.builddir}/out2-notag.txt': {
-                    'destination': '{prefix}/share/out2-notag.txt',
+                    'destination': '{datadir}/out2-notag.txt',
                     'tag': None,
                 },
                 f'{self.builddir}/libstatic.a': {
@@ -4195,67 +4295,67 @@
                     'tag': 'devel',
                 },
                 f'{self.builddir}/out1-custom.txt': {
-                    'destination': '{prefix}/share/out1-custom.txt',
+                    'destination': '{datadir}/out1-custom.txt',
                     'tag': 'custom',
                 },
                 f'{self.builddir}/out2-custom.txt': {
-                    'destination': '{prefix}/share/out2-custom.txt',
+                    'destination': '{datadir}/out2-custom.txt',
                     'tag': 'custom',
                 },
                 f'{self.builddir}/out3-custom.txt': {
-                    'destination': '{prefix}/share/out3-custom.txt',
+                    'destination': '{datadir}/out3-custom.txt',
                     'tag': 'custom',
                 },
                 f'{self.builddir}/subdir/out1.txt': {
-                    'destination': '{prefix}/share/out1.txt',
+                    'destination': '{datadir}/out1.txt',
                     'tag': None,
                 },
                 f'{self.builddir}/subdir/out2.txt': {
-                    'destination': '{prefix}/share/out2.txt',
+                    'destination': '{datadir}/out2.txt',
                     'tag': None,
                 },
                 f'{self.builddir}/out-devel.h': {
-                    'destination': '{prefix}/include/out-devel.h',
+                    'destination': '{includedir}/out-devel.h',
                     'tag': 'devel',
                 },
                 f'{self.builddir}/out3-notag.txt': {
-                    'destination': '{prefix}/share/out3-notag.txt',
+                    'destination': '{datadir}/out3-notag.txt',
                     'tag': None,
                 },
             },
             'configure': {
                 f'{self.builddir}/foo-notag.h': {
-                    'destination': '{prefix}/share/foo-notag.h',
+                    'destination': '{datadir}/foo-notag.h',
                     'tag': None,
                 },
                 f'{self.builddir}/foo2-devel.h': {
-                    'destination': '{prefix}/include/foo2-devel.h',
+                    'destination': '{includedir}/foo2-devel.h',
                     'tag': 'devel',
                 },
                 f'{self.builddir}/foo-custom.h': {
-                    'destination': '{prefix}/share/foo-custom.h',
+                    'destination': '{datadir}/foo-custom.h',
                     'tag': 'custom',
                 },
                 f'{self.builddir}/subdir/foo2.h': {
-                    'destination': '{prefix}/share/foo2.h',
+                    'destination': '{datadir}/foo2.h',
                     'tag': None,
                 },
             },
             'data': {
                 f'{testdir}/bar-notag.txt': {
-                    'destination': '{datadir}/share/bar-notag.txt',
+                    'destination': '{datadir}/bar-notag.txt',
                     'tag': None,
                 },
                 f'{testdir}/bar-devel.h': {
-                    'destination': '{datadir}/include/bar-devel.h',
+                    'destination': '{includedir}/bar-devel.h',
                     'tag': 'devel',
                 },
                 f'{testdir}/bar-custom.txt': {
-                    'destination': '{datadir}/share/bar-custom.txt',
+                    'destination': '{datadir}/bar-custom.txt',
                     'tag': 'custom',
                 },
                 f'{testdir}/subdir/bar2-devel.h': {
-                    'destination': '{datadir}/include/bar2-devel.h',
+                    'destination': '{includedir}/bar2-devel.h',
                     'tag': 'devel',
                 },
             },
@@ -4268,6 +4368,12 @@
                     'destination': '{includedir}/foo3-devel.h',
                     'tag': 'devel',
                 },
+            },
+            'install_subdirs': {
+                f'{testdir}/custom_files': {
+                    'destination': '{datadir}/custom_files',
+                    'tag': 'custom'
+                }
             }
         }
 
@@ -4299,7 +4405,8 @@
         self.init(testdir, extra_args='--werror', override_envvars={'RUSTC': 'clippy-driver'})
         with self.assertRaises(subprocess.CalledProcessError) as cm:
             self.build()
-        self.assertIn('error: use of a blacklisted/placeholder name `foo`', cm.exception.stdout)
+        self.assertTrue('error: use of a blacklisted/placeholder name `foo`' in cm.exception.stdout or
+                        'error: use of a disallowed/placeholder name `foo`' in cm.exception.stdout)
 
     @skip_if_not_language('rust')
     def test_rust_rlib_linkage(self) -> None:
@@ -4352,3 +4459,41 @@
 
         self.init(testdir)
         self.build()
+
+    def test_configure_same_noop(self):
+        testdir = os.path.join(self.unit_test_dir, '108 configure same noop')
+        self.init(testdir, extra_args='-Dopt=val')
+
+        filename = os.path.join(self.privatedir, 'coredata.dat')
+        oldmtime = os.path.getmtime(filename)
+        self.setconf("-Dopt=val")
+        newmtime = os.path.getmtime(filename)
+        self.assertEqual(oldmtime, newmtime)
+
+    def test_scripts_loaded_modules(self):
+        '''
+        Simulate a wrapped command, as done for custom_target() that capture
+        output. The script will print all python modules loaded and we verify
+        that it contains only an acceptable subset. Loading too many modules
+        slows down the build when many custom targets get wrapped.
+        '''
+        es = ExecutableSerialisation(python_command + '-c', 'exit(0)', env=EnvironmentVariables())
+        p = Path(self.builddir, 'exe.dat')
+        with p.open('wb') as f:
+            pickle.dump(es, f)
+        cmd = self.meson_command + '--internal', 'test_loaded_modules', '--unpickle', str(p)
+        p = subprocess.run(cmd, stdout=subprocess.PIPE)
+        all_modules = json.loads(p.stdout.splitlines()0)
+        meson_modules = m for m in all_modules if 'meson' in m
+        expected_meson_modules = 
+            'mesonbuild',
+            'mesonbuild._pathlib',
+            'mesonbuild.utils',
+            'mesonbuild.utils.core',
+            'mesonbuild.mesonmain',
+            'mesonbuild.mlog',
+            'mesonbuild.scripts',
+            'mesonbuild.scripts.meson_exe',
+            'mesonbuild.scripts.test_loaded_modules'
+        
+        self.assertEqual(sorted(expected_meson_modules), sorted(meson_modules))

_service:tar_scm:meson-0.63.2.tar.gz/unittests/baseplatformtests.py -> _service:tar_scm:meson-1.0.1.tar.gz/unittests/baseplatformtests.py Changed

@@ -15,6 +15,7 @@
 from pathlib import PurePath
 from unittest import mock, TestCase, SkipTest
 import json
+import io
 import os
 import re
 import subprocess
@@ -59,7 +60,7 @@
         self.meson_native_files = 
         self.meson_cross_files = 
         self.meson_command = python_command + get_meson_script()
-        self.setup_command = self.meson_command + self.meson_args
+        self.setup_command = self.meson_command + 'setup' + self.meson_args
         self.mconf_command = self.meson_command + 'configure'
         self.mintro_command = self.meson_command + 'introspect'
         self.wrap_command = self.meson_command + 'wrap'
@@ -120,13 +121,17 @@
         newdir = os.path.realpath(newdir)
         self.change_builddir(newdir)
 
-    def _get_meson_log(self) -> T.Optionalstr:
+    def _open_meson_log(self) -> io.TextIOWrapper:
         log = os.path.join(self.logdir, 'meson-log.txt')
-        if not os.path.isfile(log):
-            print(f"{log!r} doesn't exist", file=sys.stderr)
+        return open(log, encoding='utf-8')
+
+    def _get_meson_log(self) -> T.Optionalstr:
+        try:
+            with self._open_meson_log() as f:
+                return f.read()
+        except FileNotFoundError as e:
+            print(f"{e.filename!r} doesn't exist", file=sys.stderr)
             return None
-        with open(log, encoding='utf-8') as f:
-            return f.read()
 
     def _print_meson_log(self) -> None:
         log = self._get_meson_log()
@@ -205,7 +210,7 @@
         self.privatedir = os.path.join(self.builddir, 'meson-private')
         if inprocess:
             try:
-                returncode, out, err = run_configure_inprocess(self.meson_args + args + extra_args, override_envvars)
+                returncode, out, err = run_configure_inprocess('setup' + self.meson_args + args + extra_args, override_envvars)
             except Exception as e:
                 if not allow_fail:
                     self._print_meson_log()
@@ -317,8 +322,12 @@
                     each'command' = compiler + ' ' + f.read()
         return contents
 
+    def get_meson_log_raw(self):
+        with self._open_meson_log() as f:
+            return f.read()
+
     def get_meson_log(self):
-        with open(os.path.join(self.builddir, 'meson-logs', 'meson-log.txt'), encoding='utf-8') as f:
+        with self._open_meson_log() as f:
             return f.readlines()
 
     def get_meson_log_compiler_checks(self):
@@ -326,19 +335,19 @@
         Fetch a list command-lines run by meson for compiler checks.
         Each command-line is returned as a list of arguments.
         '''
-        log = self.get_meson_log()
         prefix = 'Command line:'
-        cmds = llen(prefix):.split() for l in log if l.startswith(prefix)
-        return cmds
+        with self._open_meson_log() as log:
+            cmds = llen(prefix):.split() for l in log if l.startswith(prefix)
+            return cmds
 
     def get_meson_log_sanitychecks(self):
         '''
         Same as above, but for the sanity checks that were run
         '''
-        log = self.get_meson_log()
         prefix = 'Sanity check compiler command line:'
-        cmds = llen(prefix):.split() for l in log if l.startswith(prefix)
-        return cmds
+        with self._open_meson_log() as log:
+            cmds = llen(prefix):.split() for l in log if l.startswith(prefix)
+            return cmds
 
     def introspect(self, args):
         if isinstance(args, str):

_service:tar_scm:meson-0.63.2.tar.gz/unittests/helpers.py -> _service:tar_scm:meson-1.0.1.tar.gz/unittests/helpers.py Changed

_service:tar_scm:meson-0.63.2.tar.gz/unittests/internaltests.py -> _service:tar_scm:meson-1.0.1.tar.gz/unittests/internaltests.py Changed

@@ -13,7 +13,6 @@
 # limitations under the License.
 
 from configparser import ConfigParser
-from mesonbuild.mesonlib.universal import OptionType
 from pathlib import Path
 from unittest import mock
 import contextlib
@@ -32,16 +31,19 @@
 import mesonbuild.depfile
 import mesonbuild.dependencies.base
 import mesonbuild.dependencies.factory
-import mesonbuild.compilers
 import mesonbuild.envconfig
 import mesonbuild.environment
 import mesonbuild.modules.gnome
 from mesonbuild import coredata
+from mesonbuild.compilers.c import ClangCCompiler, GnuCCompiler
+from mesonbuild.compilers.cpp import VisualStudioCPPCompiler
+from mesonbuild.compilers.d import DmdDCompiler
 from mesonbuild.interpreterbase import typed_pos_args, InvalidArguments, ObjectHolder
 from mesonbuild.interpreterbase import typed_pos_args, InvalidArguments, typed_kwargs, ContainerTypeInfo, KwargInfo
 from mesonbuild.mesonlib import (
     LibType, MachineChoice, PerMachine, Version, is_windows, is_osx,
     is_cygwin, is_openbsd, search_version, MesonException, OptionKey,
+    OptionType
 )
 from mesonbuild.interpreter.type_checking import in_set_validator, NoneType
 from mesonbuild.dependencies import PkgConfigDependency
@@ -116,7 +118,7 @@
                          stat.S_IRGRP | stat.S_IXGRP)
 
     def test_compiler_args_class_none_flush(self):
-        cc = mesonbuild.compilers.ClangCCompiler(, 'fake', MachineChoice.HOST, False, mock.Mock())
+        cc = ClangCCompiler(, , 'fake', MachineChoice.HOST, False, mock.Mock())
         a = cc.compiler_args('-I.')
         #first we are checking if the tree construction deduplicates the correct -I argument
         a += '-I..'
@@ -133,14 +135,14 @@
         self.assertEqual(a, '-I.', '-I./tests2/', '-I./tests/', '-I..')
 
     def test_compiler_args_class_d(self):
-        d = mesonbuild.compilers.DmdDCompiler(, 'fake', MachineChoice.HOST, 'info', 'arch')
+        d = DmdDCompiler(, 'fake', MachineChoice.HOST, 'info', 'arch')
         # check include order is kept when deduplicating
         a = d.compiler_args('-Ifirst', '-Isecond', '-Ithird')
         a += '-Ifirst'
         self.assertEqual(a, '-Ifirst', '-Isecond', '-Ithird')
 
     def test_compiler_args_class_clike(self):
-        cc = mesonbuild.compilers.ClangCCompiler(, 'fake', MachineChoice.HOST, False, mock.Mock())
+        cc = ClangCCompiler(, , 'fake', MachineChoice.HOST, False, mock.Mock())
         # Test that empty initialization works
         a = cc.compiler_args()
         self.assertEqual(a, )
@@ -219,10 +221,32 @@
         l.append_direct('/libbaz.a')
         self.assertEqual(l, '-Lfoodir', '-lfoo', '-Lbardir', '-lbar', '-lbar', '/libbaz.a')
 
+
+    def test_compiler_args_class_visualstudio(self):
+        linker = mesonbuild.linkers.MSVCDynamicLinker(MachineChoice.HOST, )
+        # Version just needs to be > 19.0.0
+        cc = VisualStudioCPPCompiler(, , '20.00', MachineChoice.HOST, False, mock.Mock(), 'x64', linker=linker)
+
+        a = cc.compiler_args(cc.get_always_args())
+        self.assertEqual(a.to_native(copy=True), '/nologo', '/showIncludes', '/utf-8', '/Zc:__cplusplus')
+
+        # Ensure /source-charset: removes /utf-8
+        a.append('/source-charset:utf-8')
+        self.assertEqual(a.to_native(copy=True), '/nologo', '/showIncludes', '/Zc:__cplusplus', '/source-charset:utf-8')
+
+        # Ensure /execution-charset: removes /utf-8
+        a = cc.compiler_args(cc.get_always_args() + '/execution-charset:utf-8')
+        self.assertEqual(a.to_native(copy=True), '/nologo', '/showIncludes', '/Zc:__cplusplus', '/execution-charset:utf-8')
+
+        # Ensure /validate-charset- removes /utf-8
+        a = cc.compiler_args(cc.get_always_args() + '/validate-charset-')
+        self.assertEqual(a.to_native(copy=True), '/nologo', '/showIncludes', '/Zc:__cplusplus', '/validate-charset-')
+
+
     def test_compiler_args_class_gnuld(self):
         ## Test --start/end-group
         linker = mesonbuild.linkers.GnuBFDDynamicLinker(, MachineChoice.HOST, '-Wl,', )
-        gcc = mesonbuild.compilers.GnuCCompiler(, 'fake', False, MachineChoice.HOST, mock.Mock(), linker=linker)
+        gcc = GnuCCompiler(, , 'fake', False, MachineChoice.HOST, mock.Mock(), linker=linker)
         ## Ensure that the fake compiler is never called by overriding the relevant function
         gcc.get_default_include_dirs = lambda: '/usr/include', '/usr/share/include', '/usr/local/include'
         ## Test that 'direct' append and extend works
@@ -250,7 +274,7 @@
     def test_compiler_args_remove_system(self):
         ## Test --start/end-group
         linker = mesonbuild.linkers.GnuBFDDynamicLinker(, MachineChoice.HOST, '-Wl,', )
-        gcc = mesonbuild.compilers.GnuCCompiler(, 'fake', False, MachineChoice.HOST, mock.Mock(), linker=linker)
+        gcc = GnuCCompiler(, , 'fake', False, MachineChoice.HOST, mock.Mock(), linker=linker)
         ## Ensure that the fake compiler is never called by overriding the relevant function
         gcc.get_default_include_dirs = lambda: '/usr/include', '/usr/share/include', '/usr/local/include'
         ## Test that 'direct' append and extend works
@@ -1387,6 +1411,10 @@
                 validator=in_set_validator({'clean', 'build', 'rebuild', 'deprecated', 'since'}),
                 deprecated_values={'deprecated': '1.0'},
                 since_values={'since': '1.1'}),
+            KwargInfo('dict', (ContainerTypeInfo(list, str), ContainerTypeInfo(dict, str)), default={},
+                      since_values={list: '1.9'}),
+            KwargInfo('new_dict', (ContainerTypeInfo(list, str), ContainerTypeInfo(dict, str)), default={},
+                      since_values={dict: '1.1'}),
         )
         def _(obj, node, args: T.Tuple, kwargs: T.Dictstr, str) -> None:
             pass
@@ -1427,6 +1455,18 @@
             _(None, mock.Mock(subproject=''), , {'mode': 'since'})
             self.assertRegex(out.getvalue(), r"""WARNING:.Project targets '1.0'.*introduced in '1.1': "testfunc" keyword argument "mode" value "since".*""")
 
+        with self.subTest('new container'), mock.patch('sys.stdout', io.StringIO()) as out:
+            _(None, mock.Mock(subproject=''), , {'dict': 'a=b'})
+            self.assertRegex(out.getvalue(), r"""WARNING:.Project targets '1.0'.*introduced in '1.9': "testfunc" keyword argument "dict" of type list.*""")
+
+        with self.subTest('new container set to default'), mock.patch('sys.stdout', io.StringIO()) as out:
+            _(None, mock.Mock(subproject=''), , {'new_dict': {}})
+            self.assertRegex(out.getvalue(), r"""WARNING:.Project targets '1.0'.*introduced in '1.1': "testfunc" keyword argument "new_dict" of type dict.*""")
+
+        with self.subTest('new container default'), mock.patch('sys.stdout', io.StringIO()) as out:
+            _(None, mock.Mock(subproject=''), , {})
+            self.assertNotRegex(out.getvalue(), r"""WARNING:.Project targets '1.0'.*introduced in '1.1': "testfunc" keyword argument "new_dict" of type dict.*""")
+
     def test_typed_kwarg_evolve(self) -> None:
         k = KwargInfo('foo', str, required=True, default='foo')
         v = k.evolve(default='bar')

_service:tar_scm:meson-0.63.2.tar.gz/unittests/linuxliketests.py -> _service:tar_scm:meson-1.0.1.tar.gz/unittests/linuxliketests.py Changed

@@ -40,9 +40,11 @@
 )
 from mesonbuild.compilers import (
     detect_c_compiler, detect_cpp_compiler, compiler_from_language,
-    AppleClangCCompiler, AppleClangCPPCompiler, AppleClangObjCCompiler,
-    AppleClangObjCPPCompiler
 )
+from mesonbuild.compilers.c import AppleClangCCompiler
+from mesonbuild.compilers.cpp import AppleClangCPPCompiler
+from mesonbuild.compilers.objc import AppleClangObjCCompiler
+from mesonbuild.compilers.objcpp import AppleClangObjCPPCompiler
 from mesonbuild.dependencies import PkgConfigDependency
 import mesonbuild.modules.pkgconfig
 
@@ -171,7 +173,7 @@
         self.assertEqual(libhello_nolib.get_compile_args(), )
         self.assertEqual(libhello_nolib.get_pkgconfig_variable('foo', , None), 'bar')
         self.assertEqual(libhello_nolib.get_pkgconfig_variable('prefix', , None), self.prefix)
-        if version_compare(libhello_nolib.check_pkgconfig(libhello_nolib.pkgbin),">=0.29.1"):
+        if version_compare(PkgConfigDependency.check_pkgconfig(env, libhello_nolib.pkgbin),">=0.29.1"):
             self.assertEqual(libhello_nolib.get_pkgconfig_variable('escaped_var', , None), r'hello\ world')
         self.assertEqual(libhello_nolib.get_pkgconfig_variable('unescaped_var', , None), 'hello world')
 
@@ -180,7 +182,7 @@
             for name in {'ct', 'ct0'}:
                 ct_dep = PkgConfigDependency(name, env, kwargs)
                 self.assertTrue(ct_dep.found())
-                self.assertIn('-lct', ct_dep.get_link_args())
+                self.assertIn('-lct', ct_dep.get_link_args(raw=True))
 
     def test_pkgconfig_gen_deps(self):
         '''
@@ -343,12 +345,12 @@
         testdir = os.path.join(self.framework_test_dir, '4 qt')
         self.init(testdir, extra_args='-Dmethod=pkg-config')
         # Confirm that the dependency was found with pkg-config
-        mesonlog = self.get_meson_log()
+        mesonlog = self.get_meson_log_raw()
         if qt4 == 0:
-            self.assertRegex('\n'.join(mesonlog),
+            self.assertRegex(mesonlog,
                              r'Run-time dependency qt4 $modules: Core$ found: YES 4.* $pkg-config$')
         if qt5 == 0:
-            self.assertRegex('\n'.join(mesonlog),
+            self.assertRegex(mesonlog,
                              r'Run-time dependency qt5 $modules: Core$ found: YES 5.* $pkg-config$')
 
     @skip_if_not_base_option('b_sanitize')
@@ -378,8 +380,8 @@
         testdir = os.path.join(self.framework_test_dir, '4 qt')
         self.init(testdir, extra_args='-Dmethod=qmake')
         # Confirm that the dependency was found with qmake
-        mesonlog = self.get_meson_log()
-        self.assertRegex('\n'.join(mesonlog),
+        mesonlog = self.get_meson_log_raw()
+        self.assertRegex(mesonlog,
                          r'Run-time dependency qt5 $modules: Core$ found: YES .* $qmake$\n')
 
     def test_qt6dependency_qmake_detection(self):
@@ -398,8 +400,8 @@
         testdir = os.path.join(self.framework_test_dir, '4 qt')
         self.init(testdir, extra_args='-Dmethod=qmake')
         # Confirm that the dependency was found with qmake
-        mesonlog = self.get_meson_log()
-        self.assertRegex('\n'.join(mesonlog),
+        mesonlog = self.get_meson_log_raw()
+        self.assertRegex(mesonlog,
                          r'Run-time dependency qt6 $modules: Core$ found: YES .* $qmake$\n')
 
     def glob_sofiles_without_privdir(self, g):
@@ -615,7 +617,7 @@
 
         f = os.path.join(self.installdir, 'etc', 'etcfile.dat')
         found_mode = stat.filemode(os.stat(f).st_mode)
-        want_mode = 'rw------T'
+        want_mode = 'rw-------'
         self.assertEqual(want_mode, found_mode1:)
 
         f = os.path.join(self.installdir, 'usr', 'bin', 'runscript.sh')
@@ -650,7 +652,7 @@
         f = os.path.join(self.installdir, 'usr', 'share', 'sub1', 'second.dat')
         statf = os.stat(f)
         found_mode = stat.filemode(statf.st_mode)
-        want_mode = 'rwxr-x--t'
+        want_mode = 'rwxr-x--x'
         self.assertEqual(want_mode, found_mode1:)
         if os.getuid() == 0:
             # The chown failed nonfatally if we're not root
@@ -673,15 +675,15 @@
                 ('bin/trivialprog', '-rwxr-sr-x'),
                 ('include', 'drwxr-x---'),
                 ('include/config.h', '-rw-rwSr--'),
-                ('include/rootdir.h', '-r--r--r-T'),
+                ('include/rootdir.h', '-r--r--r--'),
                 ('lib', 'drwxr-x---'),
                 ('lib/libstat.a', '-rw---Sr--'),
                 ('share', 'drwxr-x---'),
                 ('share/man', 'drwxr-x---'),
                 ('share/man/man1', 'drwxr-x---'),
-                ('share/man/man1/foo.1', '-r--r--r-T'),
+                ('share/man/man1/foo.1', '-r--r--r--'),
                 ('share/sub1', 'drwxr-x---'),
-                ('share/sub1/second.dat', '-rwxr-x--t'),
+                ('share/sub1/second.dat', '-rwxr-x--x'),
                 ('subdir', 'drwxr-x---'),
                 ('subdir/data.dat', '-rw-rwSr--'),
         :
@@ -1080,15 +1082,12 @@
         also tested.
         '''
         testdir = os.path.join(self.framework_test_dir, '7 gnome')
-        mesonbuild.modules.gnome.native_glib_version = '2.20'
-        env = {'MESON_UNIT_TEST_PRETEND_GLIB_OLD': "1"}
-        try:
+        with mock.patch('mesonbuild.modules.gnome.GnomeModule._get_native_glib_version', mock.Mock(return_value='2.20')):
+            env = {'MESON_UNIT_TEST_PRETEND_GLIB_OLD': "1"}
             self.init(testdir,
                       inprocess=True,
                       override_envvars=env)
             self.build(override_envvars=env)
-        finally:
-            mesonbuild.modules.gnome.native_glib_version = None
 
     @skipIfNoPkgconfig
     def test_pkgconfig_usage(self):
@@ -1774,22 +1773,58 @@
         # If so, we can test that cmake works with "gcc -m32"
         self.do_one_test_with_nativefile('../cmake/1 basic', "'gcc', '-m32'")
 
-    @skipUnless(is_linux(), 'Test only applicable to Linux')
+    @skipUnless(is_linux() or is_osx(), 'Test only applicable to Linux and macOS')
     def test_install_strip(self):
         testdir = os.path.join(self.unit_test_dir, '103 strip')
         self.init(testdir)
         self.build()
 
         destdir = self.installdir + self.prefix
-        lib = os.path.join(destdir, self.libdir, 'liba.so')
+        if is_linux():
+            lib = os.path.join(destdir, self.libdir, 'liba.so')
+        else:
+            lib = os.path.join(destdir, self.libdir, 'liba.dylib')
         install_cmd = self.meson_command + 'install', '--destdir', self.installdir
 
         # Check we have debug symbols by default
         self._run(install_cmd, workdir=self.builddir)
-        stdout = self._run('file', '-b', lib)
-        self.assertIn('not stripped', stdout)
+        if is_linux():
+            # file can detect stripped libraries on linux
+            stdout = self._run('file', '-b', lib)
+            self.assertIn('not stripped', stdout)
+        else:
+            # on macOS we need to query dsymutil instead.
+            # Alternatively, check if __dyld_private is defined
+            # in the output of nm liba.dylib, but that is not
+            # 100% reliable, it needs linking to an external library
+            stdout = self._run('dsymutil', '--dump-debug-map', lib)
+            self.assertIn('symbols:', stdout)
 
         # Check debug symbols got removed with --strip
         self._run(install_cmd + '--strip', workdir=self.builddir)
-        stdout = self._run('file', '-b', lib)
-        self.assertNotIn('not stripped', stdout)
+        if is_linux():
+            stdout = self._run('file', '-b', lib)
+            self.assertNotIn('not stripped', stdout)
+        else:
+            stdout = self._run('dsymutil', '--dump-debug-map', lib)
+            self.assertNotIn('symbols:', stdout)
+
+    def test_isystem_default_removal_with_symlink(self):
+        env = get_fake_env()
+        cpp = detect_cpp_compiler(env, MachineChoice.HOST)
+        default_dirs = cpp.get_default_include_dirs()
+        default_symlinks = 
+        with tempfile.TemporaryDirectory() as tmpdir:
+            for i in range(len(default_dirs)):
+                symlink = f'{tmpdir}/default_dir{i}'
+                default_symlinks.append(symlink)
+                os.symlink(default_dirsi, symlink)
+            self.assertFalse(cpp.compiler_args(f'-isystem{symlink}' for symlink in default_symlinks).to_native())
+
+    def test_freezing(self):
+        testdir = os.path.join(self.unit_test_dir, '109 freeze')
+        self.init(testdir)
+        self.build()
+        with self.assertRaises(subprocess.CalledProcessError) as e:
+            self.run_tests()
+        self.assertNotIn('Traceback', e.exception.output)

_service:tar_scm:meson-0.63.2.tar.gz/unittests/machinefiletests.py -> _service:tar_scm:meson-1.0.1.tar.gz/unittests/machinefiletests.py Changed

@@ -42,6 +42,7 @@
 
 
 from run_tests import (
+    Backend,
     get_fake_env
 )
 
@@ -368,6 +369,23 @@
         self._single_implementation_compiler(
             'java', 'javac', 'javac 9.99.77', '9.99.77')
 
+    @skip_if_not_language('java')
+    def test_java_classpath(self):
+        if self.backend is not Backend.ninja:
+            raise SkipTest('Jar is only supported with Ninja')
+        testdir = os.path.join(self.unit_test_dir, '110 classpath')
+        self.init(testdir)
+        self.build()
+        one_build_path = get_classpath(os.path.join(self.builddir, 'one.jar'))
+        self.assertIsNone(one_build_path)
+        two_build_path = get_classpath(os.path.join(self.builddir, 'two.jar'))
+        self.assertEqual(two_build_path, 'one.jar')
+        self.install()
+        one_install_path = get_classpath(os.path.join(self.installdir, 'usr/bin/one.jar'))
+        self.assertIsNone(one_install_path)
+        two_install_path = get_classpath(os.path.join(self.installdir, 'usr/bin/two.jar'))
+        self.assertIsNone(two_install_path)
+
     @skip_if_not_language('swift')
     def test_swift_compiler(self):
         wrapper = self.helper_create_binary_wrapper(

_service:tar_scm:meson-0.63.2.tar.gz/unittests/platformagnostictests.py -> _service:tar_scm:meson-1.0.1.tar.gz/unittests/platformagnostictests.py Changed

@@ -14,7 +14,10 @@
 
 import os
 import tempfile
+import subprocess
+import textwrap
 from unittest import skipIf
+from pathlib import Path
 
 from .baseplatformtests import BasePlatformTests
 from .helpers import is_ci
@@ -80,9 +83,8 @@
         self.assertNotIn(log_msg, output)
 
         # Check if message is written to the meson log
-        mesonlog = os.path.join(self.builddir, 'meson-logs/meson-log.txt')
-        with open(mesonlog, mode='r', encoding='utf-8') as file:
-            self.assertIn(log_msg, file.read())
+        mesonlog = self.get_meson_log_raw()
+        self.assertIn(log_msg, mesonlog)
 
     def test_new_subproject_reconfigure(self):
         testdir = os.path.join(self.unit_test_dir, '107 new subproject on reconfigure')
@@ -94,3 +96,28 @@
         # https://github.com/mesonbuild/meson/issues/10225.
         self.setconf('-Dfoo=enabled')
         self.build('reconfigure')
+
+    def check_connectivity(self):
+        import urllib
+        try:
+            with urllib.request.urlopen('https://wrapdb.mesonbuild.com') as p:
+                pass
+        except urllib.error.URLError as e:
+            self.skipTest('No internet connectivity: ' + str(e))
+
+    def test_update_wrapdb(self):
+        self.check_connectivity()
+        # Write the project into a temporary directory because it will add files
+        # into subprojects/ and we don't want to pollute meson source tree.
+        with tempfile.TemporaryDirectory() as testdir:
+            with Path(testdir, 'meson.build').open('w', encoding='utf-8') as f:
+                f.write(textwrap.dedent(
+                    '''
+                    project('wrap update-db',
+                      default_options: 'wrap_mode=forcefallback')
+
+                    zlib_dep = dependency('zlib')
+                    assert(zlib_dep.type_name() == 'internal')
+                    '''))
+            subprocess.check_call(self.wrap_command + 'update-db', cwd=testdir)
+            self.init(testdir, workdir=testdir)

_service:tar_scm:meson-0.63.2.tar.gz/unittests/subprojectscommandtests.py -> _service:tar_scm:meson-1.0.1.tar.gz/unittests/subprojectscommandtests.py Changed

@@ -103,15 +103,20 @@
         self._git_remote('commit', '--no-gpg-sign', '--allow-empty', '-m', f'tag {tag} commit', name)
         self._git_remote('tag', '--no-sign', tag, name)
 
-    def _wrap_create_git(self, name, revision='master'):
+    def _wrap_create_git(self, name, revision='master', depth=None):
         path = self.root_dir / name
         with open(str((self.subprojects_dir / name).with_suffix('.wrap')), 'w', encoding='utf-8') as f:
+            if depth is None:
+                depth_line = ''
+            else:
+                depth_line = 'depth = {}'.format(depth)
             f.write(textwrap.dedent(
                 '''
                 wrap-git
                 url={}
                 revision={}
-                '''.format(os.path.abspath(str(path)), revision)))
+                {}
+                '''.format(os.path.abspath(str(path)), revision, depth_line)))
 
     def _wrap_create_file(self, name, tarball='dummy.tar.gz'):
         path = self.root_dir / tarball
@@ -205,6 +210,15 @@
         self._subprojects_cmd('update', '--reset')
         self.assertEqual(self._git_local_commit(subp_name), self._git_remote_commit(subp_name))
 
+        # Create a fake remote git repository and a wrap file targeting
+        # HEAD and depth = 1. Checks that "meson subprojects download" works.
+        subp_name = 'sub3'
+        self._git_create_remote_repo(subp_name)
+        self._wrap_create_git(subp_name, revision='head', depth='1')
+        self._subprojects_cmd('download')
+        self.assertPathExists(str(self.subprojects_dir / subp_name))
+        self._git_config(self.subprojects_dir / subp_name)
+
     @skipIfNoExecutable('true')
     def test_foreach(self):
         self._create_project(self.subprojects_dir / 'sub_file')

_service:tar_scm:meson-0.63.2.tar.gz/unittests/taptests.py -> _service:tar_scm:meson-1.0.1.tar.gz/unittests/taptests.py Changed

_service:tar_scm:meson-0.63.2.tar.gz/unittests/windowstests.py -> _service:tar_scm:meson-1.0.1.tar.gz/unittests/windowstests.py Changed

@@ -32,7 +32,6 @@
 )
 from mesonbuild.compilers import (
     detect_c_compiler, detect_d_compiler, compiler_from_language,
-    GnuLikeCompiler
 )
 from mesonbuild.programs import ExternalProgram
 import mesonbuild.dependencies.base
@@ -222,21 +221,21 @@
     def test_link_environment_variable_lld_link(self):
         env = get_fake_env()
         comp = detect_c_compiler(env, MachineChoice.HOST)
-        if isinstance(comp, GnuLikeCompiler):
+        if comp.get_argument_syntax() == 'gcc':
             raise SkipTest('GCC cannot be used with link compatible linkers.')
         self._check_ld('lld-link', 'c', 'lld-link')
 
     def test_link_environment_variable_link(self):
         env = get_fake_env()
         comp = detect_c_compiler(env, MachineChoice.HOST)
-        if isinstance(comp, GnuLikeCompiler):
+        if comp.get_argument_syntax() == 'gcc':
             raise SkipTest('GCC cannot be used with link compatible linkers.')
         self._check_ld('link', 'c', 'link')
 
     def test_link_environment_variable_optlink(self):
         env = get_fake_env()
         comp = detect_c_compiler(env, MachineChoice.HOST)
-        if isinstance(comp, GnuLikeCompiler):
+        if comp.get_argument_syntax() == 'gcc':
             raise SkipTest('GCC cannot be used with link compatible linkers.')
         self._check_ld('optlink', 'c', 'optlink')