1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54

//! <p align="center">
//!   <img src="https://raw.githubusercontent.com/w-henderson/Humphrey/master/assets/logo.png" width=250><br><br>
//!   <img src="https://img.shields.io/badge/language-rust-b07858?style=for-the-badge&logo=rust" style="margin-right:5px">
//!   <img src="https://img.shields.io/github/workflow/status/w-henderson/Humphrey/CI?style=for-the-badge" style="margin-right:5px">
//!   <img src="https://img.shields.io/crates/v/humphrey?style=for-the-badge" style="margin-right:5px">
//! </p>
//!
//! # Humphrey: A Performance-Focused, Dependency-Free Web Server.
//! Humphrey is a very fast, robust and flexible HTTP/1.1 web server crate which allows you to develop web applications in Rust. With no dependencies, it is very quick to compile and produces very small binaries, as well as being very resource-efficient.
//!
//! ## Installation
//! The Humphrey crate can be installed by adding `humphrey` to your Cargo.toml file.
//!
//! ## Basic Example
//! ```
//! use humphrey::http::{Request, Response, StatusCode};
//! use humphrey::App;
//! use std::{error::Error, sync::Arc};
//!
//! fn main() -> Result<(), Box<dyn Error>> {
//!     let app = App::new()
//!         .with_route("/", home)
//!         .with_route("/contact", contact);
//!     app.run("0.0.0.0:80")?;
//!
//!     Ok(())
//! }
//!
//! fn home(request: Request, _: Arc<()>) -> Response {
//!     Response::new(StatusCode::OK, b"<html><body><h1>Home</h1></body></html>", &request)
//! }
//!
//! fn contact(request: Request, _: Arc<()>) -> Response {
//!     Response::new(StatusCode::OK, b"<html><body><h1>Contact</h1></body></html>", &request)
//! }
//! ```
//!
//!
//! ## Further Examples
//! - [Stateful Example](https://github.com/w-henderson/Humphrey/tree/master/examples/stateful): keeps track of button presses across sessions and devices
//! - [Wildcard Example](https://github.com/w-henderson/Humphrey/tree/master/examples/wildcard): demonstrates a wildcard route
//! - [Static Content Example](https://github.com/w-henderson/Humphrey/tree/master/examples/static-content): demonstrates the built-in static content handlers

pub mod app;
pub mod handlers;
pub mod http;
pub mod krauss;
pub mod route;
pub mod thread;

#[cfg(test)]
mod tests;

pub use app::App;