The Meson Build System
http://mesonbuild.com/
You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
96 lines
3.0 KiB
96 lines
3.0 KiB
<p align="center"> |
|
<img src="http://mesonbuild.com/meson_logo.png"> |
|
</p> |
|
Meson® is a project to create the best possible next-generation |
|
build system. |
|
|
|
#### Status |
|
|
|
[](https://pypi.python.org/pypi/meson) |
|
[](https://travis-ci.org/mesonbuild/meson) |
|
[](https://ci.appveyor.com/project/jpakkane/meson) |
|
|
|
#### Dependencies |
|
|
|
- [Python](http://python.org) (version 3.4 or newer) |
|
- [Ninja](https://ninja-build.org) (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](https://pypi.python.org/pypi/meson), 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](https://docs.python.org/3/library/zipapp.html). 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](http://mesonbuild.com). |
|
|
|
Meson is a registered trademark of Jussi Pakkanen
|
|
|