noyalib 0.0.2

A pure Rust YAML library with zero unsafe code and full serde integration
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
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107

// SPDX-License-Identifier: MIT OR Apache-2.0
// Copyright (c) 2026 Noyalib. All rights reserved.

//! Automatic YAML anchor/alias emission for shared `Rc` / `Arc` pointers.
//!
//! Demonstrates `to_string_tracking_shared`: identical `Rc::clone` /
//! `Arc::clone` siblings collapse into one anchor + N-1 aliases in the
//! emitted document, preserving DAG structure.
//!
//! Run: `cargo run --example anchor_shared`

#[path = "support.rs"]
mod support;

use noyalib::{to_string, to_string_tracking_shared, ArcAnchor, RcAnchor};
use serde::Serialize;

fn main() {
    support::header("noyalib -- anchor_shared (automatic Rc/Arc anchor emission)");

    // ── Two Rc clones collapse to one anchor + one alias ────────────
    support::task_with_output("Two Rc clones: &id001 + *id001", || {
        let a: RcAnchor<String> = RcAnchor::from("payload".to_string());
        let doc = vec![a.clone(), a];
        let yaml = to_string_tracking_shared(&doc).unwrap();
        assert_eq!(yaml.matches("&id001").count(), 1);
        assert_eq!(yaml.matches("*id001").count(), 1);
        yaml.lines().map(String::from).collect::<Vec<_>>()
    });

    // ── Three clones → 1 anchor + 2 aliases ─────────────────────────
    support::task_with_output("Three Rc clones: 1 anchor + 2 aliases", || {
        let a: RcAnchor<String> = RcAnchor::from("x".to_string());
        let doc = vec![a.clone(), a.clone(), a];
        let yaml = to_string_tracking_shared(&doc).unwrap();
        assert_eq!(yaml.matches("&id001").count(), 1);
        assert_eq!(yaml.matches("*id001").count(), 2);
        yaml.lines().map(String::from).collect::<Vec<_>>()
    });

    // ── Distinct allocations with equal value: two anchors, no alias ─
    support::task_with_output(
        "Identity, not value: distinct allocs = distinct anchors",
        || {
            let a: RcAnchor<String> = RcAnchor::from("same".to_string());
            let b: RcAnchor<String> = RcAnchor::from("same".to_string());
            let yaml = to_string_tracking_shared(&vec![a, b]).unwrap();
            assert!(yaml.contains("&id001"));
            assert!(yaml.contains("&id002"));
            assert!(!yaml.contains("*id"));
            yaml.lines().map(String::from).collect::<Vec<_>>()
        },
    );

    // ── Struct with shared mapping leaf ──────────────────────────────
    support::task_with_output("Struct field sharing a mapping inner", || {
        #[derive(Clone, Serialize)]
        struct Endpoint {
            host: String,
            port: u16,
        }
        #[derive(Serialize)]
        struct Topology {
            primary: RcAnchor<Endpoint>,
            replica: RcAnchor<Endpoint>,
        }
        let shared = RcAnchor::from(Endpoint {
            host: "db.local".to_string(),
            port: 5432,
        });
        let topo = Topology {
            primary: shared.clone(),
            replica: shared,
        };
        let yaml = to_string_tracking_shared(&topo).unwrap();
        assert_eq!(yaml.matches("&id001").count(), 1);
        assert_eq!(yaml.matches("*id001").count(), 1);
        yaml.lines().map(String::from).collect::<Vec<_>>()
    });

    // ── Arc across threads: worker serializes independently ──────────
    support::task_with_output("Arc: worker-thread tracking is independent", || {
        let a: ArcAnchor<String> = ArcAnchor::from("shared".to_string());
        let clone = a.clone();
        let y = std::thread::spawn(move || {
            let doc = vec![clone.clone(), clone];
            to_string_tracking_shared(&doc).unwrap()
        })
        .join()
        .unwrap();
        drop(a);
        assert!(y.contains("&id001"));
        assert!(y.contains("*id001"));
        y.lines().map(String::from).collect::<Vec<_>>()
    });

    // ── Opt-in: plain to_string is unchanged ─────────────────────────
    support::task_with_output("Opt-in: plain to_string emits NO anchors", || {
        let a: RcAnchor<String> = RcAnchor::from("no_anchors".to_string());
        let yaml = to_string(&vec![a.clone(), a]).unwrap();
        assert!(!yaml.contains("&id"));
        assert!(!yaml.contains("*id"));
        yaml.lines().map(String::from).collect::<Vec<_>>()
    });

    support::summary(6);
}