dascandy/ evoke

C++

Shell

Need help with evoke?

Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

dascandy

131 Stars

16 Forks

Apache License 2.0

340 Commits

18 Opened issues

Description

Magic build tool

Services available

Need anything else?

Contributors list

PeterBindels-TomTom PeterBindels-TomTom

# 239,877

Shell

websock...

c-plus-...

166 commits

Peter Bindels dascandy

# 399,897

C++

Shell

55 commits

Darkin JulienGrv

# 291,397

Shell

can-bus

C++

10 commits

Mohammed Alyousef MoAlyousef

# 183,998

Shell

Rust

toml

8 commits

Michael Vlach michaelvlach

# 181,061

bdd

Shell

cpp11

tdd

4 commits

Jon Hanks jonhanks

# 629,853

Git

Objecti...

passwor...

c-plus-...

2 commits

Matt Godbolt mattgodbolt

# 6,173

Shell

dlang

assembl...

Haskell

2 commits

miheer vaidya vmiheer

# 502,715

Objecti...

Shell

Jupyter...

tensors

2 commits

Luca lukka

# 225,116

C++

Shell

musl

1 commit

Thomas Heller sithhell

# 123,167

Shell

C++

c-plus-...

paralle...

1 commit

Readme

Evoke

Name: evoke
Brand: evoke
SKU: //dascandy/evoke
Rating: 2.0775 (131 reviews)

Evoke is the simple solution to the complicated problem of build software for C++ and related languages.

Table of Contents

Build Instructions

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

make

in the place you downloaded it to. Then, run

bin/evoke_make

to build evoke using itself. When this succeeds, you will have a

bin/evoke

that does the same thing, but is built with Evoke. Copy this to

~/bin/evoke

for a user-local installation or to

/usr/local/bin/evoke

for a system-wide installation.

mkdir build && cd build  # create build directory
cmake ..  # generate build system
cmake --build .  # build evoke

Usage

To use evoke, create a folder that is named after your project target, and create a

src

include

folder inside that. Evoke recognizes a

src

include

folder 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/src

it will create a component called

hello

, and if your folder is called

thirdparty/catch/include

it 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

#include

and

import

statements. 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

evoke

at 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.

Development

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.

Short Term Goals

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:

All of the above
Packaged & shipped as DEB in Debian (ie, set up to...)
Packaged & shipped as installer for Windows (same)
Packaged & shipped as DMG for MacOS (same)
Available in OS package managers where they exist (brew/macports for MacOS and apt/snap for Ubuntu/Debian) (same)

Clang Format

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

License

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.