supply-demand 0.0.2

Supply-Demand - A functional dependency injection library
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

# supply-demand

A flexible, async-ready dependency injection and supply/demand orchestration library for Rust.
Inspired by IoC/DI patterns, supports runtime-typed supplier registries and dynamic dependency graphs.

[![crates.io](https://img.shields.io/crates/v/supply-demand.svg)](https://crates.io/crates/supply-demand)
[![Documentation](https://docs.rs/supply-demand/badge.svg)](https://docs.rs/supply-demand/)
[![GitHub](https://img.shields.io/badge/github-ceil--rust%2Fsupply--demand-blue?logo=github)](https://github.com/ceil-rust/supply-demand)

## Features

- Register arbitrary async/sync suppliers by type key
- Type-erased registry for heterogeneous dependencies
- Local override and dynamic graph composition
- `async_trait` support for ergonomic async/await suppliers

## Example

```rust
use supply_demand::{Supplier, Demand, Scope, SupplierRegistry};
use async_trait::async_trait;
use std::collections::HashMap;
use std::sync::Arc;

// A supplier returning i32
struct ValueASupplier;

#[async_trait]
impl Supplier for ValueASupplier {
    type Input = ();
    type Output = i32;

    async fn supply(&self, _input: (), _scope: Arc<Scope>) -> i32 {
        42
    }
}

#[tokio::main]
async fn main() {
    let mut registry: SupplierRegistry = HashMap::new();
    registry.insert("valueA".to_string(), Arc::new(ValueASupplier));

    let scope = Arc::new(Scope {
        registry: Arc::new(registry),
    });

    let demand = Demand { type_: "valueA".to_string(), override_suppliers: None };
    let result: i32 = scope.demand(demand, Box::new(())).await;

    println!("Result is {}", result); // prints "Result is 42"
}
```

## Documentation

See full documentation at [docs.rs/supply-demand](https://docs.rs/supply-demand).

## License

Licensed under [MIT license](LICENSE-MIT).