Skip to content
rootformDocs

Command

rootform list policy-packs

Markdown
On this pageOverview

list policy-packs reads the current project's selection. Repeat --policy-pack with a local authoring root to overlay a Policy Pack of the same name for this invocation. Other selected Policy Packs remain active. --installed reads the Rootform home without loading the project. This reports accessible content, not remote availability.

Usage

rootform list policy-packs [options]
SHELL

Options

Output

FlagTypeDefaultDescription
--formatstring""output format: text|wide|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

Rootform home

FlagTypeDefaultDescription
--installedboolfalselist versions installed in the Rootform home

Global options

FlagTypeDefaultDescription
-h, --helpboolfalseshow how to use rootform list policy-packs
--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 without changing the project's selection.

rootform list policy-packs --policy-pack ./policy-packs/baseline --format wide
rootform list policy-packs --policy-pack ./policy-packs/baseline --format json
Shell

The wide row reads baseline, version 0.1.0, and two Policies. Default output is one name per line. --format wide adds version and Policy count. --format json includes exact version and content digest. Output goes to standard output, diagnostics to standard error. Status 0 means the definitions were listed, 2 means the command was used incorrectly, 3 means the project selection or catalog could not be loaded, and 4 means the Rootform home could not be read or the listing could not be written. Use show policy-pack for one Policy Pack and Select Dialects and Policy Packs for project selection.