made-core 0.7.4

Domain core of MADE: entities, value objects, events, ports. No IO.
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

//! [`CouncilRegistryPort`] — registry of councils keyed by specialty.

use async_trait::async_trait;

use crate::entities::Council;
use crate::error::DomainError;
use crate::value_objects::{AuthorizationEvidence, Specialty};

#[async_trait]
pub trait CouncilRegistryPort: Send + Sync {
    /// Store a freshly created council. Fails if a council for the
    /// same specialty already exists.
    async fn register(&self, council: Council) -> Result<(), DomainError>;
    async fn register_authorized(
        &self,
        council: Council,
        authorization: Option<AuthorizationEvidence>,
    ) -> Result<(), DomainError> {
        reject_unsupported(authorization.as_ref())?;
        self.register(council).await
    }

    /// Replace an existing council for a specialty. Fails if no
    /// council exists for the specialty.
    async fn replace(&self, council: Council) -> Result<(), DomainError>;
    async fn replace_authorized(
        &self,
        council: Council,
        authorization: Option<AuthorizationEvidence>,
    ) -> Result<(), DomainError> {
        reject_unsupported(authorization.as_ref())?;
        self.replace(council).await
    }

    /// Fetch the council for a specialty. Returns
    /// [`DomainError::NotFound`] when absent.
    async fn get(&self, specialty: &Specialty) -> Result<Council, DomainError>;

    /// Enumerate every registered council.
    async fn list(&self) -> Result<Vec<Council>, DomainError>;

    /// Remove the council for a specialty. Returns
    /// [`DomainError::NotFound`] when absent.
    async fn delete(&self, specialty: &Specialty) -> Result<(), DomainError>;
    async fn delete_authorized(
        &self,
        specialty: &Specialty,
        authorization: Option<AuthorizationEvidence>,
    ) -> Result<(), DomainError> {
        reject_unsupported(authorization.as_ref())?;
        self.delete(specialty).await
    }

    /// Cheap existence check.
    async fn contains(&self, specialty: &Specialty) -> Result<bool, DomainError>;
}

fn reject_unsupported(authorization: Option<&AuthorizationEvidence>) -> Result<(), DomainError> {
    if authorization.is_some() {
        return Err(DomainError::InvariantViolated {
            reason: "council registry adapter cannot persist authorization evidence",
        });
    }
    Ok(())
}