crabka-protocol 0.1.2

Apache Kafka wire-protocol codec (4.3.0), with typed RecordBatch and zero-copy borrowed decode
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
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94

// AUTO-GENERATED by crabka-protocol-codegen against a9ce3221537b8653448750697915607dc7936cf3. Do not edit.

use bytes::{Buf, BufMut};

use crate::primitives::fixed::{get_i16, get_i32, put_i16, put_i32};
use crate::primitives::string_bytes::{
    compact_nullable_string_len, compact_string_len, get_compact_nullable_string_owned,
    get_compact_string_owned, get_nullable_string_owned, get_string_owned, nullable_string_len,
    put_compact_nullable_string, put_compact_string, put_nullable_string, put_string,
    string_len,
};
use crate::tagged_fields::{read_tagged_fields, tagged_fields_len, WriteTaggedFields};
use crate::{Decode, Encode, ProtocolError, UnknownTaggedFields};
pub const MIN_VERSION: i16 = 1;
pub const MAX_VERSION: i16 = 2;
pub const FLEXIBLE_MIN: i16 = 2;

#[inline]
fn is_flexible(version: i16) -> bool { version >= FLEXIBLE_MIN }

#[derive(Debug, Clone, PartialEq, Eq, Default)]
pub struct RequestHeader {
    pub request_api_key: i16,
    pub request_api_version: i16,
    pub correlation_id: i32,
    pub client_id: Option<String>,
    pub unknown_tagged_fields: UnknownTaggedFields,
}

impl Encode for RequestHeader {
    fn encode<B: BufMut>(&self, buf: &mut B, version: i16) -> Result<(), ProtocolError> {
        if !(MIN_VERSION..=MAX_VERSION).contains(&version) {
            return Err(ProtocolError::SchemaMismatch("RequestHeader version out of range"));
        }
        let flex = is_flexible(version);
        if version >= 0 { put_i16(buf, self.request_api_key) }
        if version >= 0 { put_i16(buf, self.request_api_version) }
        if version >= 0 { put_i32(buf, self.correlation_id) }
        if version >= 1 { { let flex = false; if flex { put_compact_nullable_string(buf, self.client_id.as_deref()) } else { put_nullable_string(buf, self.client_id.as_deref()) } } }
        if flex {
            let tagged = WriteTaggedFields::new();
            tagged.write(buf, &self.unknown_tagged_fields);
        }
        Ok(())
    }
    fn encoded_len(&self, version: i16) -> usize {
        let flex = is_flexible(version);
        let mut n: usize = 0;
        if version >= 0 { n += 2; }
        if version >= 0 { n += 2; }
        if version >= 0 { n += 4; }
        if version >= 1 { n += { let flex = false; if flex { compact_nullable_string_len(self.client_id.as_deref()) } else { nullable_string_len(self.client_id.as_deref()) } }; }
        if flex {
            let known_pairs: Vec<(u32, usize)> = Vec::new();
            n += tagged_fields_len(&known_pairs, &self.unknown_tagged_fields);
        }
        n
    }
}

impl<'de> Decode<'de> for RequestHeader {
    fn decode<B: Buf>(buf: &mut B, version: i16) -> Result<Self, ProtocolError> {
        if !(MIN_VERSION..=MAX_VERSION).contains(&version) {
            return Err(ProtocolError::SchemaMismatch("RequestHeader version out of range"));
        }
        let flex = is_flexible(version);
        let mut out = Self::default();
        if version >= 0 { out.request_api_key = get_i16(buf)?; }
        if version >= 0 { out.request_api_version = get_i16(buf)?; }
        if version >= 0 { out.correlation_id = get_i32(buf)?; }
        if version >= 1 { out.client_id = { let flex = false; if flex { get_compact_nullable_string_owned(buf)? } else { get_nullable_string_owned(buf)? } }; }
        if flex {
            out.unknown_tagged_fields = read_tagged_fields(buf, |_tag, _payload| {
                Ok(false)
            })?;
        }
        Ok(out)
    }
}

/// Default JSON payload matching `Self::default()` for JVM oracle differential testing.
/// Only includes fields valid for the given version.
#[must_use]
#[allow(unused_comparisons)]
pub fn default_json(version: i16) -> ::serde_json::Value {
    let mut obj = ::serde_json::Map::new();
    obj.insert("requestApiKey".to_string(), ::serde_json::json!(0));
    obj.insert("requestApiVersion".to_string(), ::serde_json::json!(0));
    obj.insert("correlationId".to_string(), ::serde_json::json!(0));
    if version >= 1 {
        obj.insert("clientId".to_string(), ::serde_json::Value::Null);
    }
    ::serde_json::Value::Object(obj)
}