qubit-json 0.9.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

// =============================================================================
//    Copyright (c) 2026 Haixing Hu.
//
//    SPDX-License-Identifier: Apache-2.0
//
//    Licensed under the Apache License, Version 2.0.
// =============================================================================
//! Defines violations of the Serde compound-serialization protocol.

/// Invalid state produced by a malformed hand-written Serde implementation.
///
/// # Examples
///
/// ```
/// use qubit_json::encode::JsonSerializationError;
/// use qubit_json::encode::JsonSerializationErrorKind;
/// use qubit_json::encode::JsonSerializerStateError;
///
/// let error = JsonSerializationError::new(JsonSerializationErrorKind::InvalidSerializerState {
///     reason: JsonSerializerStateError::MapValueWithoutKey,
/// });
/// assert_eq!(
///     error.serializer_state_error(),
///     Some(JsonSerializerStateError::MapValueWithoutKey),
/// );
/// ```
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)]
pub enum JsonSerializerStateError {
    /// A compound callback was used with the wrong compound state.
    UnexpectedCompound,
    /// A split-map key was submitted before the previous key received a value.
    MapKeyAlreadyPending,
    /// A split-map value was submitted without a preceding key.
    MapValueWithoutKey,
    /// A split map ended while one key was still waiting for its value.
    MapEndedWithPendingKey,
    /// The private serde_json RawValue protocol had an invalid shape.
    InvalidRawValueProtocol,
}