formae eval

Evaluate a forma and print the resolved result. eval runs the same evaluation that apply does, so you can inspect exactly what a forma resolves to before you apply it. It does not change any infrastructure.

formae eval [flags] <forma file>

Examples

formae eval forma.pkl
formae eval --mode patch forma.pkl
formae eval --output-consumer machine --output-schema yaml forma.pkl

Reuse evaluated input

Starting with formae 0.90.4, save the full machine JSON output when several commands must use exactly the same evaluated values:

umask 077
formae eval --mode reconcile --output-consumer machine --output-schema json main.pkl > reviewed.json
formae apply --mode reconcile --simulate --output-consumer machine reviewed.json

Use the same file and explicit mode for observation, review, and submission. This prevents a new Pkl evaluation from generating different random values between steps. JSON input is already evaluated and does not accept property overrides. Private and unclassified input-property values are omitted from the input manifest. Evaluated resource values can still contain secrets; keep the file with the other private review artifacts. Changes to the declaration or relevant infrastructure still require a fresh review.

Flags

Flag	Default	Description
`--mode <reconcile\|patch>`	`reconcile`	Apply mode to evaluate against.
`--schema-location <remote\|local>`	`remote`	How plugin PKL schemas are referenced when serializing the evaluated forma. `remote` emits `package://` URIs fetched from the hub. `local` emits local file imports against the agent’s on-disk PklProject paths, and requires the CLI and agent to share a filesystem.
`--output-consumer <human\|machine>`	`human`	Consumer of the command result.
`--output-schema <json\|yaml>`	`json`	The schema to use for the result output.
`--config <path>`		Path to a config file.
`--profile <name>`		Named profile to use.

Like apply and destroy, eval also exposes the property flags declared by the forma it evaluates.

Get started

Guides

Concepts

Reference

Examples

Reuse evaluated input

Flags

​Examples

​Reuse evaluated input

​Flags

Examples

Reuse evaluated input

Flags