runar_common 0.1.0

Common traits and utilities for the Runar framework
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

Runar Common
============

Common traits and utilities shared across the Runar stack.

What’s inside
-------------

- Structured logging with component and node-id context
- Lightweight error utilities (re-exports of `anyhow` and `thiserror`)
- DNS-safe compact ID generator

Install
-------

Add to your `Cargo.toml`:

```toml
[dependencies]
runar_common = "0.1"
```

Logging
-------

```rust
use runar_common::logging::{Component, Logger};

let root = Logger::new_root(Component::Node, "node-123");
let svc = root.with_component(Component::Service);
svc.info("service started");
svc.warn("doing work");
svc.error("something went wrong");
```

Compact IDs
-----------

```rust
use runar_common::compact_ids::compact_id;

let public_key_bytes: [u8; 65] = [0u8; 65];
let id = compact_id(&public_key_bytes);
assert_eq!(id.len(), 26);
assert!(id.chars().all(|c| c.is_ascii_lowercase() || c.is_ascii_digit()));
```

Errors
------

```rust
use runar_common::errors::{Result, anyhow};

fn do_work() -> Result<()> {
    // ...
    Err(anyhow!("failure"))
}
```

License
-------

MIT. See `LICENSE`.