dodot-lib 5.0.0

Core library for dodot dotfiles manager
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35

//! External-resource fetching.
//!
//! A pack opts into externally-sourced content by placing an
//! `externals.toml` at its root. Each `[entry]` block declares a single
//! resource (a remote file today, a git repo in a later PR) and the
//! target path under `$HOME` where it should appear.
//!
//! ```toml
//! [shared-aliases]
//! type = "file"
//! url = "https://example.com/aliases.sh"
//! target = "~/.config/shared/aliases.sh"
//! sha256 = "abc123..."
//! ```
//!
//! This module owns the spec types ([`ExternalsToml`], [`FetchSpec`])
//! and the [`HttpFetcher`] abstraction. The handler in
//! `crate::handlers::externals` consumes specs to produce intents; the
//! executor consumes intents and calls a `HttpFetcher` to do the
//! actual network work.

mod archive;
mod drift;
mod fetch;
mod git;
mod spec;

pub use archive::{read_all, read_member, ArchiveEntry, ArchiveError};
pub use drift::{detect_drift_for_pack, DriftKind, DriftReport};
pub use fetch::{HttpFetchError, HttpFetcher, UreqFetcher};
pub use git::{GitError, GitRunner, ShellGitRunner};
pub use spec::{parse_externals_toml, ArchiveFormat, ExternalEntry, ExternalsToml, FetchSpec};

#[cfg(any(test, feature = "test-utils"))]
pub use git::MockGitRunner;