rocket-assets-fairing

Crates.iorocket-assets-fairing
lib.rsrocket-assets-fairing
version0.1.0
sourcesrc
created_at2022-01-08 17:24:36.12375
updated_at2022-01-08 17:24:36.12375
descriptionA rocket fairing for easily serving static with cache policy from a configurable directory
homepage
repositoryhttps://github.com/misterio77/rocket-assets-fairing
max_upload_size
id510355
size8,091
Gabriel Fontes (Misterio77)

documentation

README

Rocket Assets Fairing

rocket-assets-fairing is a Fairing for Rocket for easily serving static assets from a folder, with a nice cache policy.

Installing

Add to your Cargo.toml:

rocket-assets-fairing = "0.1"

Usage

use assets_rocket_fairing::{Asset, Assets};

#[rocket::main]
async fn main() {
   rocket::build()
       .attach(Assets::fairing())
       .mount("/assets", routes![style])
       .launch()
       .await;
}

#[get("/style.css")]
async fn style(assets: &Assets) -> Option<Asset> {
   assets.open("style.css").await.ok()
}

Configuration

This is configurable the same way as Rocket.

Either through Rocket.toml:

[default]
assets_dir = "assets"
assets_max_age = 86400

Or using environment variables:

  • ROCKET_ASSETS_DIR
  • ROCKET_ASSETS_MAX_AGE
Commit count: 2

cargo fmt