pulith-source 0.1.0

Composable source abstractions and planning 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

# pulith-source

Composable source definitions and planning.

## Role

`pulith-source` describes where resources may come from and turns that into executable candidate plans.

It should not execute fetches or manage storage/install policy.

## Main APIs

- `SourceSpec`
- `PlannedSources`
- `SelectionStrategy`
- `SourceDefinition`

## Basic Usage

```rust
use pulith_resource::{ResourceLocator, ValidUrl};
use pulith_source::{PlannedSources, SelectionStrategy};

let planned = PlannedSources::from_locator(
    &ResourceLocator::Url(ValidUrl::parse("https://example.com/runtime.zip")?),
    SelectionStrategy::OrderedFallback,
)?;
# Ok::<(), Box<dyn std::error::Error>>(())
```

## How To Use It

Use this crate when you have a semantic resource or locator and need:

- structured source definitions
- ordered fallback plans
- race-style source candidate plans

See `docs/design/source.md`.