12 releases (stable)

1.7.1 Apr 29, 2024
1.7.0 Apr 24, 2024
1.2.3 Oct 24, 2023
1.2.2 Jul 16, 2023
0.1.2 Jan 22, 2023

#1101 in HTTP server

Download history 107/week @ 2024-03-30 90/week @ 2024-04-06 131/week @ 2024-04-13 470/week @ 2024-04-20 463/week @ 2024-04-27 138/week @ 2024-05-04 235/week @ 2024-05-11 207/week @ 2024-05-18 277/week @ 2024-05-25 263/week @ 2024-06-01 80/week @ 2024-06-08 111/week @ 2024-06-15 89/week @ 2024-06-22 110/week @ 2024-06-29 128/week @ 2024-07-06 166/week @ 2024-07-13

513 downloads per month

MIT license

8KB
104 lines

axum_static

GitHub license

static file serving for axum

Version

You must use axum_static that matches your axum version.

  • axum 0.6 => axum_static ~1.6.*
  • axum 0.7 => axum_static ~1.7.*

Usage

First install crate.

cargo add axum_static

Then, create a static route and nest it in the existing route like so

let app = Router::new()
        .nest("/", axum_static::static_router("public"))

If your app has state, you'll need to add with_state, because static_router does not use state (()):

let app = Router::new()
        .route("/", get(index))
        ......
        .nest("/static", axum_static::static_router("static").with_state())
        ......
        .with_state(YourAppState { ... })

The argument of the static_router function is the path to read static files based on the project root path.

Then you can read the file like this. It can also be a sub directory.

This is the end.

Dependencies

~6.5–8.5MB
~152K SLoC