samsa 0.1.8

Rust-native Kafka/Redpanda protocol and client implementation.
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

//! Encoding and creation for Create Topics requests.
//!
//! ### Example
//! ```rust
//! let mut sasl_handshake_request = protocol::SaslHandshakeRequest::new(
//!     correlation_id,
//!     mechanism
//! );
//! conn.send_request(&sasl_handshake_request).await?;
//! ```
//!
//! ### Protocol Def
//! ```text
//! SaslHandshake Request (Version: 1) => mechanism
//!   mechanism => STRING
//! ```
//!
//! Note that we are using version 1 of this API

use crate::{encode::ToByte, protocol::HeaderRequest};

const API_KEY_METADATA: i16 = 17;
const API_VERSION: i16 = 1;

/// The base Create Topics request object.
///
/// ### Example
/// ```rust
/// let mut sasl_handshake_request = protocol::SaslHandshakeRequest::new(
///     correlation_id,
///     client_id,
///     mechanism
/// );
/// conn.send_request(&sasl_handshake_request).await?;
/// ```
#[derive(Debug)]
pub struct SaslHandshakeRequest<'a> {
    pub header: HeaderRequest<'a>,
    /// The SASL mechanism chosen by the client.
    pub mechanism: String,
}

impl<'a> SaslHandshakeRequest<'a> {
    /// Create a new SASL Handshake Request
    pub fn new(correlation_id: i32, client_id: &'a str, mechanism: String) -> Self {
        let header = HeaderRequest::new(API_KEY_METADATA, API_VERSION, correlation_id, client_id);
        Self { header, mechanism }
    }
}

impl ToByte for SaslHandshakeRequest<'_> {
    fn encode<T: bytes::BufMut>(&self, buffer: &mut T) -> crate::error::Result<()> {
        tracing::trace!("Encoding SaslHandshakeRequest {:?}", self);
        self.header.encode(buffer)?;
        self.mechanism.encode(buffer)?;
        Ok(())
    }
}