caeryn 0.1.0

Small protected runtime core with isolated execution contexts
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

# caeryn

Small protected runtime core with isolated execution contexts.

## Purpose

`caeryn` (from Welsh *caer*, a fortified enclosure) provides a minimal
runtime for managing isolated execution contexts. Each context has its own
state, counters, output, and guard status — like rooms in a fortress.

## Features

- **Isolated contexts** — each context has independent state and counters
- **Task queue** — submit tasks and run them in batch
- **Guard system** — pause or stop individual contexts
- **Event log** — track spawns and lifecycle events
- **Zero dependencies**

## Install

```bash
cargo add caeryn
```

## Usage

```rust
use caeryn::{Runtime, Task};

let mut rt = Runtime::new();
let ctx = rt.spawn("worker");

rt.submit(ctx, Task::SetState("role".into(), "builder".into())).unwrap();
rt.submit(ctx, Task::Increment("tasks_done".into())).unwrap();
rt.submit(ctx, Task::Echo("job finished".into())).unwrap();
rt.run_all();

let c = rt.context(ctx).unwrap();
assert_eq!(c.state("role"), Some("builder"));
assert_eq!(c.counter("tasks_done"), 1);
```

## License

MIT OR Apache-2.0