Struct TalosConfig 

pub struct TalosConfig {
    pub context: Option<String>,
    pub contexts: HashMap<String, TalosContext>,
}

Represents the entire talosctl configuration file structure

Fields

context: Option<String>

The currently active context name

contexts: HashMap<String, TalosContext>

Map of context names to their configurations

Implementations

impl TalosConfig

pub fn load_default() -> Result<Self>

Load configuration from the default location (~/.talos/config)

Errors

Returns an error if:

• The home directory cannot be determined
• The config file cannot be read
• The config file is malformed

pub fn load_from_path<P: AsRef<Path>>(path: P) -> Result<Self>

Load configuration from a specific path

Arguments

• path - Path to the talosconfig file

Errors

Returns an error if:

• The file cannot be read
• The file is malformed YAML

pub fn from_yaml(yaml: &str) -> Result<Self>

Parse configuration from YAML string

Arguments

• yaml - YAML content as string

Errors

Returns an error if the YAML is malformed

pub fn default_path() -> Result<PathBuf>

Get the default config file path (~/.talos/config)

Errors

Returns an error if the home directory cannot be determined

pub fn config_path() -> Result<PathBuf>

Get the path to the config file, respecting TALOSCONFIG environment variable

Errors

Returns an error if the home directory cannot be determined when TALOSCONFIG is not set

pub fn active_context(&self) -> Option<&TalosContext>

Get the currently active context

Returns

Returns None if no active context is set or if the context doesn’t exist

pub fn get_context(&self, name: &str) -> Option<&TalosContext>

Get a context by name

Arguments

• name - The context name to retrieve

pub fn context_names(&self) -> Vec<&str>

List all available context names

pub fn load_with_env() -> Result<Self>

Load configuration with environment variable overrides

This method respects the following environment variables:

• TALOSCONFIG: Path to the config file (default: ~/.talos/config)
• TALOS_CONTEXT: Override the active context
• TALOS_ENDPOINTS: Override endpoints (comma-separated)
• TALOS_NODES: Override target nodes (comma-separated)

Example

use talos_api_rs::config::TalosConfig;

// Load config with env overrides
let config = TalosConfig::load_with_env()?;

// Get effective context (may be overridden by TALOS_CONTEXT)
if let Some(ctx) = config.active_context() {
    println!("Using endpoints: {:?}", ctx.endpoints);
}

pub fn effective_context_name(&self) -> Option<&str>

Get the effective context name (respects TALOS_CONTEXT env var)

Trait Implementations

impl Clone for TalosConfig

fn clone(&self) -> TalosConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TalosConfig

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for TalosConfig

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for TalosConfig

fn eq(&self, other: &TalosConfig) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for TalosConfig

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for TalosConfig