gproxy-protocol 4.0.0

GPROXY v4 connection modelling, operation declarations, vendor wire types and pairwise conversion
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

//! Direct vendor-wire conversions and the identity rules they share.
//!
//! A conversion only reads declared source fields and builds declared target
//! fields. Unknown `rest` members are neither conversion input nor output.
//! Conversion state and diagnostics are separate from vendor wire payloads.

pub mod compact;
pub mod count_tokens;
pub mod embeddings;
mod error;
pub mod files;
pub mod generate;
pub mod guardian;
pub mod identity;
pub mod images;
mod instructions;
pub mod memory;
pub mod models;
pub mod video;
pub mod web_search;

pub use error::{Diagnostic, DiagnosticKind, Report, TransformError, TransformErrorKind};

/// An unrepresentable field or item is omitted at its mapping boundary.
/// Parsing, host and state errors still propagate to the caller.
pub(crate) fn optional<T>(value: Result<T, TransformError>) -> Result<Option<T>, TransformError> {
    match value {
        Ok(value) => Ok(Some(value)),
        Err(error)
            if matches!(
                error.kind(),
                TransformErrorKind::Unsupported | TransformErrorKind::MissingMetadata
            ) =>
        {
            Ok(None)
        }
        Err(error) => Err(error),
    }
}

/// A typed target value and out-of-band field diagnostics. This wrapper never
/// changes or normalizes the payload type into a common content model.
#[derive(Debug, Clone, PartialEq, Eq)]
pub struct Converted<T> {
    pub value: T,
    pub report: Report,
}