mrexodia
/
cmkr
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
335 Commits
2 Branches
47 Tags
1.1 MiB
 
 
Branches Tags
${ item.name }
Create tag ${ searchTerm }
Create branch ${ searchTerm }
from '9cdd0f7344'
${ noResults }
Go to file
Duncan Ogilvie 9cdd0f7344
Escape lists when generating commands 		3 years ago
.github Document template targets 3 years ago
cmake Bump to 0.2.12 3 years ago
docs Add install.optional flag 3 years ago
include Add install.optional flag 3 years ago
src Escape lists when generating commands 3 years ago
tests Temporarily remove the crt-linkage and library-linkage options 3 years ago
third_party prelim vcpkg manifest support 4 years ago
.clang-format WIP DSL for generating cmake 4 years ago
.gitattributes Merge cmkrlib into the cmkr target 4 years ago
.gitignore Fix warnings on AppleClang 12 4 years ago
CMakeLists.txt Bump to 0.2.12 3 years ago
LICENSE Create LICENSE 4 years ago
README.md Update credits 3 years ago
cmake.toml Bump to 0.2.12 3 years ago

README.md

cmkr

cmkr, pronounced "cmaker", is a modern build system based on CMake and TOML.

cmkr parses cmake.toml files and generates a modern, idiomatic CMakeLists.txt for you. A minimal example:

[project]
name = "cmkr_for_beginners"

[target.hello_world]
type = "executable"
sources = ["src/main.cpp"]

cmkr can bootstrap itself from CMake and you only need CMake to use it.

Getting started

To get started run the following commands from your project directory:

curl https://raw.githubusercontent.com/build-cpp/cmkr/main/cmake/cmkr.cmake -o cmkr.cmake
cmake -P cmkr.cmake

After the bootstrapping process finishes, modify cmake.toml and open the project in your favorite IDE or build with CMake:

cmake -B build
cmake --build build

Once bootstrapped, cmkr does not introduce extra steps to your workflow. After modifying cmake.toml you simply build/configure your CMake project and cmkr will automatically regenerate CMakeLists.txt.

In CI settings the cmkr bootstrapping process is skipped so there is no extra configure-time overhead in your pipelines.

Template repositories

Another way to get started is to use the cmkr_for_beginners template repository. Either open it in Gitpod, or clone the repository and run:

cmake -B build
cmake --build build

Check out the cmkr topic, the build-cpp organization or the tests for more examples and templates.

Command line

Optionally you can put a cmkr release in your PATH and use it as a utility from the command line:

Usage: cmkr [arguments]
arguments:
    init    [executable|library|shared|static|interface] Starts a new project in the same directory.
    gen                                                  Generates CMakeLists.txt file.
    build   <extra cmake args>                           Run cmake and build.
    install                                              Run cmake --install. Needs admin privileges.
    clean                                                Clean the build directory.
    help                                                 Show help.
    version                                              Current cmkr version.

Credits