http/README.md

http

A rust http parsing library

Example

use http::{request::Request, parse::TryParse, error::HTTPError, response::Response, status, header::HeaderName};

fn main() -> Result<(), HTTPError> {

    // http request as a string
    let request_str =   "GET / HTTP/1.1\n\
                         Host: www.example.com\n\
                         User-Agent: Mozilla/4.0\n\
                         Accept-language: en\n\
                         \n\
                        ";

                            // here we set what we want the body to be parsed into if it exists
                            // the body type must implement FromStr and ToString
    let request = Request::<String>::try_parse(request_str)?; // try parse since it can fail

    let mut response = Response::<String>::new(); // create a new response
    response
            .set_body("hello world!") // add a body that is Into<T>
            .set_status(status::SUCCESS) // set the status
            .add_header((HeaderName::try_from("Content-Type")?, "text/plain")); // set content-type header

    let response_str = response.to_string(); // get http response in text form

    Ok(())
}

License

This project is licensed under the GPLv3