origin-app 0.2.0

Composition root machinery for Origin applications: ApplicationBuilder, modules, service registry.
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

# origin-app

Composition root machinery for Origin applications: ApplicationBuilder, modules, service registry.

Part of [Origin](https://github.com/casoon/origin), a Rust/Tauri platform for building
desktop applications from a shared set of domain crates. See the workspace
[documentation](https://github.com/casoon/origin/tree/main/docs) for how the pieces fit
together, and [ARCHITECTURE.md](https://github.com/casoon/origin/blob/main/ARCHITECTURE.md)
for the rules this crate follows.

## Example

```rust
use origin_app::{ApplicationBuilder, ApplicationModule, ModuleRegistry};
use origin_domain::Result;

#[derive(Debug)]
struct PulseModule;

impl ApplicationModule for PulseModule {
    fn id(&self) -> &'static str {
        "pulse"
    }

    fn register(&self, registry: &mut ModuleRegistry) -> Result<()> {
        // read settings, provide services, subscribe to events
        Ok(())
    }
}

let app = ApplicationBuilder::in_memory()
    .module(PulseModule)
    .build()?;

assert_eq!(app.modules(), &["pulse"]);
```

`ApplicationBuilder::in_memory()` wires in-memory storage, a memory secret store and a
no-op notification service — the configuration the whole application is tested against
without starting a desktop session.

## Stability

Pre-1.0 (`0.2.0`). Public types, enums and field sets may still change between minor
versions; pin an exact version if that matters to you.