klauthed-core 0.6.0

Core primitives for klauthed: typed config, clock/time, request context, CQRS, domain, and validation.
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

#![deny(unsafe_code)]
#![deny(missing_docs)]
#![cfg_attr(
    not(test),
    deny(clippy::unwrap_used, clippy::expect_used, clippy::panic, clippy::indexing_slicing)
)]

//! Core primitives shared across the klauthed libraries.
//!
//! * [`config`] — typed, layered configuration (files, env, Vault) with profiles.
//! * [`time`] — an injectable [`Clock`](time::Clock) and the canonical UTC
//!   [`Timestamp`](time::Timestamp) / [`Duration`](time::Duration).
//! * [`context`] — the per-request [`RequestContext`](context::RequestContext).
//! * [`id`] — phantom-typed 128-bit [`Id`](id::Id)s.
//! * [`cqrs`] — command/query/event buses.
//! * [`domain`] — domain-event / aggregate building blocks.
//! * [`validation`] — the [`Validate`](validation::Validate) trait.
//! * [`wiring`] — the [`AppContext`](wiring::AppContext) component registry.
//! * [`error`] — re-exports the error kernel plus `ConfigError`.

// Lets the `#[derive(FromConfig)]` macro's `::klauthed_core::…` paths resolve
// when the derive is used inside this crate (e.g. its own tests).
extern crate self as klauthed_core;

pub mod config;
pub mod context;
pub mod cqrs;
pub mod domain;
pub mod error;
pub mod id;
pub mod time;
pub mod validation;
pub mod wiring;

/// Common imports for a klauthed service: `use klauthed_core::prelude::*;`.
pub mod prelude {
    pub use crate::config::{Config, ConfigBuilder, ConfigProvider, FromConfig, Profile};
    pub use crate::context::RequestContext;
    pub use crate::id::Id;
    pub use crate::time::{Clock, Duration, SystemClock, Timestamp};
    pub use crate::validation::Validate;
    pub use crate::wiring::{AppBuilder, AppContext, Starter};
}