Crate under

Expand description

Under is a batteries-included async HTTP framework built for easy development. Under is based on Tokio, an async runtime. Under is meant to take the headache out of developing HTTP servers, while still being fairly performant.

Getting Started

To get started, just add under and tokio to your Cargo.toml:

under = "0.3.5"
tokio = { version = "1.12.0", features = ["full"] } # or whatever the latest version is

Examples

async fn hello_world(_: under::Request) -> Result<under::Response, anyhow::Error> {
    Ok(under::Response::text("hello, world!"))
}

#[tokio::main]
async fn main() -> Result<(), anyhow::Error> {
    let mut http = under::http();
    http.at("/").get(hello_world);
    http.listen("0.0.0.0:8080").await?;
    Ok(())
}

Re-exports

pub use self::middleware::Middleware;

pub use ::http;

Modules

endpoints

Pre-defined endpoints.

middleware

Pre-defined middleware.

ssesse

Async SSE.

Structs

Body

A stream of Bytes, used when receiving bodies.

Cookiecookie

Representation of an HTTP cookie.

CookieBuildercookie

Structure that follows the builder pattern for building Cookie structs.

CookieJarcookie

A collection of cookies that tracks its modifications.

DataStream

The data stream of a body.

DataTransfer

Information about a data transfer. This is the result of DataStream::into, and provides information about the state of the stream after the transfer.

Path

A description of a path in the router.

RemoteAddress

A type that helps retrieve the remote address of a request.

Request

Represents an HTTP request.

Response

An HTTP response.

Router

An HTTP router.