Elaine

![ci.img] ![docs.img] ![crates.img]

This crate provides a lightweight and potentially incomplete http head parser implementation for async-std readers.

Goals & Stuff

This crate is intended to provide an HTTP head parser for async [readers] with a focus on simplicity and safety; while performance is appreciated, safety and simplicity take priority.

On Safety

The api provided by this crate will never include unsafe code directly, including code that would otherwise improve the performance of the libary. In addition, the main export - recognize - provides the guaruntee that it will never over-read bytes from a reader, again at the potential loss of performance.

On Simplictity

This crate does not include the http in it's dependencies; though well-maintained and useful as it is, it would introduce a super set of functionality that is not required for this implementation. This decision is not in any way meant to discourage other developers from using that library.

Example

```rust use std::boxed::Box; use std::error::Error;

use elaine::{recognize, RequestMethod}; use asyncstd::task::blockon;

fn main() -> Result<(), Box> { blockon(async { let mut req: &[u8] = b"GET /elaine HTTP/1.1\r\nContent-Length: 3\r\n\r\nhey"; let result = recognize(&mut req).await.unwrap(); asserteq!(result.method(), Some(RequestMethod::GET)); asserteq!(result.len(), Some(3)); asserteq!(std::str::from_utf8(req), Ok("hey")); }); Ok(()) } ```

| elaine | | --- | | |

Contributing

See CONTRIBUTING.