pulith-store 0.1.0

Composable local artifact storage for Pulith
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

# pulith-store

Composable local artifact and extracted-tree storage.

## Role

`pulith-store` owns durable local materialization and provenance-aware lookup.

It should not absorb install policy or state policy.

## Main APIs

- `StoreReady`
- `StoreRoots`
- `StoreKey`
- `StoredArtifact`
- `ExtractedArtifact`
- `StoreProvenance`

## Basic Usage

```rust
use pulith_store::{StoreKey, StoreReady, StoreRoots};
use std::path::PathBuf;

let store = StoreReady::initialize(StoreRoots::new(
    PathBuf::from("artifacts"),
    PathBuf::from("extracts"),
    PathBuf::from("metadata"),
))?;
let _artifact = store.put_artifact_bytes(&StoreKey::logical("runtime")?, b"hello")?;
# Ok::<(), Box<dyn std::error::Error>>(())
```

## How To Use It

Use `pulith-store` when you want:

- durable artifact/extract registration
- provenance persistence
- semantic lookup by `StoreKey` or derived resource identity
- prune planning instead of blind cleanup

See `docs/design/store.md`.