Skip to main content

Tools to make compiling C/C++ projects easy

Project description


C/C++ build tools that requires almost no configuration.





Copyright (C) 2011-2016 Zomojo Pty Ltd



Manual section:


Manual group:



ct-* [compilation args] [filename.cpp] [–variant=<VARIANT>]


The various ct-* tools exist to build C/C++ executables with almost no configuration. For example, to build a C or C++ program, type

ct-cake --auto

which will try to determine the correct source files to generate executables from and also determine the tests to build and run.

A variant is a configuration file that specifies various configurable settings like the compiler and compiler flags. Common variants are “debug” and “release”.

Options are parsed using python-configargparse. This means they can be passed in on the command line, as environment variables or in config files. Command-line values override environment variables which override config file values which override defaults. Note that the environment variables are captilized. That is, a command line option of –magic=cpp is the equivalent of an environment variable MAGIC=cpp.

If the option itself starts with a hypen then configargparse can fail to parse it as you intended. For example, on many platforms,


will fail. To work around this, compiletools postprocesses the options to understand quotes. For example,


will work on all platforms. Note however that many shells (e.g., bash) will strip quotes so you need to escape the quotes or single quote stop the shell preprocessing. For example,


Other notable tools are

* ct-headertree: provides information about structure of the include files
* ct-filelist:   provides the list of files needed to be included in a tarball (e.g. for packaging)


  • ct-build

  • ct-build-dynamic-library

  • ct-build-static-library

  • ct-cache

  • ct-cache-clean

  • ct-cake

  • ct-cmakelists

  • ct-commandline

  • ct-config

  • ct-cppdeps

  • ct-create-cmakelists

  • ct-create-makefile

  • ct-filelist

  • ct-findtargets

  • ct-gitroot

  • ct-headertree

  • ct-jobs

  • ct-list-variants

  • ct-magicflags

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

compiletools-4.1.93.tar.gz (93.0 kB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page