Skip to main content

Crate photorg

Crate photorg 

Source
Expand description

Core library for the photo organizer.

Nothing here knows about clap, stdout, or the terminal. The binary owns argument parsing and rendering; this crate owns the work.

Re-exports§

pub use config::Options;
pub use error::FatalError;
pub use error::FileError;
pub use error::Result;
pub use error::TemplateError;

Modules§

adaptive
Adaptive granularity.
companion
Companion-file grouping.
config
Core configuration. Deliberately free of clap so the library never depends on the CLI layer.
dates
Date resolution chain.
dedup
Duplicate detection.
error
execute
Pass 2: apply an OperationPlan. This phase decides nothing — every destination and suffix was already fixed by the planner.
formats
Extension filtering and signature validation.
geocode
Offline reverse geocoding.
journal
Append-only JSONL journal. No database: one line per completed operation, flushed immediately so a kill -9 still leaves a usable file.
metadata
One-open metadata extraction: signature check, EXIF and GPS come from the same read.
plan
The plan phase: serial, deterministic, and the only place where non-determinism — collision suffixes, ordering, duplicate resolution — is allowed to be resolved. Pass 2 executes what this produced and decides nothing on its own.
safety
Pre-flight checks. Everything here runs before a single byte is written, and every failure is fatal by design.
sanitize
Path component sanitization.
scan
Pass 1: parallel walk, extension filter, and parallel metadata extraction.
spill
Spilling the plan to disk.
template
Path template parsing and rendering.