Struct Config 

pub struct Config {

    pub config_dir: PathBuf,
    pub cache_dir: PathBuf,
    pub bin_dir: PathBuf,
    pub build_dir: PathBuf,
    pub resolve_cache_timeout: Duration,
    pub offline: bool,
    pub locked: bool,
    pub refresh: bool,
    pub toolchain: Option<String>,
    pub log_level: Option<String>,
    pub verbosity: Verbosity,
    pub default_registry: Option<String>,
    pub prebuilt_binaries: PrebuiltBinariesConfig,
    pub http: HttpConfig,
    pub tools: HashMap<String, ToolConfig>,
    pub aliases: HashMap<String, String>,
}

Configuration settings for cgx.

Configuration is loaded from multiple sources in order of precedence (later sources override earlier ones):

1. Hard-coded defaults
2. System-wide config file (/etc/cgx.toml on Linux/macOS)
3. User config file ($XDG_CONFIG_HOME/cgx/cgx.toml or platform equivalent)
4. Directory hierarchy from filesystem root to current directory (each cgx.toml found)
5. Command-line arguments (highest priority)

Fields

config_dir: PathBuf

Directory where config files are stored

cache_dir: PathBuf

The cache directory where various levels of cache are located

bin_dir: PathBuf

Directory where compiled binaries that can be re-used are stored

build_dir: PathBuf

Directory for ephemeral build artifacts.

Temporary directories for source extraction and compilation are created here. Only the final compiled binary is retained; all other build artifacts are cleaned up.

resolve_cache_timeout: Duration

How long to keep resolved crate information in the cache before re-resolving

offline: bool

locked: bool

refresh: bool

toolchain: Option<String>

Rust toolchain to use for building (e.g., “nightly”, “1.70.0”, “stable”)

log_level: Option<String>

Logging filter expression from the config file (e.g., “info”, “debug”, “cgx=debug,info”).

verbosity: Verbosity

Logging/build verbosity from the repeated -v CLI flag.

The single source from which both the tracing level and cargo’s -v count are derived.

default_registry: Option<String>

Default registry to use instead of crates.io when no registry is explicitly specified

prebuilt_binaries: PrebuiltBinariesConfig

How or whether to look for pre-built binaries published for the crates being run.

http: HttpConfig

HTTP client configuration for registry queries, binary downloads, and API calls.

tools: HashMap<String, ToolConfig>

Pinned tool versions and configurations.

Tools listed here will use the specified version/source instead of being resolved dynamically. This allows pinning critical tools to specific versions.

aliases: HashMap<String, String>

Tool name aliases.

Maps convenient names to actual crate names. For example, rg -> ripgrep. Note that aliases shadow actual crate names, so aliased crates become inaccessible.

Implementations

impl Config

pub fn load(overrides: &ConfigOverrides) -> Result<Self>

Load the configuration, honoring config files and command line arguments.

Configuration is loaded from multiple sources with the following precedence (later sources override earlier ones):

1. Hard-coded defaults
2. System-wide config file
3. User config file
4. Directory hierarchy config files (from root to current directory)
5. Command-line arguments (highest priority)

pub fn tools_toml(&self) -> Result<String>

Render the merged configured tools and aliases as deterministic TOML.

Both the [tools] and [aliases] headers are always present (even when empty), so the output is a stable template a user can copy and edit. Each section’s presence is decided from the data (whether the map is empty), not by scanning the serializer’s output.

pub fn load_from_dir(cwd: &Path, overrides: &ConfigOverrides) -> Result<Self>

Load config from the CLI args and a specified directory which may or may not contain config files.

Trait Implementations

impl Clone for Config

fn clone(&self) -> Config

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Config

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for Config

fn default() -> Self

Returns the “default value” for a type.