a small build system with a focus on speed
Go to file
Jan Niklas Hasse d68f107f7a
Merge pull request #1979 from bradking/simplify-CanonicalizePath
util: Remove unnecessary CanonicalizePath error handling
2021-06-10 22:19:07 +02:00
.github/workflows Attempt to fix Linux CI build 2021-05-16 21:09:38 +01:00
doc Merge pull request #1907 from aDotInTheVoid/patch-1 2021-03-05 22:51:32 +01:00
misc Make output_test.py executable again (mistake thanks to WSL) 2021-06-10 21:30:10 +02:00
src Merge pull request #1979 from bradking/simplify-CanonicalizePath 2021-06-10 22:19:07 +02:00
windows Use UTF-8 on Windows 10 Version 1903, fix #1195 2021-02-17 21:59:20 +01:00
.clang-format clang-format: Do not derive pointer binding from file 2020-02-05 18:08:54 +01:00
.clang-tidy Merge pull request #1790 from neheb/bool 2020-12-06 12:15:06 +01:00
.editorconfig Add .editorconfig 2019-12-22 14:12:43 +01:00
.gitignore Ignore new clangd cache directory, too 2020-12-06 15:49:29 +01:00
appveyor.yml Fix MinGW bootstrap build by applying the fix in appveyor.yml permanently. 2019-08-26 18:49:47 +02:00
CMakeLists.txt cmake: use check_symbol_exists for browse support 2021-06-02 11:08:10 -04:00
configure.py Merge pull request #1331 from ilor/missingdeps3 2021-02-23 10:08:48 +01:00
CONTRIBUTING.md Use short CONTRIBUTING.md instead of HACKING.md 2019-11-24 12:58:31 +01:00
COPYING Revert 78f893bdbb 2017-05-15 18:41:22 -04:00
README.md Turn CONTRIBUTING.md into a link 2020-04-06 16:05:27 +02:00
RELEASING Use short CONTRIBUTING.md instead of HACKING.md 2019-11-24 12:58:31 +01:00

Ninja

Ninja is a small build system with a focus on speed. https://ninja-build.org/

See the manual or doc/manual.asciidoc included in the distribution for background and more details.

Binaries for Linux, Mac, and Windows are available at GitHub. Run ./ninja -h for Ninja help.

Installation is not necessary because the only required file is the resulting ninja binary. However, to enable features like Bash completion and Emacs and Vim editing modes, some files in misc/ must be copied to appropriate locations.

If you're interested in making changes to Ninja, read CONTRIBUTING.md first.

Building Ninja itself

You can either build Ninja via the custom generator script written in Python or via CMake. For more details see the wiki.

Python

./configure.py --bootstrap

This will generate the ninja binary and a build.ninja file you can now use to build Ninja with itself.

CMake

cmake -Bbuild-cmake -H.
cmake --build build-cmake

The ninja binary will now be inside the build-cmake directory (you can choose any other name you like).

To run the unit tests:

./build-cmake/ninja_test