11 releases

new 0.4.0 Mar 22, 2024
0.3.5 Mar 20, 2023
0.3.3 Apr 1, 2022
0.3.2 Jan 7, 2022
0.2.0 Jul 8, 2021

#1225 in HTTP server

Download history 425/week @ 2023-12-02 784/week @ 2023-12-09 670/week @ 2023-12-16 317/week @ 2023-12-23 1286/week @ 2023-12-30 974/week @ 2024-01-06 848/week @ 2024-01-13 1112/week @ 2024-01-20 1191/week @ 2024-01-27 1212/week @ 2024-02-03 966/week @ 2024-02-10 932/week @ 2024-02-17 699/week @ 2024-02-24 815/week @ 2024-03-02 1094/week @ 2024-03-09 1433/week @ 2024-03-16

4,076 downloads per month
Used in 7 crates

MIT/Apache

88KB
1.5K SLoC

Welcome to Trillium!

📖 Guide 📖

The guide provides an architectural overview and lay of the land connecting the trillium crates.

📑 Rustdocs 📑

The rustdocs represent the best way to learn about any of trillium's individual crates and the specific interfaces.




Legal:

Licensed under either of

at your option.

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.


lib.rs:

Welcome to the trillium router crate!

This router is built on top of routefinder, and the details of route resolution and definition are documented on that repository.

use trillium::{conn_unwrap, Conn};
use trillium_router::{Router, RouterConnExt};

let router = Router::new()
.get("/", |conn: Conn| async move { conn.ok("you have reached the index") })
.get("/pages/:page_name", |conn: Conn| async move {
let page_name = conn_unwrap!(conn.param("page_name"), conn);
let content = format!("you have reached the page named {}", page_name);
conn.ok(content)
});

use trillium_testing::prelude::*;
assert_ok!(get("/").on(&router), "you have reached the index");
assert_ok!(get("/pages/trillium").on(&router), "you have reached the page named trillium");
assert_not_handled!(get("/unknown/route").on(&router));

Although this is currently the only trillium router, it is an important aspect of trillium's architecture that the router uses only public apis and is interoperable with other router implementations. If you have different ideas of how a router might work, please publish a crate! It should be possible to nest different types of routers (and different versions of router crates) within each other as long as they all depend on the same version of the trillium crate.

Options handling

By default, the trillium router will reply to an OPTIONS request with the list of supported http methods at the given route. If the OPTIONS request is sent for *, it responds with the full set of http methods supported by this router.

Note: This behavior is superceded by an explicit OPTIONS handler or an any handler.

To disable the default OPTIONS behavior, use Router::without_options_handling or RouterRef::set_options_handling

Dependencies

~7MB
~187K SLoC