Struct DhttpHome 

pub struct DhttpHome { /* private fields */ }

A handle to the user’s dhttp home directory (e.g. ~/.dhttp/).

DhttpHome describes a directory that contains per-identity profiles and a global settings file. It does not own any in-memory configuration data; it is purely a typed path with helpers for resolving the layout inside.

Implementations

impl DhttpHome

pub fn settings_path(&self) -> PathBuf

pub async fn load_settings( &self, ) -> Result<DhttpSettingsFile, LoadDhttpSettingsError>

pub fn new_settings(&self) -> DhttpSettingsFile

impl DhttpHome

pub async fn resolve_default_identity_profile( &self, ) -> Result<IdentityProfile, ResolveDefaultIdentityProfileError>

Read the settings file and resolve the default identity profile it points to.

impl DhttpHome

pub async fn resolve_identity_profile_exactly( &self, name: DhttpName<'_>, ) -> Result<IdentityProfile, ResolveIdentityProfileError>

Resolve name to an IdentityProfile by exact match only (no wildcard fallback).

pub async fn resolve_identity_profile_wildcard( &self, name: DhttpName<'_>, ) -> Result<IdentityProfile, ResolveIdentityProfileError>

Resolve name to an IdentityProfile by wildcard match only (no exact fallback).

pub async fn resolve_identity_profile( &self, name: DhttpName<'_>, ) -> Result<IdentityProfile, ResolveIdentityProfileError>

Resolve name to an IdentityProfile, trying exact match then wildcard match.

pub fn identity_profile_names( &self, ) -> impl Stream<Item = Result<DhttpName<'static>, ListIdentityProfilesError>>

Stream the names of all identity profiles that look like a valid <name>/ssl/ layout under this home directory.

pub async fn identity_profile_exists_exactly(&self, name: DhttpName<'_>) -> bool

pub async fn identity_profile_exists_wildcard( &self, name: DhttpName<'_>, ) -> bool

pub async fn identity_profile_exists(&self, name: DhttpName<'_>) -> bool

impl DhttpHome

pub fn join_identity_name(&self, name: DhttpName<'_>) -> PathBuf

pub fn identity_profile(&self, name: DhttpName<'_>) -> IdentityProfile

Construct an IdentityProfile handle for name without touching disk.

Use this when you only need the typed path (for example to compute a child file path). To verify that the directory actually exists, call DhttpHome::resolve_identity_profile instead.

impl DhttpHome

pub const DIR_NAME: &str = ".dhttp"

pub fn new(pathbuf: PathBuf) -> Self

pub fn for_user_home_dir(home_dir: impl Into<PathBuf>) -> Self

pub fn load_from_environment() -> Result<Self, LocateDhttpHomeError>

pub fn as_path(&self) -> &Path

pub fn join(&self, path: impl AsRef<Path>) -> PathBuf

Trait Implementations

impl AsRef<Path> for DhttpHome

fn as_ref(&self) -> &Path

Converts this type into a shared reference of the (usually inferred) input type.

impl Clone for DhttpHome

fn clone(&self) -> DhttpHome

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DhttpHome

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

Formats the value using the given formatter.