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 app_support_dir(&self) -> &Path

Application-support root, the third filesystem coordinate the symlink resolver understands.

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 log_dir(&self) -> PathBuf

Log directory for dodot (e.g. ~/.cache/dodot/logs).

fn init_script_path(&self) -> PathBuf

Path to the generated shell init script.

fn deployment_map_path(&self) -> PathBuf

Path to the deployment map TSV, overwritten on every up / down. See docs/proposals/profiling.lex §3.2.

fn last_up_path(&self) -> PathBuf

Path to a single-line file recording the unix timestamp of the most recent successful dodot up. Used by dodot probe shell-init to flag profiles captured before that up as stale. Absent until the first up runs.

fn probes_shell_init_dir(&self) -> PathBuf

Directory where shell-init profile reports are written, one TSV per shell start. See docs/proposals/profiling.lex §3.1.

fn probes_brew_cache_dir(&self) -> PathBuf

On-disk cache for homebrew-cask probe data. One JSON file per cask token; TTL-based invalidation. See docs/proposals/macos-paths.lex §8.2.