Struct Paths 

#[non_exhaustive]
pub struct Paths {
    pub data_dir: PathBuf,
    pub config_path: PathBuf,
    pub db_path: PathBuf,
    pub blobs_dir: PathBuf,
}

Resolved on-disk locations for the Halfhand data directory.

#[non_exhaustive]: already only ever built via Paths::resolve / Paths::with_data_dir, never a struct literal; this just makes that the enforced contract so a future resolved path is additive.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

data_dir: PathBuf

The data directory itself ($XDG_DATA_HOME/halfhand by default).

config_path: PathBuf

The config file ($XDG_CONFIG_HOME/halfhand/config.toml).

db_path: PathBuf

The SQLite database file (<data_dir>/hh.db).

blobs_dir: PathBuf

The blob store root (<data_dir>/blobs).

Implementations

impl Paths

pub fn resolve(config: &Config) -> Result<Self>

Resolve paths from a loaded Config and the process environment.

Precedence (SRS §2.3): HH_DATA_DIR env > [storage] data_dir file > platform default. The config file location is always the platform default (not overridable via config, only via XDG_CONFIG_HOME).

pub fn with_data_dir(data_dir: PathBuf) -> Self

Construct paths with an explicit data directory (used by tests so they never touch the real data directory, per CLAUDE.md testing standards).

Trait Implementations

impl Clone for Paths

fn clone(&self) -> Paths

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Paths

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

Formats the value using the given formatter.

impl Eq for Paths

impl PartialEq for Paths

fn eq(&self, other: &Paths) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for Paths