a small build system with a focus on speed
Go to file
Jan Niklas Hasse cc79afbc05 Delay actually opening log files until the first write, fix #1724
Calling DepsLog/BuildLog::OpenForWrite will now only save the file path.
The actual opening of the file (moved to OpenForWriteIfNeeded) happens
right before the first write attempt.

This is needed so that the files aren't held open when the generator
runs (i.e. RebuildManifest) as it may call tools like recompact which
won't be able to open the file on Windows.

The disadvantage is that now the error reporting happens at a later time
and will be reported as a failed write, not a failed open.
2020-05-23 18:44:25 +02:00
.github/workflows GitHub Actions: Run ninja_test directly 2020-05-14 11:07:24 +02:00
doc manual: remove "manifest" reference from the manual 2020-01-29 14:06:30 -05:00
misc test: skip non-Windows tests if on Windows 2020-04-27 11:39:48 -04:00
src Delay actually opening log files until the first write, fix #1724 2020-05-23 18:44:25 +02:00
.clang-format clang-format: Do not derive pointer binding from file 2020-02-05 18:08:54 +01:00
.editorconfig Add .editorconfig 2019-12-22 14:12:43 +01:00
.gitignore Remove some outdated lines from .gitignore 2019-12-20 14:58:19 +01:00
.travis.yml Travis CI: Remove broken Xcode config 2019-10-28 09:42:54 +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 only apply optional flags when compiler works 2020-04-06 02:38:13 -04:00
configure.py Replace references to README with README.md 2020-03-20 19:38:26 -04: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