cmake_workspace
Imports a checked CMake graph snapshot.
Description
The resolver reads a normalized snapshot produced from CMake's file-based application programming interface. It validates exact configuration input text and selection provenance, then creates one queryable cmake_target per selected configured target and transitive dependency.
This target does not configure or build the project. Pair it with cmake_project for execution.
Attributes
| Attribute | Type | Required | Default | Description |
|---|---|---|---|---|
snapshot | string | yes | Package-relative normalized CMake snapshot | |
resolver_inputs | list<string> | no | [] | Snapshot plus every text configuration input supplied to the resolver |
source_dir | string | no | . | Source directory recorded in selection provenance |
generator | string | no | Ninja | CMake generator recorded in selection provenance |
build_type | string | no | Debug | CMake build configuration recorded in selection provenance |
exports | list<string> | no | snapshot exports | Native CMake names or generated Once names to expose |
_cmake_resolved | bool | resolver-owned | false | Marks a workspace expanded by the resolver |
_cmake_snapshot_fingerprint | string | resolver-owned | empty | Canonical fingerprint from the checked snapshot |
_cmake_exports | list<string> | resolver-owned | [] | Generated names selected as roots |
The underscore-prefixed attributes are produced by the resolver and should not be set in once.toml.
Dependency Edges
| Edge | Accepts | Description |
|---|---|---|
deps | cmake_target | Resolver-generated logical CMake targets |
Providers
The target emits cmake_workspace with the snapshot fingerprint, selected exports, and imported target provider records.
Capabilities
This target has no executable capability.
Example
[[target]]
name = "CMakeGraph"
kind = "cmake_workspace"
srcs = ["CMakeLists.txt", "cmake-snapshot.json"]
[target.attrs]
snapshot = "cmake-snapshot.json"
resolver_inputs = ["CMakeLists.txt", "cmake-snapshot.json"]
generator = "Ninja"
build_type = "Release"
exports = ["greeting"]Graph loading rejects the snapshot when a bound input or selection value changes. See the CMake guide for the explicit refresh workflow.