qubit-budget 0.3.0

Dependency-light resource limit and budget accounting primitives for Qubit Rust crates
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

// =============================================================================
//    Copyright (c) 2026 Haixing Hu.
//
//    SPDX-License-Identifier: Apache-2.0
//
//    Licensed under the Apache License, Version 2.0.
// =============================================================================
use qubit_budget::json::JsonEncodeLimits;
use qubit_budget::json::JsonResource;
use qubit_budget::json::JsonValueLimits;

/// Verifies that JSON encode limits use machine-sized quantities by default.
#[test]
fn test_default_uses_usize_quantity() {
    let _: JsonEncodeLimits = JsonEncodeLimits::default();
}

/// Verifies that encode builders configure output and nested value limits.
#[test]
fn test_standard_builder_configures_encode_dimensions() {
    let limits = JsonEncodeLimits::<JsonResource, usize>::builder()
        .max_output_bytes(1)
        .max_depth(2)
        .max_nodes(3)
        .max_sequence_items(4)
        .max_map_entries(5)
        .max_key_bytes(6)
        .max_string_bytes(7)
        .max_number_bytes(8)
        .max_payload_bytes(9)
        .build();

    assert_eq!(limits.max_output_bytes(), Some(1));
    assert_eq!(limits.value_limits().max_depth(), Some(2));
    assert_eq!(limits.value_limits().max_nodes(), Some(3));
    assert_eq!(limits.value_limits().max_sequence_items(), Some(4));
    assert_eq!(limits.value_limits().max_map_entries(), Some(5));
    assert_eq!(limits.value_limits().max_key_bytes(), Some(6));
    assert_eq!(limits.value_limits().max_string_bytes(), Some(7));
    assert_eq!(limits.value_limits().max_number_bytes(), Some(8));
    assert_eq!(limits.value_limits().max_payload_bytes(), Some(9));
}

/// Verifies that nested value limits may be borrowed or explicitly consumed.
#[test]
fn test_value_limits_expresses_borrowing_and_ownership() {
    let limits = JsonEncodeLimits::<JsonResource, usize>::builder().max_depth(2).build();
    let _: &JsonValueLimits = limits.value_limits();
    assert_eq!(limits.value_limits().max_depth(), Some(2));
    assert_eq!(limits.into_value_limits().max_depth(), Some(2));
}

#[test]
fn test_empty_encode_limits_report_unconfigured_maximum() {
    assert_eq!(
        JsonEncodeLimits::<JsonResource, usize>::builder()
            .build()
            .max_output_bytes(),
        None
    );
}

#[test]
fn test_generic_encode_limits_expose_maximum() {
    let limits = JsonEncodeLimits::<JsonResource, u8>::builder()
        .max_output_bytes(4)
        .max_depth(5)
        .max_nodes(6)
        .max_sequence_items(7)
        .max_map_entries(8)
        .max_key_bytes(9)
        .max_string_bytes(10)
        .max_number_bytes(11)
        .max_payload_bytes(12)
        .build();
    assert_eq!(limits.max_output_bytes(), Some(4));
    assert_eq!(limits.value_limits().max_payload_bytes(), Some(12));
}