use-units 0.1.0

Cross-domain unit primitives for RustUse.
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

# use-units

Foundational unit descriptors and linear conversion helpers.

`use-units` provides a compact `UnitSpec` type for describing compatible units and applying simple
linear conversions. It is intended to act as the shared vocabulary layer for future RustUse
chemistry, physics, wave, time, finance, and measurement crates.

## What this crate provides

| Item                | Purpose                                               |
| ------------------- | ----------------------------------------------------- |
| `UnitDomain`        | Domain tags for cross-workspace unit families         |
| `SUPPORTED_DOMAINS` | Stable list of the current RustUse unit domains       |
| `UnitSpec`          | Small copyable unit descriptor with a scale to a base |
| `convert_value()`   | Compatibility-checked linear conversion helper        |

## Installation

```toml
[dependencies]
use-units = "0.1.0"
```

## Example

```rust
use use_units::{UnitDomain, UnitSpec};

let second = UnitSpec::new(UnitDomain::Time, "duration", "s", 1.0);
let minute = UnitSpec::new(UnitDomain::Time, "duration", "min", 60.0);

assert_eq!(minute.convert_value(2.0, second), Some(120.0));
assert!(minute.is_compatible_with(second));
```

## Scope

- Small, auditable metadata types.
- Linear scaling only.
- No global registry or domain-specific catalogs yet.