The Meson Build System

Jussi Pakkanen b121822045 Disable asm test on Windows because it is blocking all CI. 7 年之前
cross 2b65083463 Fix cross test and run them if a cross compiler is available. 7 年之前
data 5bf22c5678 add support for $sharedstatedir 7 年之前
graphics 502497e3ca Logo tweaking. 9 年之前
man 8ce7412b35 Set version number for bugfix release. 7 年之前
manual tests fa10703124 fix "Meson encountered an error in file meson.build, line 19, column … (#1536) 7 年之前
mesonbuild c7f66c3a9e Merge pull request #1505 from centricular/dont-use-c++-for-assembly 7 年之前
syntax-highlighting f0ccbc649c Vim syntax: new function add_test_setup() 7 年之前
test cases b121822045 Disable asm test on Windows because it is blocking all CI. 7 年之前
tools dac8351ff1 cleanup: Unbound local variable 7 年之前
.appveyor.yml dc5b0a62f6 appveyor: Move msys2-mingw matrix a little higher 7 年之前
.editorconfig 07a53eeebb Add editorconfig file 8 年之前
.gitattributes 41f76025c1 Created a git attributes file. 10 年之前
.gitignore 701e393261 Make cross tests use same framework as regular tests. 7 年之前
.mailmap 8c24fc7761 mailmap: add couple of aliases 7 年之前
.travis.yml de45535b7d travis: Also set OBJC and OBJCXX to CC/CXX 7 年之前
COPYING a428c953ff Start of project. 11 年之前
MANIFEST.in d942243d50 Bump version number for release. 7 年之前
README.md 3f8b010670 Github md renderer requires spaces between hashes and the heading text. 7 年之前
__main__.py 4b5a0e5de7 Reintroduce Python Zipapp support 8 年之前
authors.txt d2548e6e83 strip trailing backslash from WindowsSDKVersion (#1538) 7 年之前
contributing.txt 87f07cdf3d Minor adjusts (#1001) 7 年之前
ghwt.py 859c5e28df Use context manager in scripts. 8 年之前
meson.py 4ef495c596 Do not warn about non-utf8 locales on Windows. 7 年之前
mesonconf.py 455e55f8e5 Back to .py suffix in files. Closes #394. 8 年之前
mesonintrospect.py 455e55f8e5 Back to .py suffix in files. Closes #394. 8 年之前
mesonrewriter.py 14ca7d602c Store subdir information for each node so we can remove files set in other subdirectories. 7 年之前
mesontest.py f5b43eef1b mesontest: Support passing test arguments at runtime 7 年之前
run_cross_test.py 701e393261 Make cross tests use same framework as regular tests. 7 年之前
run_project_tests.py f4f9272e87 project tests: Don't look for PDB files on MinGW/GCC 7 年之前
run_tests.py 8df671b6f3 run_tests: Don't run unit tests when the VS backend is selected 7 年之前
run_unittests.py b121822045 Disable asm test on Windows because it is blocking all CI. 7 年之前
setup.cfg 57ec097b5f vs: Use CompilerArgs() for compile and link args 7 年之前
setup.py acdf5c2e71 Bump version number for release. 7 年之前
sideci.yml 39ab311019 add sideci.yml 7 年之前
wraptool.py 455e55f8e5 Back to .py suffix in files. Closes #394. 8 年之前

README.md

Meson® is a project to create the best possible next-generation build system.

Status

PyPI Travis Appveyor

Dependencies

  • Python (version 3.4 or newer)
  • Ninja (version 1.5 or newer)

Installing from source

You can run Meson directly from a revision control checkout or an extracted tarball. If you wish you can install it locally with the standard Python distutils command python3 setup.py install <your options here>.

Meson is also available from PyPi, so it can be installed with pip3 install meson (this does not require a source checkout, pip will download the package automatically). The exact command to type to install with pip can very between systems, be sure to use the Python 3 version of pip.

Creating a standalone script

Meson can be run as a Python zip app. To generate the executable run the following command:

python3 -m zipapp -p '/usr/bin/env python3' -m meson:main -o meson <source checkout>

Note that the source checkout may not be meson because it would clash with the generated binary name.

This will zip all files inside the source checkout into the script which includes hundreds of tests, so you might want to temporarily remove those before running it.

Running

Meson requires that you have a source directory and a build directory and that these two are different. In your source root must exist a file called 'meson.build'. To generate the build system run this command:

meson <source directory> <build directory>

Depending on how you obtained Meson the command might also be called meson.py instead of plain meson. In the rest of this document we are going to use the latter form.

You can omit either of the two directories, and Meson will substitute the current directory and autodetect what you mean. This allows you to do things like this:

cd source_root; mkdir build; cd build; meson ..

or

cd source_root; mkdir build; meson build

To compile, cd into your build directory and type ninja. To run unit tests, type ninja test.

Install is the same but it can take an extra argument:

DESTDIR=/destdir/path ninja install

DESTDIR can be omitted. If you are installing to system directories, you may need to run this command with sudo.

Contributing

We love code contributions. See the contributing.txt file for details.

IRC

The irc channel for Meson is #mesonbuild over at Freenode.

Further info

More information about the Meson build system can be found at the project's home page.

Meson is a registered trademark of Jussi Pakkanen