qubit-json 0.8.0

Resource-aware infrastructure for lenient and strict JSON processing
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

// =============================================================================
//    Copyright (c) 2025 - 2026 Haixing Hu.
//
//    SPDX-License-Identifier: Apache-2.0
//
//    Licensed under the Apache License, Version 2.0.
// =============================================================================
//! Tests for the public `JsonRootKind` type.

use std::str::FromStr;

use qubit_json::decode::JsonRootKind;
use serde_json::json;

/// Verifies that top level kind classifies values.
///
/// # Panics
///
/// Panics when the expected behavior is not observed.
#[test]
fn test_top_level_kind_classifies_values() {
    assert_eq!(JsonRootKind::of(&json!({})), JsonRootKind::Object);
    assert_eq!(JsonRootKind::of(&json!([])), JsonRootKind::Array);
    assert_eq!(JsonRootKind::of(&json!(true)), JsonRootKind::Other);
}

/// Verifies that top level kind from matches of.
///
/// # Panics
///
/// Panics when the expected behavior is not observed.
#[test]
fn test_top_level_kind_from_matches_of() {
    let value = json!([1, 2, 3]);
    assert_eq!(JsonRootKind::from(&value), JsonRootKind::of(&value));
}

/// Verifies that top level kind display uses lowercase names.
///
/// # Panics
///
/// Panics when the expected behavior is not observed.
#[test]
fn test_top_level_kind_display_uses_lowercase_names() {
    assert_eq!(JsonRootKind::Object.to_string(), "object");
    assert_eq!(JsonRootKind::Array.to_string(), "array");
    assert_eq!(JsonRootKind::Other.to_string(), "other");
}

/// Verifies that top level kind from str.
///
/// # Panics
///
/// Panics when the expected behavior is not observed.
#[test]
fn test_top_level_kind_from_str() {
    assert_eq!(
        JsonRootKind::from_str("object").expect("object must parse"),
        JsonRootKind::Object
    );
    assert_eq!(
        JsonRootKind::from_str("ARRAY").expect("ARRAY must parse without case sensitivity"),
        JsonRootKind::Array
    );
    assert_eq!(
        JsonRootKind::from_str("other").expect("other must parse"),
        JsonRootKind::Other
    );
    assert_eq!(JsonRootKind::from_str("dict"), Err("unknown JsonRootKind"),);
}