Configuration

The gpp config command group provides utilities for managing client-side configuration settings used by the GPP Client. This includes setting or displaying the API URL, authentication token, and other environment-specific defaults.

Use these commands to inspect or override the default behavior of the CLI across sessions.

gpp config

 gpp config Usage: gpp config [OPTIONS] COMMAND [ARGS]... Manage GPP client configuration settings. ╭─ Options ────────────────────────────────────────────────────────────────────╮ │--helpShow this message and exit.│ ╰──────────────────────────────────────────────────────────────────────────────╯ ╭─ Commands ───────────────────────────────────────────────────────────────────╮ │path            Display the absolute path to the configuration file.      │ │show            Display the current configuration in TOML format.         │ │set-token       Store a token for an environment.                         │ │set-credentials Store a token and activate the environment.               │ │clear-token     Remove stored token for a specific environment.           │ │clear-tokens    Remove all stored tokens.                                 │ │activate        Set the active environment.                               │ │enable-env-vars Enable reading credentials from environment variables.    │ │disable-env-varsDisable reading credentials from environment variables.   │ │list-tokens     List all stored tokens and the environments they belong   │ │to.                                                       │ │init            Create an empty configuration file.                       │ │defaults        Show default values and environment variable names.       │ ╰──────────────────────────────────────────────────────────────────────────────╯

gpp config path

 gpp config path Usage: gpp config path [OPTIONS] Display the absolute path to the configuration file. ╭─ Options ────────────────────────────────────────────────────────────────────╮ │--helpShow this message and exit.│ ╰──────────────────────────────────────────────────────────────────────────────╯

gpp config show

 gpp config show Usage: gpp config show [OPTIONS] Display the current configuration in TOML format. ╭─ Options ────────────────────────────────────────────────────────────────────╮ │--helpShow this message and exit.│ ╰──────────────────────────────────────────────────────────────────────────────╯

gpp config set-token

 gpp config set-token Usage: gpp config set-token [OPTIONS] ENV:{development|staging|production}  TOKEN Store a token for an environment. ╭─ Arguments ──────────────────────────────────────────────────────────────────╮ │*env  ENV:{development|staging|proEnvironment to store the token│ │duction}                    for.                          │ │[required]                    │ │*tokenTEXT                        Bearer token to store.│ │[required]            │ ╰──────────────────────────────────────────────────────────────────────────────╯ ╭─ Options ────────────────────────────────────────────────────────────────────╮ │--no-saveApply the change without writing to disk.[default: True]│ │--helpShow this message and exit.│ ╰──────────────────────────────────────────────────────────────────────────────╯

gpp config set-credentials

 gpp config set-credentials Usage: gpp config set-credentials [OPTIONS]  ENV:{development|staging|production}                                   TOKEN Store a token and activate the environment. ╭─ Arguments ──────────────────────────────────────────────────────────────────╮ │*env  ENV:{development|staging|proEnvironment to store the token│ │duction}                    for.                          │ │[required]                    │ │*tokenTEXT                        Bearer token to store.│ │[required]            │ ╰──────────────────────────────────────────────────────────────────────────────╯ ╭─ Options ────────────────────────────────────────────────────────────────────╮ │--no-activateDo not activate the environment after storing the    │ │token.                                               │ │--no-saveApply the change without writing to disk.│ │[default: True]                          │ │--helpShow this message and exit.│ ╰──────────────────────────────────────────────────────────────────────────────╯

gpp config clear-token

 gpp config clear-token Usage: gpp config clear-token [OPTIONS] ENV:{development|staging|production} Remove stored token for a specific environment. ╭─ Arguments ──────────────────────────────────────────────────────────────────╮ │*envENV:{development|staging|produEnvironment to clear token for│ │ction}                        [required]                    │ ╰──────────────────────────────────────────────────────────────────────────────╯ ╭─ Options ────────────────────────────────────────────────────────────────────╮ │--no-saveApply change without writing to disk.[default: True]│ │--helpShow this message and exit.│ ╰──────────────────────────────────────────────────────────────────────────────╯

gpp config clear-tokens

 gpp config clear-tokens Usage: gpp config clear-tokens [OPTIONS] Remove all stored tokens. ╭─ Options ────────────────────────────────────────────────────────────────────╮ │--no-saveApply change without writing to disk.[default: True]│ │--helpShow this message and exit.│ ╰──────────────────────────────────────────────────────────────────────────────╯

gpp config activate

 gpp config activate Usage: gpp config activate [OPTIONS] ENV:{development|staging|production} Set the active environment. ╭─ Arguments ──────────────────────────────────────────────────────────────────╮ │*envENV:{development|staging|produEnvironment to activate.│ │ction}                        [required]              │ ╰──────────────────────────────────────────────────────────────────────────────╯ ╭─ Options ────────────────────────────────────────────────────────────────────╮ │--no-saveApply change without writing to disk.[default: True]│ │--helpShow this message and exit.│ ╰──────────────────────────────────────────────────────────────────────────────╯

gpp config enable-env-vars

 gpp config enable-env-vars Usage: gpp config enable-env-vars [OPTIONS] Enable reading credentials from environment variables. ╭─ Options ────────────────────────────────────────────────────────────────────╮ │--no-saveApply change without writing to disk.[default: True]│ │--helpShow this message and exit.│ ╰──────────────────────────────────────────────────────────────────────────────╯

gpp config disable-env-vars

 gpp config disable-env-vars Usage: gpp config disable-env-vars [OPTIONS] Disable reading credentials from environment variables. ╭─ Options ────────────────────────────────────────────────────────────────────╮ │--no-saveApply change without writing to disk.[default: True]│ │--helpShow this message and exit.│ ╰──────────────────────────────────────────────────────────────────────────────╯

gpp config list-tokens

 gpp config list-tokens Usage: gpp config list-tokens [OPTIONS] List all stored tokens and the environments they belong to. ╭─ Options ────────────────────────────────────────────────────────────────────╮ │--helpShow this message and exit.│ ╰──────────────────────────────────────────────────────────────────────────────╯

gpp config init

 gpp config init Usage: gpp config init [OPTIONS] Create an empty configuration file. ╭─ Options ────────────────────────────────────────────────────────────────────╮ │--forceOverwrite existing config if present.│ │--helpShow this message and exit.│ ╰──────────────────────────────────────────────────────────────────────────────╯

gpp config defaults

 gpp config defaults Usage: gpp config defaults [OPTIONS] Show default values and environment variable names. ╭─ Options ────────────────────────────────────────────────────────────────────╮ │--helpShow this message and exit.│ ╰──────────────────────────────────────────────────────────────────────────────╯