TCPM is a CMakePresets.json transformation tool that generates presets for the cartesian product of a set of parameters. For example, given two toolchains :
"toolchain": [
"gcc",
"clang"
],
and two different c++ language standards:
"standard": [
"cpp-20",
"cpp-23"
],
the tcpm tool will generate four (4) configuration presets:
{
"name": "configure-gcc-cpp-20"
},
{
"name": "configure-gcc-cpp-23"
},
{
"name": "configure-clang-cpp-20"
},
{
"name": "configure-clang-cpp-23"
},
If you added a third parameter list with two items then TCPM would generate eight (8) configurations, the cartesian product producing \(|A| \times |B| = |A| * |B|\) items.
TCPM also provides a template language to allow generation of various preset fields like "cacheVariables". These templates, called “shapes” in the json, are given contextual tokens to use in string expansion and, for more complex logic, the pQuery DSL embedded in TCPM allows procedural expansion of fields based on the state of a presets document at the time a given preset is generated.
There’s a lot more to it, of course, and TCPM provides a complete JSON transformation language for presets json in in addition to other features. To get started we reccommend starting with the Try Me exercise.
Key Features
Matrix Builds – Provides a way to manage large matrices of build types for complex projects that doesn’t require copy-and-paste or a lot of typing 😩
Idempotent – The tool will continue to produce the same output given the same parameters as inputs. This allows automated generation of CMakePresets.json files from themselves or using separate template files.
Preserves Existing Presets – Any presets that are manually added to a CMakePresets.json file will be maintained when using the “expand-in-place” features of this tool.
Release files for tcpm 0.3.3
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| tcpm-0.3.3.tar.gz | 30.7 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| tcpm-0.3.3-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 63.5 kB
Release files / tcpm-0.3.3.tar.gz
| Download URL | tcpm-0.3.3.tar.gz |
|---|---|
| Size | 30.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
2bf048ffb12c0fad4cef8763d26ac34b8d3fdfe097ebc15a3bf2b65a92a35c1a
|
|
BLAKE2b-256 checksum How to use checksums |
969ee211d8b113e88cc1a2e62491be033a0738c8e8b574c1ff23f1c034819387
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.12.8
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Apr 1, 2025.
Transparency logRelease files / tcpm-0.3.3-py3-none-any.whl
| Download URL | tcpm-0.3.3-py3-none-any.whl |
|---|---|
| Size | 32.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
4cc2c96c58a297d722e8dd83809e3fddfff20bde11cf6bd46c9b6629bcb9694d
|
|
BLAKE2b-256 checksum How to use checksums |
258991f1bcd4b587836f003f486f810624d161e03f17924f79407be6993fbb31
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.12.8
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Apr 1, 2025.
Transparency log