stream-httparse 0.2.6

A fast streaming HTTP-Parser
Documentation
mod key;
pub use key::HeaderKey;
mod value;
pub use value::HeaderValue;

/// A single HTTP-Header Pair(Key-Value)
#[derive(Clone, Debug)]
pub struct Header<'a> {
    /// The Key part of the Header
    pub key: HeaderKey<'a>,
    /// The Value assosicated with the Header
    pub value: HeaderValue<'a>,
}

impl PartialEq for Header<'_> {
    fn eq(&self, other: &Self) -> bool {
        self.key.eq(&other.key)
    }
}

impl<'a> Header<'a> {
    /// Serializes the Header into the given Buffer
    /// by appending the final Data to the End of it
    pub fn serialize(&self, buf: &mut Vec<u8>) {
        self.key.serialize(buf);
        buf.extend_from_slice(": ".as_bytes());
        self.value.serialize(buf);
        buf.extend_from_slice("\r\n".as_bytes());
    }

    /// Clones all the assosicated Data to create a completly
    /// new and independant Header instance
    pub fn to_owned<'refed, 'owned>(&'refed self) -> Header<'owned> {
        Header {
            key: self.key.to_owned(),
            value: self.value.to_owned(),
        }
    }
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn compare() {
        assert_eq!(
            Header {
                key: HeaderKey::StrRef("test"),
                value: HeaderValue::StrRef("value"),
            },
            Header {
                key: HeaderKey::StrRef("test"),
                value: HeaderValue::StrRef("some other value"),
            }
        );
    }

    #[test]
    fn serialize() {
        let header = Header {
            key: HeaderKey::StrRef("test-key"),
            value: HeaderValue::StrRef("test-value"),
        };

        let mut buf: Vec<u8> = Vec::new();
        header.serialize(&mut buf);
        assert_eq!("test-key: test-value\r\n".as_bytes(), &buf);
    }
}