rskit-bootstrap 0.2.0-alpha.2

Application lifecycle orchestration: typestate App, Component registry, hooks
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

# rskit-bootstrap — Service Lifecycle

Typestate `App<S,C>` builder, `Component` trait, ordered `Registry`, and `Health` reporting.

[![CI](https://github.com/kbukum/rskit/actions/workflows/ci.yml/badge.svg)](https://github.com/kbukum/rskit/actions/workflows/ci.yml) [![crates.io](https://img.shields.io/crates/v/rskit-bootstrap.svg)](https://crates.io/crates/rskit-bootstrap) [![docs.rs](https://docs.rs/rskit-bootstrap/badge.svg)](https://docs.rs/rskit-bootstrap) [![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/kbukum/rskit/blob/main/LICENSE) [![MSRV: 1.91](https://img.shields.io/badge/MSRV-1.91-orange.svg)](https://github.com/kbukum/rskit/blob/main/core/Cargo.toml)

## Features

- Compile-time lifecycle ordering via typestate pattern
- Reverse-order graceful shutdown
- Cancellation via `tokio_util::sync::CancellationToken`
- `HealthStatus` with three states: `Healthy`, `Degraded`, `Unhealthy`
- `Component` trait for pluggable lifecycle-managed services

## Usage

```toml
[dependencies]
rskit-bootstrap = "0.2.0-alpha.2"
```

```rust
use rskit_bootstrap::{AppBuilder, Component, Health};

AppBuilder::new(my_config)
    .build()?
    .before_start(|_cancel| async move {
        tracing::info!("starting");
        Ok(())
    })
    .run()
    .await?;
```

## See Also

[Main repository README](https://github.com/kbukum/rskit)