Enum aquatic_http_protocol::request::Request

pub enum Request {
    Announce(AnnounceRequest),
    Scrape(ScrapeRequest),
}

Variants

Announce(AnnounceRequest)

Scrape(ScrapeRequest)

Implementations

impl Request

pub fn from_bytes(bytes: &[u8]) -> Result<Self, RequestParseError>

Parse Request from HTTP request bytes

pub fn from_http_get_path(path: &str) -> Result<Self>

Parse Request from http path (GET /announce?info_hash=...)

Existing serde-url decode crates were insufficient, so the decision was made to create a custom parser. serde_urlencoded doesn't support multiple values with same key, and serde_qs pulls in lots of dependencies. Both would need preprocessing for the binary format used for info_hash and peer_id.

The info hashes and peer id's that are received are url-encoded byte by byte, e.g., %fa for byte 0xfa. However, they need to be parsed as UTF-8 string, meaning that non-ascii bytes are invalid characters. Therefore, these bytes must be converted to their equivalent multi-byte UTF-8 encodings.

pub fn write<W: Write>(&self, output: &mut W) -> Result<()>

Trait Implementations

impl Clone for Request

fn clone(&self) -> Request

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Request

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Eq for Request

impl PartialEq<Request> for Request

fn eq(&self, other: &Request) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Request) -> bool

This method tests for !=.

impl StructuralEq for Request

impl StructuralPartialEq for Request