gritpack app [OPTIONS] <COMMAND>
Commands
- install
- Install a command-line application for your user
- list
- List the applications installed for your user
- upgrade
- Upgrade installed applications to their newest versions
- which
- Show which installed application provides a command
- uninstall
- Remove an installed application
Options
Examples
$ gritpack app list
$ gritpack app upgrade
$ gritpack app which gritpack
gritpack app install
Install a command-line application for your user
gritpack app install [OPTIONS] <PACKAGE> [VERSION]
Arguments
<PACKAGE> | Name of the application package to install |
[VERSION] | Version or version requirement; the newest version when omitted |
Options
--dialect <DIALECT> | Language and version, such as c/c23, when several would match |
--encoding <ENCODING> | Source text encoding the package must have |
--target <TARGET> | Target platform; this machine's when omitted |
--home <HOME> | Per-user Gritpack installation rootDefault: ~/.frogfish/gritpack |
--format <FORMAT> | Output format: human or jsonDefault: human · Values: human, json |
--json[=<FIELDS>] | Same as --format json; --json=name,version keeps only those fields |
--jq <EXPRESSION> | Print the JSON output through a jq expression, strings unquoted |
-h, --help | Print help (see a summary with '-h') |
Hub connection
--hub <HUB> | The hub, as host[:port] or https://host[:port]Environment: GRITPACK_SERVER |
--cert <CERT> | Client certificate for the hubEnvironment: GRITPACK_CERT |
--key <KEY> | Private key for the client certificateEnvironment: GRITPACK_KEY |
--ca <CA> | Certificate authority used to authenticate the hubEnvironment: GRITPACK_CA |
--profile <PROFILE> | Login profile to use; cannot be combined with --hub, --cert, --key or --caEnvironment: GRITPACK_PROFILE |
--config <CONFIG> | Profile configuration fileEnvironment: GRITPACK_CONFIG · Default: ~/.frogfish/gritpack/config.toml |
--credentials-dir <CREDENTIALS_DIR> | With --hub alone: directory searched for your login; exactly one may be unexpiredEnvironment: GRITPACK_CREDENTIALS_DIR · Default: ~/.frogfish/gritpack/credentials |
--cache-dir <CACHE_DIR> | Directory of the shared cache of downloaded package filesEnvironment: GRITPACK_CACHE_DIR · Default: ~/.frogfish/gritpack/cache |
--jobs <JOBS> | How many package downloads to run at once (1-64)Environment: GRITPACK_JOBS · Default: 4 |
Use one hub only
--from <HUB> | Use only this hub, instead of the hubs your logins configure |
--from-cert <FROM_CERT> | Client certificate for the --from hub |
--from-key <FROM_KEY> | Private key for the --from client certificate |
--from-ca <FROM_CA> | Certificate authority used to authenticate the --from hub |
gritpack app list
List the applications installed for your user
gritpack app list [OPTIONS]
Options
--home <HOME> | Per-user Gritpack installation rootDefault: ~/.frogfish/gritpack |
--format <FORMAT> | Output format: human or jsonDefault: human · Values: human, json |
--json[=<FIELDS>] | Same as --format json; --json=name,version keeps only those fields |
--jq <EXPRESSION> | Print the JSON output through a jq expression, strings unquoted |
-h, --help | Print help |
gritpack app upgrade
Upgrade installed applications to their newest versions
gritpack app upgrade [OPTIONS] [PACKAGES]...
Arguments
[PACKAGES]... | Installed applications to upgrade; every installed application when omitted |
Options
--check | Only report which applications have a newer version; install nothing |
--home <HOME> | Per-user Gritpack installation rootDefault: ~/.frogfish/gritpack |
--format <FORMAT> | Output format: human or jsonDefault: human · Values: human, json |
--json[=<FIELDS>] | Same as --format json; --json=name,version keeps only those fields |
--jq <EXPRESSION> | Print the JSON output through a jq expression, strings unquoted |
-h, --help | Print help (see a summary with '-h') |
Hub connection
--hub <HUB> | The hub, as host[:port] or https://host[:port]Environment: GRITPACK_SERVER |
--cert <CERT> | Client certificate for the hubEnvironment: GRITPACK_CERT |
--key <KEY> | Private key for the client certificateEnvironment: GRITPACK_KEY |
--ca <CA> | Certificate authority used to authenticate the hubEnvironment: GRITPACK_CA |
--profile <PROFILE> | Login profile to use; cannot be combined with --hub, --cert, --key or --caEnvironment: GRITPACK_PROFILE |
--config <CONFIG> | Profile configuration fileEnvironment: GRITPACK_CONFIG · Default: ~/.frogfish/gritpack/config.toml |
--credentials-dir <CREDENTIALS_DIR> | With --hub alone: directory searched for your login; exactly one may be unexpiredEnvironment: GRITPACK_CREDENTIALS_DIR · Default: ~/.frogfish/gritpack/credentials |
--cache-dir <CACHE_DIR> | Directory of the shared cache of downloaded package filesEnvironment: GRITPACK_CACHE_DIR · Default: ~/.frogfish/gritpack/cache |
--jobs <JOBS> | How many package downloads to run at once (1-64)Environment: GRITPACK_JOBS · Default: 4 |
gritpack app which
Show which installed application provides a command
gritpack app which [OPTIONS] <COMMAND>
Arguments
<COMMAND> | Name of the command to look up |
Options
--home <HOME> | Per-user Gritpack installation rootDefault: ~/.frogfish/gritpack |
--format <FORMAT> | Output format: human or jsonDefault: human · Values: human, json |
--json[=<FIELDS>] | Same as --format json; --json=name,version keeps only those fields |
--jq <EXPRESSION> | Print the JSON output through a jq expression, strings unquoted |
-h, --help | Print help |
gritpack app uninstall
Remove an installed application
gritpack app uninstall [OPTIONS] <PACKAGE>
Arguments
<PACKAGE> | Name of the application package to remove |
Options
--home <HOME> | Per-user Gritpack installation rootDefault: ~/.frogfish/gritpack |
--format <FORMAT> | Output format: human or jsonDefault: human · Values: human, json |
--json[=<FIELDS>] | Same as --format json; --json=name,version keeps only those fields |
--jq <EXPRESSION> | Print the JSON output through a jq expression, strings unquoted |
-h, --help | Print help |