Struct ThingsConfig 

pub struct ThingsConfig {
    pub database_path: PathBuf,
    pub fallback_to_default: bool,
}

Configuration for Things 3 database access

Fields

database_path: PathBuf

Path to the Things 3 database

fallback_to_default: bool

Whether to use the default database path if the specified path doesn’t exist

Implementations

impl ThingsConfig

pub fn new<P: AsRef<Path>>(database_path: P, fallback_to_default: bool) -> Self

Create a new configuration with a custom database path

Arguments

• database_path - Path to the Things 3 database
• fallback_to_default - Whether to fall back to the default path if the specified path doesn’t exist

pub fn with_default_path() -> Self

Create a configuration with the default database path

pub fn get_effective_database_path(&self) -> Result<PathBuf>

Get the effective database path, falling back to default if needed

Errors

Returns ThingsError::Message if neither the specified path nor the default path exists

pub fn get_default_database_path() -> PathBuf

Get the default Things 3 database path.

Delegates to crate::database::get_default_database_path, which auto-discovers the per-install ThingsData-XXXXX suffix.

pub fn from_env() -> Self

Create configuration from environment variables

Reads the database path from THINGS_DB_PATH (preferred) or the legacy THINGS_DATABASE_PATH, and the fallback flag from THINGS_FALLBACK_TO_DEFAULT.

pub fn for_testing() -> Result<Self>

Create configuration for testing with a temporary database

Errors

Returns ThingsError::Io if the temporary file cannot be created

Trait Implementations

impl Clone for ThingsConfig

fn clone(&self) -> ThingsConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ThingsConfig

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

Formats the value using the given formatter.

impl Default for ThingsConfig

fn default() -> Self

Returns the “default value” for a type.