ryra-core 0.7.4

Core library for ryra: config, registry, and service generation logic
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
66
67
68
69
70

//! Infrastructure services ryra knows about for cross-service integration
//! (joining networks, configuring OIDC, setting up TLS).
//!
//! Using an enum instead of string constants makes comparisons type-safe
//! and ensures the compiler catches typos or missing match arms.
//!
//! Capability data is no longer here — every provider declares
//! `[capabilities] provides = [...]` in its own `service.toml`, and
//! installed services carry the persisted snapshot on
//! [`crate::config::schema::InstalledService::provides`]. This enum
//! survives only as a typed handle to the default-registry providers' *names*,
//! used by code paths that emit network names (`<svc>.network`),
//! seed provider-specific config files (caddy's `tls.caddy`), or read
//! their on-disk artifacts (authelia's `.env`).

use crate::config::schema::Config;

/// Default Caddy HTTPS port, used when the caddy service record has no
/// "https" port entry (e.g., config was written by an older version).
const DEFAULT_CADDY_HTTPS_PORT: u16 = 8443;

#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub enum WellKnownService {
    Caddy,
    Authelia,
    Inbucket,
}

impl WellKnownService {
    pub fn as_str(self) -> &'static str {
        match self {
            Self::Caddy => "caddy",
            Self::Authelia => "authelia",
            Self::Inbucket => "inbucket",
        }
    }

    /// Try to match a service name to a well-known service.
    pub fn from_name(name: &str) -> Option<Self> {
        match name {
            "caddy" => Some(Self::Caddy),
            "authelia" => Some(Self::Authelia),
            "inbucket" => Some(Self::Inbucket),
            _ => None,
        }
    }

    /// Check if a string matches this well-known service name.
    pub fn matches(&self, name: &str) -> bool {
        self.as_str() == name
    }
}

impl std::fmt::Display for WellKnownService {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        f.write_str(self.as_str())
    }
}

/// Look up Caddy's HTTPS port. Reads from the quadlet scan (which
/// reconstructs ports from the service's `.env` file), falling back
/// to the default when caddy isn't installed yet.
pub(crate) fn caddy_https_port(_config: &Config) -> u16 {
    crate::list_installed()
        .unwrap_or_default()
        .into_iter()
        .find(|s| WellKnownService::Caddy.matches(&s.name))
        .and_then(|s| s.ports.get("https").copied())
        .unwrap_or(DEFAULT_CADDY_HTTPS_PORT)
}