The Meson Build System

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

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