`hci effect eval`

hci effect eval [OPTIONS] ATTRIBUTE

Evaluate an effect and print its derivation path.

This command evaluates the specified effect attribute without running it, printing the resulting derivation path to stdout. It is useful for inspecting effects, scripting, or passing the derivation to other tools.

This command pulls context from the repository and (by default) the Hercules CI API. See Implicit inputs.

Parameters

ATTRIBUTE

The attribute path that leads to the effect. Tab completion is sensitive to --pretend-branch and such, so you want to specify that first.

`--no-token`

Don’t get an API token. Allows use in an untrusted environment or unconfigured repo, but requires --project to be specified.

This does not inhibit use of a token provided via the HERCULES_CI_API_TOKEN variable.

`--pretend-branch BRANCH`

Pretend we’re on another git branch. This sets parameters like ref and branch and src.ref to match BRANCH value.

`--pretend-ref REF`

Pretend we’re on another git ref. This sets parameters like ref and branch and src.ref to match REF value.

`--pretend-tag TAG`

Pretend we’re on another git tag. This sets parameters like ref and tag and src.ref to match TAG value.

`--project PROJECT`

Project path, e.g. github/my-org/my-project. Default: auto-detected.

Implicit inputs

This command uses git metadata from the working directory, unless --pretend-ref REF (or similar) and --project PROJECT are specified.

Information such as the project id are looked up through the Hercules CI API.

Hercules CI API access is affected by the optional HERCULES_CI_API_BASE_URL and HERCULES_CI_API_TOKEN.