Skip to content
rootformDocs

Command

rootform show policy-pack

Markdown
On this pageOverview

show policy-pack displays a Policy Pack's version, declared Policies, content identity, and source location. It reads the current project's selection by default. Repeat --policy-pack with local authoring roots to overlay Policy Packs of the same names for this invocation. Other selected Policy Packs remain active; the positional name chooses one loaded Policy Pack.

Usage

rootform show policy-pack <name> [options]
SHELL

Options

Output

FlagTypeDefaultDescription
--formatstring""output format: text|json; default: text

Rootform project

FlagTypeDefaultDescription
--policy-packstringArray[]add or replace the Policy Pack at path, a source directory or a compiled file, for this command only; repeatable
--projectstring""read rootform.lock from project dir; paths stay relative to the working directory; default: the working directory

Global options

FlagTypeDefaultDescription
-h, --helpboolfalseshow how to use rootform show policy-pack
--colormodeautocolor human output: auto|always|never; default: auto
--no-pagerboolfalseprint a long report in full instead of opening it in less

From a checkout of the repository, inspect the public baseline Policy Pack. This shows identity and contained Policies; it does not evaluate them.

rootform show policy-pack baseline --policy-pack ./policy-packs/baseline
rootform show policy-pack baseline --policy-pack ./policy-packs/baseline --format json
Shell

The result names version 0.1.0 and two Policies. Text or JSON goes to standard output, diagnostics to standard error. Status 0 means the definition was shown, 1 means the named definition was not found, 2 means the command was used incorrectly, 3 means the selection was unavailable or the name was ambiguous, and 4 means the definition could not be written. Use list policy-packs for available Policy Pack names and Select Dialects and Policy Packs for project selection.