grit-lib 0.5.19

Core library for the grit Git implementation
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21

//! Internal RPC abstraction shared by duplex and smart-HTTP transports.
//!
//! One round-trip of the Git upload-pack/receive-pack protocols: send a pkt-line
//! request body, read the response stream. Duplex connections
//! ([`crate::transport::Connection`]) implement this by writing to the socket;
//! smart HTTP ([`crate::transport::stateless_http::StatelessHttpConnection`])
//! replays prior state and POSTs each round per gitprotocol-http.

use std::io::Read;

use crate::error::Result;

/// A single protocol round over upload-pack or receive-pack.
pub(crate) trait RpcChannel {
    /// Send `body` and return the server's response bytes as a stream.
    ///
    /// # Errors
    ///
    /// Returns an error on transport or HTTP failures.
    fn request(&mut self, body: &[u8]) -> Result<Box<dyn Read + Send>>;
}