Synopsis

fcli tool env expr [-f=<file>] [--join=<joiner>] [--write-mode=<writeMode>] [--tools=<toolSelectors>[,<toolSelectors>…​]]…​ --expr=<expressions>…​ [--expr=<expressions>…​]…​ [[-h] [--env-prefix=<prefix>] [--log-file=<logFile>] [--log-level=<logLevel>] [--log-mask=<level>] [--debug]]

Description

Evaluates one or more template expressions against the selected installations. Combine results with --join and optionally write to a file.

Options

--expr=<expressions>…​

Template expression evaluated for each tool installation. Access fields like {installDir}, {binDir}, {cmd}, {version}, {defaultEnvPrefix}, and {aliases}. Specify the option multiple times to render multiple expressions.

-f, --file=<file>

File to append rendered expressions to. Omit to write directly to standard output.

--join=<joiner>

Separator used when combining expression results across installations. Supports escape sequences such as \n and \t. Default value: \n.

--tools=<toolSelectors>[,<toolSelectors>…​]

Comma-separated list of tool selectors in the form <tool-name>[:<version>]. Version selectors accept exact versions, aliases, partial semantic versions like '3' or '3.1', and '*' or 'all' to include every installed version. Defaults to the last installed version for each tool when omitted.

--write-mode=<writeMode>

File write mode when --file is specified. Allowed values: append|overwrite. Default: append.

Generic fcli options (also see documentation link below)

--debug

Enable collection of debug logs.

--env-prefix=<prefix>

Prefix for resolving default option values. Default value: FCLI_DEFAULT.

-h, --help

Use 'fcli [command] -h' to display help for fcli (sub-)commands.

--log-file=<logFile>

Write log output to file. Default: ./fcli.log if logging is enabled.

--log-level=<logLevel>

Set logging level: TRACE, DEBUG, INFO, WARN, ERROR, NONE.

--log-mask=<level>

Log mask level: high, medium, low, none. Default: medium. Masking is done on a best-effort basis; no guarantee that all sensitive data will be masked.