qubit-value 0.12.2

Type-safe containers for single, multi-valued, and named runtime values
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

// =============================================================================
//    Copyright (c) 2025 - 2026 Haixing Hu.
//
//    SPDX-License-Identifier: Apache-2.0
//
//    Licensed under the Apache License, Version 2.0.
// =============================================================================

//! Owned wire representation for one named collection.

use serde::Deserialize;
use serde::Deserializer;
use serde::de::DeserializeSeed;

use crate::ValueWireV1;
use crate::ValueWireV1Seed;

/// Decodes the nested V1 envelope with its explicit validation seed.
///
/// # Type Parameters
///
/// * `D` - Serde deserializer supplied by the enclosing named-values visitor.
///
/// # Parameters
///
/// * `deserializer` - Source positioned at the nested V1 envelope.
///
/// # Returns
///
/// A validated V1 wire value whose resource accounting is inherited from the
/// enclosing deserializer.
///
/// # Errors
///
/// Returns `D::Error` when the nested V1 envelope is malformed or unsupported.
#[inline(always)]
fn deserialize_value_wire<'de, D>(deserializer: D) -> Result<ValueWireV1, D::Error>
where
    D: Deserializer<'de>,
{
    ValueWireV1Seed::new().deserialize(deserializer)
}

/// Owned wire representation of a named collection.
#[derive(Deserialize)]
#[serde(deny_unknown_fields)]
pub(in crate::named_multi_values) struct NamedMultiValuesWireOwned {
    /// Name associated with the collection.
    pub(in crate::named_multi_values) name: String,
    /// Independently versioned collection.
    #[serde(deserialize_with = "deserialize_value_wire")]
    pub(in crate::named_multi_values) value: ValueWireV1,
}