Struct Config 

pub struct Config {
    pub output: OutputConfig,
    pub test: TestSelection,
    pub network: NetworkConfig,
    pub servers: ServerSelection,
    pub custom_user_agent: Option<String>,
    pub strict: bool,
}

Main configuration struct composed of semantic sub-structs.

Groups related configuration into cohesive units for better code organization:

• OutputConfig — output and display settings
• TestSelection — test execution controls
• NetworkConfig — network and TLS settings
• ServerSelection — server filtering options

Fields

output: OutputConfig

Output and display configuration

test: TestSelection

Test execution controls

network: NetworkConfig

Network and transport configuration

servers: ServerSelection

Server selection criteria

custom_user_agent: Option<String>

Custom user agent (file config only, not CLI)

strict: bool

Strict validation mode

Implementations

impl Config

pub fn from_args(args: &Args) -> Self

Build configuration from parsed CLI arguments and the config file.

Converts Args into ConfigSource first (the sole CLI→config bridge), then builds sub-structs from the source abstraction.

Note: This method does NOT call validate_and_report(). For validation with warnings/errors, use from_args_with_file() instead, which also avoids loading the config file twice.

Example

use clap::Parser;
use netspeed_cli::cli::Args;
use netspeed_cli::config::{Config, Format};

// Parse CLI arguments (same as the main entry point)
let args = Args::parse_from(["netspeed-cli", "--format", "json", "--timeout", "30"]);

let config = Config::from_args(&args);
assert_eq!(config.timeout(), 30);
assert_eq!(config.format(), Some(Format::Json));
assert!(!config.no_download()); // unset flags default to false

pub fn from_args_with_file( source: &ConfigSource, file_config: Option<File>, ) -> (Self, ValidationResult)

Build configuration from parsed CLI arguments with a pre-loaded config file.

This is the preferred constructor in production code because it:

1. Eliminates double file loading (file config passed directly)
2. Returns a ValidationResult for reporting warnings/errors
3. Does NOT print or exit — callers control error handling

For test code that doesn’t need validation, use from_source() with a hand-built ConfigSource.

Example

use clap::Parser;
use netspeed_cli::cli::Args;
use netspeed_cli::config::{Config, ConfigSource, ValidationResult};

// Parse CLI arguments and convert to ConfigSource
let args = Args::parse_from(["netspeed-cli", "--format", "json"]);
let source = ConfigSource::from_args(&args);

// Load config file (or pass None for defaults)
let file_config = netspeed_cli::config::load_config_file();

// Build config with validation results
let (config, validation) = Config::from_args_with_file(&source, file_config);

// Handle validation results
for warning in &validation.warnings {
    eprintln!("Warning: {warning}");
}

// Continue with config...
assert_eq!(config.format(), Some(netspeed_cli::config::Format::Json));

pub fn from_source(source: &ConfigSource) -> Self

Build configuration from a ConfigSource and the config file.

This constructor operates entirely within the config layer — no dependency on crate::cli::Args. Exposed as pub so that external test crates can construct a Config from a hand-built ConfigSource without going through CLI parsing.

Side-effect free: This method does NOT print to stderr or exit. Call Config::validate_and_report() separately to emit validation warnings/errors, or use Config::from_args_with_file() which handles validation automatically.

Merge Strategy

Values are resolved with CLI > file > hardcoded defaults priority:

• Option<bool> fields (e.g., bytes, no_download): cli.or(file).unwrap_or(false) — CLI wins when Some, file is the fallback, false when both are None.

• Option<String> fields (e.g., ca_cert, tls_version): cli.or(file) — CLI wins, file is the fallback, None when both are absent.

• u64 fields (e.g., timeout): If the CLI value equals the hardcoded default, the file value is tried first; otherwise the CLI value wins. This lets --timeout 10 (the default) fall through to the file config while an explicit --timeout 30 always takes effect.

• char fields (e.g., csv_delimiter): If the CLI value equals the hardcoded default (,), the file value is used; otherwise the CLI value wins.

Example

External crates can build a Config without CLI parsing by constructing a ConfigSource from its sub-source structs:

use netspeed_cli::config::{
    Config, ConfigSource, Format, NetworkSource, OutputSource,
};

let source = ConfigSource {
    output: OutputSource {
        format: Some(Format::Json),
        quiet: Some(true),
        ..Default::default()
    },
    network: NetworkSource {
        timeout: 30,
        ..Default::default()
    },
    ..Default::default()
};

let config = Config::from_source(&source);
assert_eq!(config.timeout(), 30);
assert_eq!(config.format(), Some(Format::Json));

pub fn validate_and_report( &self, source: &ConfigSource, file_config: Option<File>, ) -> ValidationResult

Validate configuration and emit warnings/errors.

This method handles the side effects that were removed from from_source(): printing validation errors/warnings and exiting in strict mode. Call this after building config from CLI args.

Returns the ValidationResult so callers can decide how to handle failures (e.g., exit in strict mode, log in normal mode).

Example

use netspeed_cli::config::{Config, ConfigSource};

let source = ConfigSource::default();
let config = Config::from_source(&source);

// Emit validation warnings/errors
let result = config.validate_and_report(&source, None);
for error in &result.errors {
    eprintln!("Error: {error}");
}
for warning in &result.warnings {
    eprintln!("Warning: {warning}");
}

// Exit if strict mode and validation failed
if config.strict() && !result.valid {
    std::process::exit(1);
}

pub fn should_save_history(&self) -> bool

Whether test results should be saved to history.

Machine-readable formats (JSON, JSONL, CSV) corrupt stdout when mixed with history output, so we skip saving in those cases.

Example

use netspeed_cli::config::Config;

let config = Config::default();
// Default format is Detailed → should save history
assert!(config.should_save_history());

pub fn no_download(&self) -> bool

Whether to skip download test.

pub fn no_upload(&self) -> bool

Whether to skip upload test.

pub fn single(&self) -> bool

Whether to use single connection mode.

pub fn bytes(&self) -> bool

Whether to display values in bytes instead of bits.

pub fn simple(&self) -> bool

Whether to use simple output format.

pub fn csv(&self) -> bool

Whether to output in CSV format.

pub fn json(&self) -> bool

Whether to output in JSON format.

pub fn quiet(&self) -> bool

Whether to suppress all progress output.

pub fn list(&self) -> bool

Whether to display server list and exit.

pub fn minimal(&self) -> bool

Whether to use minimal ASCII-only output.

pub fn theme(&self) -> Theme

The color theme for terminal output.

pub fn csv_delimiter(&self) -> char

The CSV field delimiter.

pub fn csv_header(&self) -> bool

Whether to include CSV headers.

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

The user profile for customized output.

pub fn format(&self) -> Option<Format>

The output format (supersedes legacy –json/–csv/–simple).

pub fn timeout(&self) -> u64

The HTTP request timeout in seconds.

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

The source IP address to bind to.

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

Path to custom CA certificate for TLS.

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

Minimum TLS version (1.2 or 1.3).

pub fn pin_certs(&self) -> bool

Whether speedtest.net/ookla.com TLS domain restriction is enabled.

pub fn server_ids(&self) -> &[String]

Specific server IDs to use (empty = auto-select).

pub fn exclude_ids(&self) -> &[String]

Server IDs to exclude from selection.

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

Custom user agent string (file config only).

pub fn strict(&self) -> bool

Whether strict validation mode is enabled.

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 ConfigProvider for Config

fn config(&self) -> &Config

impl Debug for Config

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

Formats the value using the given formatter.

impl Default for Config

fn default() -> Config

Returns the “default value” for a type.

impl From<&Config> for Settings

Build Settings from a crate::config::Config reference.

Centralizes the Config→HTTP bridging so callers don’t duplicate the mapping. Resolves custom_user_agent from file config or default.

This impl lives in http.rs (not config.rs) to preserve layering: dependency flows http → config, not config → http.

fn from(config: &Config) -> Self

Converts to this type from the input type.