Magic build tool
Evoke is the simple solution to the complicated problem of build software for C++ and related languages.
Right now it is not available as a package for common operating systems yet. To install it, you will need to compile it from source.
It requires Boost 1.64 or higher; it uses boost.process (and boost.filesystem for MSVC). To compile, download the full source tree and type
makein the place you downloaded it to. Then, run
bin/evoke_maketo build evoke using itself. When this succeeds, you will have a
bin/evokethat does the same thing, but is built with Evoke. Copy this to
~/bin/evokefor a user-local installation or to
/usr/local/bin/evokefor a system-wide installation.
mkdir build && cd build # create build directory cmake .. # generate build system cmake --build . # build evoke
To use evoke, create a folder that is named after your project target, and create a
srcor
includefolder inside that. Evoke recognizes a
srcor
includefolder as the root of a component, and will name it after the directory tree navigated to get to it. For example, if you have a folder called
hello/srcit will create a component called
hello, and if your folder is called
thirdparty/catch/includeit will create a component called
thirdparty.catch.
Evoke reads all the source code found inside components this way and analyzes their dependencies through use of
#includeand
importstatements. It derives the full dependency tree of the source tree and uses it to determine which components will become a library and which will become an executable. Its rule is that any component with a link coming from something else must be a library (because something else is including its files), and any component without a link coming from something else must be an executable. To compile, simply type
evokeat the root of your project and it will compile the full set of source files with appropriate flags for the current version of c++ into libraries and executables.
Everybody is free to help with Evoke development. The simpler things that need to be done are to create issues for things you would like it to do, or for asking help when it does not do what you want it to. You can join the discord at https://includecpp.org . If you want to do more, there are a few open issues already that require a bit more knowledge and time investment, like porting it to run on Windows or OSX.
v0.2: Builds on Windows, MacOS and Linux.
v0.3: Toolsets fully separate, chainable and overrideable. Android is still a weird one out; need to make up my mind on how it should work. Package import config also fully separate. Modules support on Clang.
v0.3.1: Easy imports exist for VS Code and CLion. Need to find a mac to try XCode, and need to find a Windows to try MSVC. Should be very doable. Code is in a way better state now. Android is removed for now; making an APK is a packaging task, not a building task.
Next few milestones (in any order): - Have easy imports for evoke-built projects in XCode, MSVC, VS Code and CLion. - Get to 30% test coverage. Not to aim for a number, but to have at least some target. - Full integration with at least one package manager - export of needed file list, and import of package inputs.
v1.0 will be hit when:
Formatting of all source files is done using ClangFormat. Rules for it are specified in .clang-format file in the root of the repository.
Path: /.clang-format
Requires: LLVM version 6.0
Evoke is partially derived from https://github.com/tomtom-international/cpp-dependencies (Apache2 licensed) and partially from https://github.com/dascandy/bob (my copyright, also Apache2 unless I'm mistaking). Because of that it is also Apache2 licensed. If this does not work for you for some reason, reach out and I'll see what we can do/change.