Configuration

The GPP Client stores user-specific settings in a local TOML file. This includes:

  • The active GPP environment

  • API tokens for each environment

  • A flag that controls whether OS environment variables may be used

The configuration system is implemented in the following modules:

  1. Config — the high-level interface used by the client and CLI

  2. Defaults — built-in default values (paths, filenames, baseline environment)

  3. Environment — the GPPEnvironment enum

  4. Models — Pydantic models representing the configuration file

This section documents each of these pieces in detail.

Note

The resolution of credentials (how URLs/tokens are chosen at runtime) is covered separately in Credentials.