pulith-version 0.1.0

Version parsing, matching, and selection policies 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
45
46
47
48
49
50
51
52
53
54
55
56

# pulith-version

Version parsing, matching, and preference selection.

## Role

`pulith-version` is a pure primitive crate.

It owns:

- version parsing
- requirement matching
- generic preference selection

It does not own:

- resource-specific alias meaning
- repository policy
- planner-specific source policy

## Main APIs

- `VersionKind`
- `VersionRequirement`
- `VersionPreference`
- `SelectionPolicy`
- `select_preferred`

## Basic Usage

```rust
use pulith_version::{
    SelectionPolicy, VersionKind, VersionPreference, VersionRequirement, select_preferred,
};

let versions = [VersionKind::parse("1.0.0")?, VersionKind::parse("1.1.0")?];
let policy = SelectionPolicy {
    requirement: VersionRequirement::Any,
    preference: VersionPreference::HighestStable,
};
let selected = select_preferred(&versions, &policy).unwrap();
assert_eq!(selected.to_string(), "1.1.0");
# Ok::<(), pulith_version::VersionError>(())
```

## How To Use It

Use this crate when a caller already has candidate versions and needs a consistent, reusable way to:

- parse version strings
- match requirements
- prefer stable/latest/lowest/pinned variants

Let higher-level crates decide what aliases like `stable` or `lts` mean in resource-specific terms.

See `docs/design/version.md`.