noyalib 0.0.4

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

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

//! Custom YAML tags: local (!), global (!!), and user-defined types.
//!
//! Run: `cargo run --example custom_tags`

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

use noyalib::{from_str, to_string, Tag, TaggedValue, Value};

fn main() {
    support::header("noyalib -- types");

    // ── Parse tagged values ──────────────────────────────────────────
    support::task_with_output("Parse tagged values", || {
        // Tags are resolved during parsing. Local tags (!) on scalars are
        // consumed by the schema resolver. To demonstrate tag handling,
        // construct tagged values programmatically.
        let tagged = Value::Tagged(Box::new(TaggedValue::new(
            Tag::new("!timestamp"),
            Value::String("2024-01-15T10:30:00Z".to_string()),
        )));
        match &tagged {
            Value::Tagged(t) => vec![
                format!("tag   = {}", t.tag()),
                format!("value = {}", t.value()),
            ],
            _ => vec!["unexpected".to_string()],
        }
    });

    // ── Construct tagged values programmatically ─────────────────────
    support::task_with_output("Construct tagged values", || {
        let tagged = Value::Tagged(Box::new(TaggedValue::new(
            Tag::new("!color"),
            Value::String("#FF5733".to_string()),
        )));
        let yaml = to_string(&tagged).unwrap();
        vec![format!("output: {}", yaml.trim())]
    });

    // ── Tag inspection and stripping ─────────────────────────────────
    support::task_with_output("Inspect and strip tags", || {
        let tagged = Value::Tagged(Box::new(TaggedValue::new(
            Tag::new("!secret"),
            Value::String("encrypted-data-here".to_string()),
        )));

        let mut lines = Vec::new();
        if let Value::Tagged(t) = &tagged {
            lines.push(format!("tag()    = {}", t.tag()));
            lines.push(format!("nobang() = {}", noyalib::nobang(t.tag().as_str())));
            lines.push(format!("value()  = {}", t.value()));
        }
        let stripped = tagged.untag();
        lines.push(format!("untag()  = {stripped}"));
        lines
    });

    // ── Global tags (!!type) ─────────────────────────────────────────
    support::task_with_output("Global tags (!!int, !!str)", || {
        let yaml = "typed_int: !!int 42\ntyped_str: !!str 42\n";
        let v: Value = from_str(yaml).unwrap();
        vec![
            format!(
                "!!int 42 -> {}",
                match &v["typed_int"] {
                    Value::Number(_) => "Number",
                    Value::Tagged(_) => "Tagged",
                    _ => "Other",
                }
            ),
            format!(
                "!!str 42 -> {}",
                match &v["typed_str"] {
                    Value::String(_) => "String",
                    Value::Tagged(_) => "Tagged",
                    _ => "Other",
                }
            ),
        ]
    });

    // ── Tag-based dispatch pattern ───────────────────────────────────
    support::task_with_output("Tag-based dispatch pattern", || {
        // Build tagged items programmatically to demonstrate dispatch
        let items = [
            ("!email", "user@example.com", "validate_email"),
            ("!url", "https://example.com", "validate_url"),
            ("!phone", "+1-555-0100", "validate_phone"),
        ];
        items
            .iter()
            .map(|(tag, val, handler)| format!("{tag} {val} -> {handler}()"))
            .collect()
    });

    support::summary(5);
}