rototo 0.1.0-alpha.4

Control plane for runtime configuration of your application.
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
57
58
59
60
61
62
63
64
65
66
67
68
69
70

# Rust SDK Reference

The Rust SDK is the core implementation. Other language SDKs delegate runtime
behavior to this code so that loading, lint, refresh, and resolution semantics
stay in one place.

## Install

```toml
[dependencies]
rototo = "0.1.0-alpha.3"
serde_json = "1"
tokio = { version = "1", features = ["macros", "rt-multi-thread", "time"] }
```

## Runtime Handle

```rust
use rototo::{ResolveContext, Workspace};

let workspace = Workspace::load("examples/basic").await?;
let context = ResolveContext::from_json(serde_json::json!({
    "user": {
        "tier": "premium"
    }
}))?;

let resolution = workspace
    .resolve_variable("premium-message", &context)
    .await?;
```

Use `Workspace::load` for application runtime paths. Use `Workspace::inspect`
for tools that need to load a workspace without compiling a runtime model.

## Refreshing Handle

```rust
use std::time::Duration;
use rototo::{RefreshOptions, RefreshingWorkspace};

let refresh = RefreshOptions::new().with_period(Duration::from_secs(30));
let workspace = RefreshingWorkspace::load(source, refresh).await?;
```

`RefreshingWorkspace` keeps the last successfully loaded workspace active when
a later refresh fails.

## Error Type

SDK calls return `rototo::Result<T>`, whose error type is `RototoError`.

## API Surface

The Rust crate exposes the broadest SDK surface:

| API | Purpose |
| --- | --- |
| `Workspace::load` | Load, lint, and compile a runtime workspace. |
| `Workspace::inspect` | Load workspace files without compiling runtime state. |
| `Workspace::lint` | Run lint against the loaded root. |
| `Workspace::resolve_variable` | Resolve one variable. |
| `Workspace::resolve_qualifier` | Resolve one qualifier. |
| `RefreshingWorkspace::load` | Load and optionally start periodic refresh. |
| `RefreshingWorkspace::refresh_now` | Run a manual refresh. |
| `RefreshingWorkspace::status` | Read refresh state. |
| `RefreshingWorkspace::shutdown` | Stop the refresh loop. |

The crate also exports lower-level list, read, lint, resolve, trace, source,
catalog, and testing helpers for Rust tools and test suites.