Struct FileCardStore 

pub struct FileCardStore { /* private fields */ }

File-backed implementation of CardStore.

Implementations

impl FileCardStore

pub fn new(root: PathBuf) -> Self

Construct a store rooted at an explicit path.

pub fn root(&self) -> &Path

Return the root directory this store writes under.

pub fn create(&self, input: Json) -> Result<(String, PathBuf), String>

pub fn get(&self, card_id: &str) -> Result<Option<Json>, String>

pub fn list(&self, pkg_filter: Option<&str>) -> Result<Vec<Summary>, String>

pub fn append(&self, card_id: &str, fields: Json) -> Result<Json, String>

pub fn alias_set( &self, name: &str, card_id: &str, pkg: Option<&str>, note: Option<&str>, ) -> Result<Alias, String>

pub fn alias_list(&self, pkg_filter: Option<&str>) -> Result<Vec<Alias>, String>

pub fn get_by_alias(&self, name: &str) -> Result<Option<Json>, String>

pub fn find(&self, q: FindQuery) -> Result<Vec<Summary>, String>

pub fn write_samples( &self, card_id: &str, samples: Vec<Json>, ) -> Result<PathBuf, String>

pub fn read_samples( &self, card_id: &str, q: SamplesQuery, ) -> Result<Vec<Json>, String>

pub fn lineage(&self, q: LineageQuery) -> Result<Option<LineageResult>, String>

pub fn card_sink_backfill( &self, sink: &str, dry_run: bool, ) -> Result<SinkBackfillReport, String>

Trait Implementations

impl CardStore for FileCardStore

fn write_new_card( &self, pkg: &str, card_id: &str, toml_text: &str, ) -> Result<PathBuf, String>

Write a new Card (Tier 1 TOML).

fn overwrite_card( &self, card_id: &str, toml_text: &str, ) -> Result<PathBuf, String>

Overwrite an existing Card (append flow).

fn find_card_locator(&self, card_id: &str) -> Result<Option<PathBuf>, String>

Locate a Card file by id. Returns None if not found.

fn read_card_text(&self, card_id: &str) -> Result<Option<String>, String>

Read a Card’s raw TOML text by id. Returns None if missing.

fn list_card_locators( &self, pkg_filter: Option<&str>, ) -> Result<Vec<(String, PathBuf)>, String>

List (pkg, locator) pairs for every Card file in the store.

fn read_locator_text(&self, locator: &Path) -> Result<Option<String>, String>

Read raw TOML text from a locator returned by Self::list_card_locators. Ok(None) on read failure so scans can skip corrupt files without aborting.

fn read_aliases(&self) -> Result<Vec<Alias>, String>

fn write_aliases(&self, aliases: &[Alias]) -> Result<(), String>

fn samples_exists(&self, card_id: &str) -> Result<bool, String>

Check whether a samples sidecar exists for card_id.

fn write_samples_text( &self, card_id: &str, jsonl_text: &str, ) -> Result<PathBuf, String>

Write a samples sidecar (write-once).

fn read_samples_text(&self, card_id: &str) -> Result<Option<String>, String>

Read a samples sidecar as raw JSONL text. Returns None when no sidecar exists (samples are optional).

fn import_from_dir( &self, source_dir: &Path, pkg: &str, ) -> Result<(Vec<String>, Vec<String>), String>

Import Card files from source_dir into the store under pkg. First-writer wins (existing Cards are skipped). Returns (imported, skipped) card_id lists.