via 2.0.0-gm.53

// #![deny(missing_docs)]

//! An async multi-threaded web framework for people who appreciate simplicity.
//!
//! Documentation is sparse at the moment, but the code is well-commented for
//! the most part.
//!
//! If you're interested in contributing, helping with documentation is a great
//! starting point.
//!
//! ## Hello World Example
//!
//! Below is a basic example to demonstrate how to use Via to create a simple
//! web server that responds to requests at `/hello/:name` with a personalized
//! greeting.
//! [Additional examples](https://github.com/zacharygolba/via/tree/main/examples)
//! can be found in our git repository.
//!
//! ```no_run
//! use std::process::ExitCode;
//! use via::{Error, Next, Request, Response, ResultExt, Server};
//!
//! async fn hello(request: Request, _: Next) -> via::Result {
//!     // Get a reference to the path parameter `name` from the request uri.
//!     let name = request.param("name").percent_decode().into_result()?;
//!
//!     // Send a plain text response with our greeting message.
//!     Response::build().text(format!("Hello, {}!", name))
//! }
//!
//! #[tokio::main]
//! async fn main() -> Result<ExitCode, Error> {
//!     let mut app = via::app(());
//!
//!     // Define a route that listens on /hello/:name.
//!     app.route("/hello/:name").to(via::get(hello));
//!
//!     Server::new(app).listen(("127.0.0.1", 8080)).await
//! }
//! ```
//!

pub mod error;
pub mod guard;
pub mod request;
pub mod response;
pub mod router;

#[cfg(any(feature = "tokio-tungstenite", feature = "tokio-websockets"))]
pub mod ws;

mod app;
mod cookies;
mod middleware;
mod next;
mod rest;
mod server;
mod util;

pub use app::{Shared, Via, app};
pub use cookies::{Cookies, cookies};
pub use error::{Error, ResultExt, rescue};
pub use guard::guard;
pub use middleware::{BoxFuture, Middleware, Result};
pub use next::{Continue, Next};
pub use request::{Payload, Request};
pub use response::{Finalize, Response};
pub use router::{delete, get, head, options, patch, post, put, trace};
pub use server::Server;

#[cfg(any(feature = "tokio-tungstenite", feature = "tokio-websockets"))]
pub use ws::ws;