thenodes 0.2.0

TheNodes is a modular, plugin-driven P2P node framework for Rust, supporting node-embedded plugins (NEP) and core-as-a-library (CAL) modes with async-first APIs.
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
71

// src/realms/realm.rs
use crate::utils::to_kebab_ascii_strict;
use serde::{Deserialize, Serialize};

#[derive(Debug, Clone, Serialize, Deserialize, PartialEq, Eq)]
pub struct RealmInfo {
    pub name: String,
    /// Canonical machine-safe code (kebab-case). If None, derive from name.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub code: Option<String>,
    pub version: String,
}

impl RealmInfo {
    #[allow(clippy::should_implement_trait)]
    pub fn default() -> Self {
        Self {
            name: "default".to_string(),
            code: Some("default".to_string()),
            version: "1.0".to_string(),
        }
    }

    /// Constructor deriving code from name.
    pub fn new(name: impl Into<String>, version: impl Into<String>) -> Self {
        let name_str = name.into();
        let code = Some(to_kebab_ascii_strict(&name_str));
        Self {
            name: name_str,
            code,
            version: version.into(),
        }
    }

    /// Constructor with explicit code.
    pub fn new_with_code(
        name: impl Into<String>,
        code: impl Into<String>,
        version: impl Into<String>,
    ) -> Self {
        Self {
            name: name.into(),
            code: Some(code.into()),
            version: version.into(),
        }
    }

    /// Return the canonical code string (kebab). If code is None, derive from name.
    pub fn canonical_code(&self) -> String {
        self.code
            .clone()
            .unwrap_or_else(|| to_kebab_ascii_strict(&self.name))
    }

    pub fn matches(&self, other: &RealmInfo) -> bool {
        self.canonical_code() == other.canonical_code() && self.version == other.version
    }
}

// Provide std::default::Default so templates that call unwrap_or_default() compile.
impl Default for RealmInfo {
    fn default() -> Self {
        Self {
            name: "default".to_string(),
            code: Some("default".to_string()),
            version: "1.0".to_string(),
        }
    }
}

// kebab canonicalization moved to utils::naming::to_kebab_ascii_strict