Struct XdgPather 

pub struct XdgPather { /* private fields */ }

XDG-compliant path resolver.

Reads standard environment variables (HOME, XDG_DATA_HOME, etc.) and the dodot-specific DOTFILES_ROOT. All paths can also be set explicitly via the builder for testing.

Implementations

impl XdgPather

pub fn builder() -> XdgPatherBuilder

Creates a builder for configuring an XdgPather.

pub fn from_env() -> Result<Self>

Creates an XdgPather using environment variables and XDG defaults.

Trait Implementations

impl Clone for XdgPather

fn clone(&self) -> XdgPather

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for XdgPather

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

Formats the value using the given formatter.

impl Pather for XdgPather

fn home_dir(&self) -> &Path

The user’s home directory (e.g. /home/alice).

fn dotfiles_root(&self) -> &Path

Root of the dotfiles repository.

fn data_dir(&self) -> &Path

XDG data directory for dodot (e.g. ~/.local/share/dodot).

fn config_dir(&self) -> &Path

XDG config directory for dodot (e.g. ~/.config/dodot).

fn cache_dir(&self) -> &Path

XDG cache directory for dodot (e.g. ~/.cache/dodot).

fn xdg_config_home(&self) -> &Path

XDG config home (e.g. ~/.config). Used by symlink handler for subdirectory target mapping.

fn shell_dir(&self) -> &Path

Shell scripts directory (e.g. ~/.local/share/dodot/shell).

fn pack_path(&self, pack: &str) -> PathBuf

Absolute path to a pack’s source directory.

fn pack_data_dir(&self, pack: &str) -> PathBuf

Data directory for a specific pack (e.g. .../data/packs/{pack}).

fn handler_data_dir(&self, pack: &str, handler: &str) -> PathBuf

Data directory for a specific handler within a pack (e.g. .../data/packs/{pack}/{handler}).

fn init_script_path(&self) -> PathBuf

Path to the generated shell init script.