padzapp 1.5.0

An ergonomic, context-aware scratch pad library with plain text storage
Documentation 
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
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52

use super::bucketed::BucketedStore;
use super::fs_backend::FsBackend;
use super::pad_store::PadStore;
use std::path::PathBuf;

pub type FileStore = BucketedStore<FsBackend>;

impl FileStore {
    /// Create a new bucketed file store from project/global root paths.
    ///
    /// Each bucket gets its own subdirectory:
    /// - `{root}/active/`  — active pads (data.json + pad-*.ext)
    /// - `{root}/archived/` — archived pads
    /// - `{root}/deleted/`  — deleted pads
    /// - `{root}/`          — scope-level files (tags.json, padz.toml)
    pub fn new_fs(project_root: Option<PathBuf>, global_root: PathBuf) -> Self {
        BucketedStore::new(
            FsBackend::new(
                project_root.as_ref().map(|r| r.join("active")),
                global_root.join("active"),
            ),
            FsBackend::new(
                project_root.as_ref().map(|r| r.join("archived")),
                global_root.join("archived"),
            ),
            FsBackend::new(
                project_root.as_ref().map(|r| r.join("deleted")),
                global_root.join("deleted"),
            ),
            // Tag backend at scope root (shared across buckets)
            FsBackend::new(project_root, global_root),
        )
    }

    pub fn with_format(mut self, ext: &str) -> Self {
        self.active = PadStore::with_backend(self.active.backend.with_format(ext));
        self.archived = PadStore::with_backend(self.archived.backend.with_format(ext));
        self.deleted = PadStore::with_backend(self.deleted.backend.with_format(ext));
        // tag_backend doesn't need format (no content files)
        self
    }

    pub fn set_format(&mut self, ext: &str) {
        self.active.backend.set_format(ext);
        self.archived.backend.set_format(ext);
        self.deleted.backend.set_format(ext);
    }

    pub fn format_ext(&self) -> &str {
        self.active.backend.format_ext()
    }
}