Struct ResolverContext 

pub struct ResolverContext {

    pub config_path: String,
    pub config_root: Option<Arc<Value>>,
    pub base_path: Option<PathBuf>,
    pub resolution_stack: Vec<String>,
    pub allow_http: bool,
    pub http_allowlist: Vec<String>,
    pub http_proxy: Option<String>,
    pub http_proxy_from_env: bool,
    pub http_ca_bundle: Option<PathBuf>,
    pub http_extra_ca_bundle: Option<PathBuf>,
    pub http_client_cert: Option<PathBuf>,
    pub http_client_key: Option<PathBuf>,
    pub http_client_key_password: Option<String>,
    pub http_insecure: bool,
}

Context provided to resolvers during resolution

Fields

config_path: String

The path in the config where this resolution is happening

config_root: Option<Arc<Value>>

The config root (for self-references)

base_path: Option<PathBuf>

The base path for relative file paths

resolution_stack: Vec<String>

Resolution stack for circular reference detection

allow_http: bool

Whether HTTP resolver is enabled

http_allowlist: Vec<String>

HTTP URL allowlist (glob patterns)

http_proxy: Option<String>

HTTP proxy URL (e.g., “http://proxy:8080” or “socks5://proxy:1080”)

http_proxy_from_env: bool

Whether to auto-detect proxy from environment variables (HTTP_PROXY, HTTPS_PROXY, NO_PROXY)

http_ca_bundle: Option<PathBuf>

Path to CA bundle PEM file (replaces default webpki-roots)

http_extra_ca_bundle: Option<PathBuf>

Path to extra CA bundle PEM file (appends to webpki-roots)

http_client_cert: Option<PathBuf>

Path to client certificate PEM or P12/PFX file (for mTLS)

http_client_key: Option<PathBuf>

Path to client private key PEM file (for mTLS, not needed for P12/PFX)

http_client_key_password: Option<String>

Password for encrypted private key or P12/PFX file

http_insecure: bool

DANGEROUS: Skip TLS certificate verification (dev only)

Implementations

impl ResolverContext

pub fn new(config_path: impl Into<String>) -> Self

Create a new resolver context

pub fn with_allow_http(self, allow: bool) -> Self

Set whether HTTP resolver is enabled

pub fn with_http_allowlist(self, allowlist: Vec<String>) -> Self

Set HTTP URL allowlist

pub fn with_http_proxy(self, proxy: impl Into<String>) -> Self

Set HTTP proxy URL

pub fn with_http_proxy_from_env(self, enabled: bool) -> Self

Set whether to auto-detect proxy from environment variables

pub fn with_http_ca_bundle(self, path: impl Into<PathBuf>) -> Self

Set CA bundle path (replaces webpki-roots)

pub fn with_http_extra_ca_bundle(self, path: impl Into<PathBuf>) -> Self

Set extra CA bundle path (appends to webpki-roots)

pub fn with_http_client_cert(self, path: impl Into<PathBuf>) -> Self

Set client certificate path for mTLS

pub fn with_http_client_key(self, path: impl Into<PathBuf>) -> Self

Set client private key path for mTLS

pub fn with_http_client_key_password(self, password: impl Into<String>) -> Self

Set password for encrypted private key or P12/PFX file

pub fn with_http_insecure(self, insecure: bool) -> Self

DANGEROUS: Skip TLS certificate verification

pub fn with_config_root(self, root: Arc<Value>) -> Self

Set the config root for self-references

pub fn with_base_path(self, path: PathBuf) -> Self

Set the base path for file resolution

pub fn would_cause_cycle(&self, path: &str) -> bool

Check if resolving a path would cause a circular reference

pub fn push_resolution(&mut self, path: &str)

Push a path onto the resolution stack

pub fn pop_resolution(&mut self)

Pop a path from the resolution stack

pub fn get_resolution_chain(&self) -> Vec<String>

Get the resolution chain for error reporting

Trait Implementations

impl Clone for ResolverContext

fn clone(&self) -> ResolverContext

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ResolverContext

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

Formats the value using the given formatter.