grpc-core 0.0.1

Core HTTP/2, Linux io_uring transport, compression, and service abstractions for grpc-rs
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

//! Static RPC routing and cardinality descriptions.

/// Message multiplicity in each direction of an RPC.
#[derive(Clone, Copy, Debug, Eq, Hash, PartialEq)]
pub enum RpcCardinality {
    /// One request and one response.
    Unary,
    /// One request and a stream of responses.
    ServerStreaming,
    /// A stream of requests and one response.
    ClientStreaming,
    /// Independent request and response streams.
    BidiStreaming,
}

/// Static routing information emitted by service definitions.
///
/// `path` is the canonical, case-sensitive HTTP/2 path in the form
/// `/package.Service/Method`. The service definition owns its validity.
#[derive(Clone, Copy, Debug, Eq, Hash, PartialEq)]
pub struct MethodDescriptor {
    /// Canonical HTTP/2 request path.
    pub path: &'static str,
    /// Request and response message multiplicity.
    pub cardinality: RpcCardinality,
}

impl MethodDescriptor {
    /// Describes a method using its canonical path and message multiplicity.
    #[must_use]
    pub const fn new(path: &'static str, cardinality: RpcCardinality) -> Self {
        Self { path, cardinality }
    }
}