/meson

The Meson Build System
  1. Python 78.0%
  2. Meson 12.4%
  3. C 6.6%
  4. C++ 1.1%
  5. Vim script 0.5%
  6. Vala 0.5%
  7. Other 0.9%
Python Meson C C++ Vim script Vala Other

Clone with HTTPS

Use Git or checkout with SVN using the web URL.

Open in Desktop Download ZIP
Find file
Switch branches/tags
Nothing to show
Latest commit c654e58 Sep 26, 2017 @jon-turney jon-turney committed with jpakkane Revert "Add an additional Cygwin package repo with patched ninja" 
This reverts commit 92c2bb7.

This is no longer needed, as a patched ninja is now available from the
standard Cygwin package repository, and prevents me from accidentally
breaking CI when changing things in my personal package repository.
Permalink
Failed to load latest commit information.
ci Revert "Add an additional Cygwin package repo with patched ninja" Sep 27, 2017
ciimage add support for cups dependencies (#2255) Aug 31, 2017
cross cross: Fix host_machine.system in the example iphone cross config. May 21, 2017
data rpm: pass --wrap-mode=nodownload to %meson Apr 28, 2017
docs Allow CustomTarget's to be indexed Sep 27, 2017
graphics Logo tweaking. Jul 3, 2015
man Bump numbers for new release. Aug 14, 2017
manual tests Stop manual test helper scripts on errors (#2149) Aug 2, 2017
mesonbuild Allow CustomTarget's to be indexed Sep 27, 2017
msi Merge pull request #2357 from LukeShu/flake8 Sep 22, 2017
syntax-highlighting/vim Vim syntax: new function add_test_setup() Feb 19, 2017
test cases Allow CustomTarget's to be indexed Sep 27, 2017
tools cmake2meson: convert varexp to lowercase Sep 14, 2017
.appveyor.yml Run VS2010 tests in a German locale to catch codepage errors. Sep 18, 2017
.coveragerc Enable code coverage on Travis. May 21, 2017
.editorconfig Add editorconfig file Oct 18, 2016
.gitattributes Created a git attributes file. Jun 7, 2014
.gitignore added *.pyc to .gitignore Jul 21, 2017
.mailmap mailmap: add couple of aliases Dec 14, 2016
.travis.yml Revert "Revert "Merge pull request #1931 from centricular/use-patched… Sep 18, 2017
COPYING Start of project. Dec 23, 2012
MANIFEST.in Bump version number for release. Dec 18, 2016
README.md typo Jul 14, 2017
__main__.py Reintroduce Python Zipapp support Oct 10, 2016
contributing.txt contributing.txt: Update link to FAQ (#2330) Sep 16, 2017
ghwt.py ghwt: Add a comment at the top briefly explaining what it is Sep 20, 2017
meson.py fix a typo in the UTF-8 warning message Sep 20, 2017
mesonconf.py Write deprecation warnings to stderr. Aug 2, 2017
mesonintrospect.py Write deprecation warnings to stderr. Aug 2, 2017
mesonrewriter.py flake8: Clean up complained-about unused imports Sep 21, 2017
mesontest.py Write deprecation warnings to stderr. Aug 2, 2017
run_cross_test.py run_project_tests: Clean on backends that can't install Apr 9, 2017
run_project_tests.py tests: Only error for lines starting with tabs Sep 20, 2017
run_tests.py Revert "Revert "Merge pull request #1931 from centricular/use-patched… Sep 18, 2017
run_unittests.py flake8: Perform suggested whitespace/formatting changes Sep 21, 2017
setup.cfg flake8: disable E731: do not assign a lambda expression, use a def Sep 21, 2017
setup.py Add mesonbuild.compilers to packages in setup.py Jun 27, 2017
sideci.yml add sideci.yml Dec 20, 2016
wraptool.py Back to .py suffix in files. Closes #394. Mar 2, 2016

README.md

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

Status

PyPI Travis Appveyor Codecov

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 vary between systems, be sure to use the Python 3 version of pip.

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 builddir; cd builddir; meson ..

or

cd source_root; mkdir builddir; meson builddir

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