#web-framework #poem-web #async #tower-service #tower-layer #framework

poem

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

212 releases (stable)

3.0.0 Mar 30, 2024
2.0.1 Mar 4, 2024
2.0.0 Jan 6, 2024
1.3.59 Nov 19, 2023
0.1.0 Aug 5, 2020

#6 in HTTP server

Download history 7533/week @ 2023-12-23 9492/week @ 2023-12-30 12012/week @ 2024-01-06 12881/week @ 2024-01-13 12171/week @ 2024-01-20 10598/week @ 2024-01-27 10916/week @ 2024-02-03 9070/week @ 2024-02-10 12143/week @ 2024-02-17 13698/week @ 2024-02-24 13489/week @ 2024-03-02 12289/week @ 2024-03-09 12643/week @ 2024-03-16 11282/week @ 2024-03-23 11702/week @ 2024-03-30 8398/week @ 2024-04-06

46,142 downloads per month
Used in 147 crates (60 directly)

MIT/Apache

745KB
17K SLoC

Poem Framework

A program is like a poem, you cannot write a poem without writing it. --- Dijkstra

A full-featured and easy-to-use web framework with the Rust programming language.


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
server Server and listener APIs (enabled by default)
compression Support decompress request body and compress response body
cookie Support for Cookie
csrf Support for Cross-Site Request Forgery (CSRF) protection
multipart Support for Multipart
native-tls Support for HTTP server over TLS with native-tls
openssl-tls Support for HTTP server over TLS with openssl-tls
opentelemetry Support for opentelemetry
prometheus Support for Prometheus
redis-session Support for RedisSession
rustls Support for HTTP server over TLS with rustls
session Support for session
sse Support Server-Sent Events (SSE)
static-files Support static files endpoint
tempfile Support for tempfile
tower-compat Adapters for tower::Layer and tower::Service.
websocket Support for WebSocket
anyhow Integrate with anyhow crate.
eyre06 Integrate with version 0.6.x of the eyre crate.
i18n Support for internationalization
acme-native-roots Support for ACME(Automatic Certificate Management Environment)
acme-webpki-roots Support for ACME using webpki TLS roots rather than native TLS roots
tokio-metrics Integrate with tokio-metrics crate.
embed Integrate with rust-embed crate.
xml Integrate with quick-xml crate.
yaml Integrate with serde-yaml crate.

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));
    Server::new(TcpListener::bind("0.0.0.0:3000"))
      .run(app)
      .await
}

More examples can be found here.

MSRV

The minimum supported Rust version for this crate is 1.75.0.

Contributing

🎈 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.

Dependencies

~13–36MB
~604K SLoC