serde-saphyr 1.0.1

YAML (de)serializer for Serde, emphasizing panic-free parsing, fast builds and good error reporting. Supports properties, comments, include
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
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145

#![cfg(all(feature = "serialize", feature = "deserialize"))]
#[test]
fn serialize_small_float_scientific_notation() {
    let value = 0.000_004_f64;
    let yaml = serde_saphyr::to_string(&value).unwrap();
    assert_eq!(yaml.trim(), "4.0e-6");

    let value = 4.512_345_6e-18_f64;
    let yaml = serde_saphyr::to_string(&value).unwrap();
    assert_eq!(yaml.trim(), "4.5123456e-18");
}

#[test]
fn serialize_large_float_scientific_notation() {
    let value = 40_000_000_000_000_000_000.0_f64;
    let yaml = serde_saphyr::to_string(&value).unwrap();
    assert_eq!(yaml.trim(), "4.0e+19");
}

#[test]
fn serialize_positive_exponent_requires_plus_sign() {
    // YAML 1.1 requires an explicit sign in the exponent.
    let value = 3.12e18_f64;
    let yaml = serde_saphyr::to_string(&value).unwrap();
    assert_eq!(yaml.trim(), "3.12e+18");
}

#[test]
fn roundtrip_floats() {
    for original in [4.0e-6, 3.12e18, 17.4] {
        let yaml = serde_saphyr::to_string(&original).unwrap();
        let parsed: f64 = serde_saphyr::from_str(&yaml).unwrap();
        assert_eq!(original, parsed);
    }
}

use regex::Regex;

/// Validate that a plain scalar is recognized as `!!float` by:
/// - YAML 1.1 float tag regexp (base-10)
/// - YAML 1.2.2 JSON schema float tag resolution regexp
/// - YAML 1.2.2 Core schema float tag resolution regexp
///
/// Spec sources:
/// - YAML 1.1 float tag repository: <https://yaml.org/type/float.html>
/// - YAML 1.2.2 JSON/Core schema tag resolution: <https://yaml.org/spec/1.2.2/>
#[track_caller]
fn assert_yaml11_and_yaml12_float_scalar(s: &str) {
    // YAML 1.1 `!!float` (base 10) regexp (as published in the YAML 1.1 type repo).
    // NOTE: The published regexp has a known issue allowing extra '.' characters,
    // but it's still sufficient for validating our canonical-ish outputs.
    let yaml11_base10 =
        Regex::new(r"^[-+]?([0-9][0-9_]*)?\.[0-9.]*([eE][-+][0-9]+)?$").expect("valid regex");

    // YAML 1.2.2 JSON schema float tag resolution regexp:
    // `-? ( 0 | [1-9] [0-9]* ) ( \. [0-9]* )? ( [eE] [-+]? [0-9]+ )?`
    let yaml12_json =
        Regex::new(r"^-?(?:0|[1-9][0-9]*)(?:\.[0-9]*)?(?:[eE][-+]?[0-9]+)?$").expect("valid regex");

    // YAML 1.2.2 Core schema float tag resolution regexp (number form):
    // `[-+]? ( \. [0-9]+ | [0-9]+ ( \. [0-9]* )? ) ( [eE] [-+]? [0-9]+ )?`
    let yaml12_core = Regex::new(r"^[-+]?(?:\.[0-9]+|[0-9]+(?:\.[0-9]*)?)(?:[eE][-+]?[0-9]+)?$")
        .expect("valid regex");

    assert!(
        yaml11_base10.is_match(s),
        "not YAML 1.1 base-10 float literal: {s:?}"
    );
    assert!(
        yaml12_json.is_match(s),
        "not YAML 1.2 JSON-schema float literal: {s:?}"
    );
    assert!(
        yaml12_core.is_match(s),
        "not YAML 1.2 Core-schema float literal: {s:?}"
    );
}

#[test]
fn serialize_small_float_scientific_notation_2() {
    // --------------------
    // f64 cases
    // --------------------
    let value = 0.000_004_f64;
    let yaml = serde_saphyr::to_string(&value).unwrap();
    assert_eq!(yaml.trim(), "4.0e-6");
    assert_yaml11_and_yaml12_float_scalar(yaml.trim());

    let value = -0.000_004_f64;
    let yaml = serde_saphyr::to_string(&value).unwrap();
    assert_eq!(yaml.trim(), "-4.0e-6");
    assert_yaml11_and_yaml12_float_scalar(yaml.trim());

    let value = 4.512_345_6e-18_f64;
    let yaml = serde_saphyr::to_string(&value).unwrap();
    assert_eq!(yaml.trim(), "4.5123456e-18");
    assert_yaml11_and_yaml12_float_scalar(yaml.trim());

    let value = -4.512_345_6e-18_f64;
    let yaml = serde_saphyr::to_string(&value).unwrap();
    assert_eq!(yaml.trim(), "-4.5123456e-18");
    assert_yaml11_and_yaml12_float_scalar(yaml.trim());

    // --------------------
    // f32 cases
    // --------------------
    let value = 0.000_000_004_f32;
    let yaml = serde_saphyr::to_string(&value).unwrap();
    assert_eq!(yaml.trim(), "4.0e-9");
    assert_yaml11_and_yaml12_float_scalar(yaml.trim());

    let value = -0.000_000_004_f32;
    let yaml = serde_saphyr::to_string(&value).unwrap();
    assert_eq!(yaml.trim(), "-4.0e-9");
    assert_yaml11_and_yaml12_float_scalar(yaml.trim());
}

#[test]
fn serialize_large_float_scientific_notation_2() {
    // --------------------
    // f64 cases
    // --------------------
    let value = 40_000_000_000_000_000_000.0_f64;
    let yaml = serde_saphyr::to_string(&value).unwrap();
    assert_eq!(yaml.trim(), "4.0e+19");
    assert_yaml11_and_yaml12_float_scalar(yaml.trim());

    let value = -40_000_000_000_000_000_000.0_f64;
    let yaml = serde_saphyr::to_string(&value).unwrap();
    assert_eq!(yaml.trim(), "-4.0e+19");
    assert_yaml11_and_yaml12_float_scalar(yaml.trim());

    // --------------------
    // f32 cases
    // --------------------
    let value = 40_000_000_000_000_000_000.0_f32;
    let yaml = serde_saphyr::to_string(&value).unwrap();
    assert_eq!(yaml.trim(), "4.0e+19");
    assert_yaml11_and_yaml12_float_scalar(yaml.trim());

    let value = -40_000_000_000_000_000_000.0_f32;
    let yaml = serde_saphyr::to_string(&value).unwrap();
    assert_eq!(yaml.trim(), "-4.0e+19");
    assert_yaml11_and_yaml12_float_scalar(yaml.trim());
}