Struct ConfigManager 

pub struct ConfigManager<F: FileSystem> { /* private fields */ }

Implementations

impl ConfigManager<OsFileSystem>

pub fn new() -> Result<Self, Error>

Creates a new ConfigManager with the default filesystem and config directory.

Errors

Returns an error if the home directory cannot be determined.

impl<F: FileSystem> ConfigManager<F>

pub const fn with_fs(fs: F, config_dir: PathBuf) -> Self

pub fn config_dir(&self) -> &Path

Get the configuration directory path

pub fn skipped_endpoints_to_warnings( skipped_endpoints: &[SkippedEndpoint], ) -> Vec<ValidationWarning>

Convert skipped endpoints to validation warnings for display

pub fn get_strict_preference(&self, api_name: &str) -> Result<bool, Error>

Get the strict mode preference for an API

Errors

Returns an error if the global config cannot be loaded

pub fn format_validation_warnings( warnings: &[ValidationWarning], total_operations: Option<usize>, indent: &str, ) -> Vec<String>

Display validation warnings with custom prefix

pub fn display_validation_warnings( warnings: &[ValidationWarning], total_operations: Option<usize>, )

Display validation warnings to stderr

pub fn add_spec( &self, name: &str, file_path: &Path, force: bool, strict: bool, ) -> Result<(), Error>

Adds a new OpenAPI specification to the configuration from a local file.

Errors

Returns an error if:

• The spec already exists and force is false
• File I/O operations fail
• The OpenAPI spec is invalid YAML
• The spec contains unsupported features

Panics

Panics if the spec path parent directory is None (should not happen in normal usage).

pub async fn add_spec_from_url( &self, name: &str, url: &str, force: bool, strict: bool, ) -> Result<(), Error>

Adds a new OpenAPI specification to the configuration from a URL.

Errors

Returns an error if:

• The spec already exists and force is false
• Network requests fail
• The OpenAPI spec is invalid YAML
• The spec contains unsupported features
• Response size exceeds 10MB limit
• Request times out (30 seconds)

Panics

Panics if the spec path parent directory is None (should not happen in normal usage).

pub async fn add_spec_auto( &self, name: &str, file_or_url: &str, force: bool, strict: bool, ) -> Result<(), Error>

Adds a new OpenAPI specification from either a file path or URL.

This is a convenience method that automatically detects whether the input is a URL or file path and calls the appropriate method.

Errors

Returns an error if:

• The spec already exists and force is false
• File I/O operations fail (for local files)
• Network requests fail (for URLs)
• The OpenAPI spec is invalid YAML
• The spec contains unsupported features
• Response size exceeds 10MB limit (for URLs)
• Request times out (for URLs)

pub fn list_specs(&self) -> Result<Vec<String>, Error>

Lists all registered API contexts.

Errors

Returns an error if the specs directory cannot be read.

pub fn remove_spec(&self, name: &str) -> Result<(), Error>

Removes an API specification from the configuration.

Errors

Returns an error if the spec does not exist or cannot be removed.

pub fn edit_spec(&self, name: &str) -> Result<(), Error>

Opens an API specification in the default editor.

Errors

Returns an error if:

• The spec does not exist.
• The $EDITOR environment variable is not set.
• The editor command fails to execute.

pub fn load_global_config(&self) -> Result<GlobalConfig, Error>

Loads the global configuration from config.toml.

Errors

Returns an error if the configuration file exists but cannot be read or parsed.

pub fn save_global_config(&self, config: &GlobalConfig) -> Result<(), Error>

Saves the global configuration to config.toml.

Errors

Returns an error if the configuration cannot be serialized or written.

pub fn set_setting( &self, key: &SettingKey, value: &SettingValue, ) -> Result<(), Error>

Sets a global configuration setting value.

Uses toml_edit to preserve comments and formatting in the config file.

Arguments

• key - The setting key to modify
• value - The value to set

Errors

Returns an error if the config file cannot be read, parsed, or written.

pub fn get_setting(&self, key: &SettingKey) -> Result<SettingValue, Error>

Gets a global configuration setting value.

Arguments

• key - The setting key to retrieve

Errors

Returns an error if the config file cannot be read or parsed.

pub fn list_settings(&self) -> Result<Vec<SettingInfo>, Error>

Lists all available configuration settings with their current values.

Errors

Returns an error if the config file cannot be read or parsed.

pub fn set_url( &self, api_name: &str, url: &str, environment: Option<&str>, ) -> Result<(), Error>

Sets the base URL for an API specification.

Arguments

• api_name - The name of the API specification
• url - The base URL to set
• environment - Optional environment name for environment-specific URLs

Errors

Returns an error if the spec doesn’t exist or config cannot be saved.

pub fn get_url( &self, api_name: &str, ) -> Result<(Option<String>, HashMap<String, String>, String), Error>

Gets the base URL configuration for an API specification.

Arguments

• api_name - The name of the API specification

Returns

A tuple of (base_url_override, environment_urls, resolved_url)

Errors

Returns an error if the spec doesn’t exist.

pub fn list_urls( &self, ) -> Result<HashMap<String, (Option<String>, HashMap<String, String>)>, Error>

Lists all configured base URLs across all API specifications.

Returns

A map of API names to their URL configurations

Errors

Returns an error if the config cannot be loaded.

pub fn set_secret( &self, api_name: &str, scheme_name: &str, env_var_name: &str, ) -> Result<(), Error>

Sets a secret configuration for a specific security scheme

Arguments

• api_name - The name of the API specification
• scheme_name - The name of the security scheme
• env_var_name - The environment variable name containing the secret

Errors

Returns an error if the spec doesn’t exist or config cannot be saved.

pub fn list_secrets( &self, api_name: &str, ) -> Result<HashMap<String, ApertureSecret>, Error>

Lists configured secrets for an API specification

Arguments

• api_name - The name of the API specification

Returns

A map of scheme names to their secret configurations

Errors

Returns an error if the spec doesn’t exist.

pub fn get_secret( &self, api_name: &str, scheme_name: &str, ) -> Result<Option<ApertureSecret>, Error>

Gets a secret configuration for a specific security scheme

Arguments

• api_name - The name of the API specification
• scheme_name - The name of the security scheme

Returns

The secret configuration if found

Errors

Returns an error if the spec doesn’t exist.

pub fn remove_secret( &self, api_name: &str, scheme_name: &str, ) -> Result<(), Error>

Removes a specific secret configuration for a security scheme

Arguments

• api_name - The name of the API specification
• scheme_name - The name of the security scheme to remove

Errors

Returns an error if the spec doesn’t exist or if the scheme is not configured

pub fn clear_secrets(&self, api_name: &str) -> Result<(), Error>

Removes all secret configurations for an API specification

Arguments

• api_name - The name of the API specification

Errors

Returns an error if the spec doesn’t exist

pub fn set_secret_interactive(&self, api_name: &str) -> Result<(), Error>

Configure secrets interactively for an API specification

Loads the cached spec to discover available security schemes and presents an interactive menu for configuration.

Arguments

• api_name - The name of the API specification

Errors

Returns an error if:

• The spec doesn’t exist
• Cannot load cached spec
• User interaction fails
• Cannot save configuration

Panics

Panics if the selected scheme is not found in the cached spec (this should never happen due to menu validation)