Struct BaseUrlResolver 

pub struct BaseUrlResolver<'a> { /* private fields */ }

Resolves the base URL for an API based on a priority hierarchy

Implementations

impl<'a> BaseUrlResolver<'a>

pub const fn new(spec: &'a CachedSpec) -> Self

Creates a new URL resolver for the given spec

pub fn with_global_config(self, config: &'a GlobalConfig) -> Self

Sets the global configuration for API-specific overrides

pub fn with_environment(self, env: Option<String>) -> Self

Sets the environment explicitly (overrides APERTURE_ENV)

pub fn resolve(&self, explicit_url: Option<&str>) -> String

Resolves the base URL according to the priority hierarchy:

1. Explicit parameter (for testing)
2. Per-API config override with environment support
3. Environment variable: APERTURE_BASE_URL
4. Cached spec default
5. Fallback: https://api.example.com

pub fn resolve_with_variables( &self, explicit_url: Option<&str>, server_var_args: &[String], ) -> Result<String, Error>

Resolves the base URL with server variable substitution support

Arguments

• explicit_url - Explicit URL override (for testing)
• server_var_args - Server variable arguments from CLI (e.g., ["region=us", "env=prod"])

Returns

• Ok(String) - Resolved URL with variables substituted
• Err(Error) - Server variable validation or substitution errors

Errors

Returns errors for:

• Invalid server variable format or values
• Missing required server variables
• URL template substitution failures

pub fn get_api_config(&self) -> Option<&ApiConfig>

Gets the API config if available