C++1z automated make
USAGE
Automeka automatically finds and builds your projects without any configuration. Automeka assumes that the source tree represents the logical structure of projects.
Automeka exclusively uses Clang for compilation for now, as it requires the not-yet-standardized C++ modules.
- Any folder containing a
src
or aninclude
folder is considered as a module named after the folder. - Regarding include paths,
include
folder is assumed to contain the public interface of the module. Thesrc
folder is assumed to contain the private interface of the module. [1] - Each source file found in the
src
folder of a module is compiled into an object. - Each object is then scanned for a main function. A library is created for each module, with all the objects that do not contain a main function.
- For each object with a main function, an executable is created and linked against all the module's libraries it depends on. [2]
[1] | Each module should provide a module.modulemap file in its include folder, describing
the module's headers and libraries to link against. |
[2] | Libraries to link against are described in the module's module.modulemap file. See
http://clang.llvm.org/docs/Modules.html for more information. |
BUILD
Automeka currently uses Ninja for resolving build order and executing tasks. The goal is not to rely on some external make program, and this should be internalized.
Ninja is also required for bootstraping Automeka, when no precursor is available.
# bootstrap automeka
ninja
# rebuild automeka with itself and C++ modules enabled
./build/automeka
LICENSE
This is free and unencumbered software released into the public domain.
See accompanying file UNLICENSE or copy at http://unlicense.org/UNLICENSE