noema 0.4.0

Noema IOC and DI framework for Rust
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
71
72
73
74
75
76
77
78
79
80
81
82

# Noema

Rust toolkit for **Dependency Injection (DI)** and **Inversion of Control (IoC)**.  
Compile-time registration, thread-safe resolution via `Arc<T>`, extensible with Mediator, Events, and more.

> **DI macro guide:** [`docs/di.md`](docs/di.md) — exact syntax, examples, and rules.

---

## Quick start (DI)

```rust
use noema::core::{Container, Injectable, Resolver};
use noema::{resolve, dependency, dependency_as};

struct Config { host: String }
impl Injectable<Container> for Config {
    fn inject(_: &Container) -> Self {
        Config { host: "localhost".into() }
    }
}

trait Greeter: Send + Sync { fn greet(&self) -> &str; }
struct Hello;
impl Greeter for Hello { fn greet(&self) -> &str { "hi" } }
impl Injectable<Container> for Hello { fn inject(_: &Container) -> Self { Hello } }

dependency!(singleton, Config);
dependency_as!(singleton, Greeter: Hello);

let cfg = resolve::<Config>();
let g = resolve::<dyn Greeter + Send + Sync>();
```

### Registration macros (quick reference)

| Macro | Purpose |
|-------|---------|
| `dependency!(lifecycle, Type)` | Concrete type; lifecycle = `singleton` or `transient` |
| `dependency_as!(lifecycle, Trait: Impl)` | Trait binding |
| `dependency_as_many!(Trait: [(lifecycle, Impl), …])` | Batch of impls; lifecycle per entry |
| `dependency_keyed_as!(K, Trait: [(key, lifecycle, Impl), …])` | Keyed batch; lifecycle per entry |

**Trait syntax in `_as` macros:** `Logger: MyImpl` (expands to `dyn Logger + Send + Sync`)  
**Resolution:** `resolve::<T>()`, `resolve::<Arc<[Arc<T>]>>()`, `resolve::<Keyed<&str, S>>()`

Full details → [`docs/di.md`](docs/di.md).

---

## Features

| Feature | Default | Description |
|---------|---------|-------------|
| `di` | ✓ | DI: macros + `resolve()` |
| `mediator` | | Mediator (Input / Handler / `send`) |
| `events` | | Typed events (JSON wire, user transports) |
| `items_collections` | | Extensible enum-like collections (`items!` / `ItemSet`) |
| `configurations` | | Typed config (`config!` / `load(source)`) |
| `full` | | All of the above |

```toml
[dependencies]
noema = { version = "0.3", features = ["di", "mediator"] }
```

Guides: [`docs/di.md`](docs/di.md), [`docs/events.md`](docs/events.md), [`docs/items.md`](docs/items.md), [`docs/config.md`](docs/config.md).

---

## Design

- **`Container`** — ZST marker; no runtime state in v1
- **Single / `_as`** — one binding per macro; duplicate → compile error
- **Many / keyed** — one batch per call; crates merge at resolve (see `noema-integration/`)
- **Concurrency** — `Arc<T>` + `LazyLock` for singletons

---

## License

MIT OR Apache-2.0