poem 1.0.20

Poem is a full-featured and easy-to-use web framework with the Rust programming language.
Documentation

Features

  • Both Ease of use and performance.
  • Minimizing the use of generics.
  • Blazing fast and flexible routing.
  • tower::Service and tower::Layer compatibility.
  • Use poem-openapi to write APIs that comply with OAS3 specifications and automatically generate documents.

Crate features

To avoid compiling unused dependencies, Poem gates certain features, all of which are disabled by default:

Feature Description
cookie Support for Cookie
websocket Support for WebSocket
multipart Support for Multipart
sse Support Server-Sent Events (SSE)
tls Support for HTTP server over TLS
tempfile Support for tempfile
tower-compat Adapters for tower::Layer and tower::Service.
session Support for CookieSession
redis-session Support for RedisSession
opentelemetry Support for opentelemetry
prometheus Support for Prometheus

Safety

This crate uses #![forbid(unsafe_code)] to ensure everything is implemented in 100% Safe Rust.

Example

use poem::{get, handler, listener::TcpListener, web::Path, Route, Server};

#[handler]
fn hello(Path(name): Path<String>) -> String {
    format!("hello: {}", name)
}

#[tokio::main]
async fn main() -> Result<(), std::io::Error> {
    let app = Route::new().at("/hello/:name", get(hello));
    let listener = TcpListener::bind("127.0.0.1:3000");
    let server = Server::new(listener).await?;
    server.run(app).await
}

More examples can be found here.

MSRV

The minimum supported Rust version for this crate is 1.56.1.

Contributing

:balloon: Thanks for your help improving the project! We are so happy to have you!

License

Licensed under either of

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in Poem by you, shall be licensed as Apache, without any additional terms or conditions.