Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/annacrombie/muon
An implementation of the meson build system in c99
https://github.com/annacrombie/muon
build-system c99 meson
Last synced: about 2 months ago
JSON representation
An implementation of the meson build system in c99
- Host: GitHub
- URL: https://github.com/annacrombie/muon
- Owner: annacrombie
- License: gpl-3.0
- Created: 2021-07-03T00:08:27.000Z (about 3 years ago)
- Default Branch: master
- Last Pushed: 2024-07-09T18:33:43.000Z (3 months ago)
- Last Synced: 2024-07-11T09:45:26.612Z (2 months ago)
- Topics: build-system, c99, meson
- Language: C
- Homepage: https://muon.build
- Size: 4.68 MB
- Stars: 136
- Watchers: 10
- Forks: 9
- Open Issues: 13
-
Metadata Files:
- Readme: README.md
- License: LICENSES/Apache-2.0.txt
Awesome Lists containing this project
README
# [muon]
muon is an implementation of the meson build system in c99 with minimal
dependencies.
## Features
- `muon analyze` - a static analyzer for meson.build files. [demo]
- `muon fmt` - a meson.build code formatter
- An interactive stepping debugger with the `dbg()` function.
- A built-in cross platform [ninja implementation]
- [fast]
## Status
`muon` is close to feature-complete with the core of meson for `c` and `c++`.
See the [status page] for more detailed information.
Things missing include:
- cross-compilation support
- build optimizations like pch and unity
- some `b_` options
- dependencies with a custom configuration tool
- many modules
Other differences from meson are described in `doc/differences.md`
If you want to contribute, try using `muon` to build your favorite project.
Patches and bug reports welcome!
Additionally, muon is not fully supported on all platforms yet. The current
status may be viewed on muon's [ci dashboard]. Platforms with some or all tests
disabled are currently WIP and platforms not tested in CI have unknown status.
In general, posix systems should work fine.
## Dependencies
Essential:
- A c99 compatible toolchain
For `pkgconf` support:
- `libpkgconf`
- `pkgconf` or `pkg-config`
For `[wrap-file]` support:
- `libcurl`
- `libarchive`
To build documentation:
- `scdoc` for muon.1 and meson.build.5
- `python3` and `py3-yaml` for meson-reference.3
To run most project tests:
- `python3`
## Install
If you already have meson or muon and are not interested in bootstrapping, you
can just do a typical meson configure, build, install:
```
$meson setup build
cd build
ninja build
$meson test
$meson install
```
Otherwise, you must bootstrap muon.
The bootstrapping process has two stages. The first stage produces a `muon`
binary capable of building itself (but not necessarily anything else). The
second stage produces the final binary.
Stage 1:
```
./bootstrap.sh build
```
This will by default build a ninja implementation (samu) into the resulting
executable. To disable this behavior use `CFLAGS=-DBOOTSTRAP_NO_SAMU`.
Stage 2:
```
build/muon setup build
build/muon -C build samu
build/muon -C build test
build/muon -C build install
```
## Contribute
Please refer to the [contributing guide] before sending patches. Send patches
on the [mailing list], report issues on the [issue tracker], and discuss in
[#muon on libera.chat].
## License
`muon` is licensed under the GPL version 3 (see LICENSE). Tests under
`tests/project` were copied from the [meson project tests] and are licensed
under [Apache 2.0].
## Credits
Although I had already had the idea to re-implement meson in C, I was initially
inspired to actually go out and do it when I saw [boson]. `muon`'s code was
originally based on `boson`, though has since been almost completely rewritten.
[muon]: https://muon.build
[contributing guide]: https://git.sr.ht/~lattis/muon/tree/master/item/doc/contributing.md
[mailing list]: https://lists.sr.ht/~lattis/muon/
[issue tracker]: https://todo.sr.ht/~lattis/muon/
[#muon on libera.chat]: ircs://irc.libera.chat/#muon
[meson project tests]: https://github.com/mesonbuild/meson/tree/master/test%20cases
[Apache 2.0]: https://www.apache.org/licenses/LICENSE-2.0.txt
[boson]: https://sr.ht/~bl4ckb0ne/boson/
[status page]: https://muon.build/releases/edge/docs/status.html
[Fast]: https://github.com/annacrombie/meson-raytracer#performance
[demo]: https://play.muon.build
[ninja implementation]: https://git.sr.ht/~lattis/muon/tree/master/item/src/external/samurai/README.md
[ci dashboard]: https://muon.build/muon_ci.html