#![doc(html_root_url = "https://docs.rs/hyper/0.14.0")] #![deny(missing_docs)] #![deny(missing_debug_implementations)] #![cfg_attr(test, deny(rust_2018_idioms))] #![cfg_attr(test, deny(warnings))] #![cfg_attr(all(test, feature = "nightly"), feature(test))] //! # hyper //! //! hyper is a **fast** and **correct** HTTP implementation written in and for Rust. //! //! ## Features //! //! - HTTP/1 and HTTP/2 //! - Asynchronous design //! - Leading in performance //! - Tested and **correct** //! - Extensive production use //! - [Client](client/index.html) and [Server](server/index.html) APIs //! //! If just starting out, **check out the [Guides](https://hyper.rs/guides) //! first.** //! //! ## "Low-level" //! //! hyper is a lower-level HTTP library, meant to be a building block //! for libraries and applications. //! //! If looking for just a convenient HTTP client, consider the //! [reqwest](https://crates.io/crates/reqwest) crate. //! //! # Optional Features //! //! hyper uses a set of [feature flags] to reduce the amount of compiled code. //! It is possible to just enable certain features over others. By default, //! hyper does not enable any features but allows one to enable a subset for //! their use case. Below is a list of the available feature flags. You may //! also notice above each function, struct and trait there is listed one or //! more feature flags that are required for that item to be used. //! //! If you are new to hyper it is possible to enable the `full` feature flag //! which will enable all public APIs. Beware though that this will pull in //! many extra dependencies that you may not need. //! //! The following optional features are available: //! //! - `http1`: Enables HTTP/1 support. //! - `http2`: Enables HTTP/2 support. //! - `client`: Enables the HTTP `client`. //! - `server`: Enables the HTTP `server`. //! - `runtime`: Enables convenient integration with `tokio`, providing //! connectors and acceptors for TCP, and a default executor. //! - `tcp`: Enables convenient implementations over TCP (using tokio). //! - `stream`: Provides `futures::Stream` capabilities. //! //! [feature flags]: https://doc.rust-lang.org/cargo/reference/manifest.html#the-features-section #[doc(hidden)] pub use http; #[cfg(any(feature = "http1", feature = "http2"))] #[macro_use] extern crate tracing; #[cfg(all(test, feature = "nightly"))] extern crate test; pub use http::{header, HeaderMap, Method, Request, Response, StatusCode, Uri, Version}; pub use crate::body::Body; pub use crate::error::{Error, Result}; #[macro_use] mod cfg; #[macro_use] mod common; pub mod body; mod error; #[cfg(test)] mod mock; #[cfg(any(feature = "http1", feature = "http2",))] pub mod rt; pub mod service; pub mod upgrade; cfg_proto! { mod headers; mod proto; } cfg_feature! { #![all(feature = "client", any(feature = "http1", feature = "http2"))] pub mod client; pub use crate::client::Client; } cfg_feature! { #![all(feature = "server", any(feature = "http1", feature = "http2"))] pub mod server; pub use crate::server::Server; }