Struct memory_serve::MemoryServe

pub struct MemoryServe { /* private fields */ }

Helper struct to create and configure an axum to serve static files from memory. Initiate an instance with the MemoryServe::new method and pass a call to the load_assets! macro as the single argument.

Implementations

impl MemoryServe

pub fn new(assets: &'static [Asset]) -> Self

Initiate a MemoryServe instance, takes the output of load_assets! as an argument. load_assets! takes a directory name relative from the project root.

pub fn index_file(self, index_file: Option<&'static str>) -> Self

Which static file to serve on the route “/” (the index) The path (or route) should be relative to the directory passed to the load_assets! macro, but prepended with a slash. By default this is Some("/index.html")

pub fn fallback(self, fallback: Option<&'static str>) -> Self

Which static file to serve when no other routes are matched, also see fallback The path (or route) should be relative to the directory passed to the load_assets! macro, but prepended with a slash. By default this is None, which means axum will return an empty response with a HTTP 404 status code when no route matches.

pub fn fallback_status(self, fallback_status: StatusCode) -> Self

What HTTP status code to return when a static file is returned by the fallback handler.

pub fn enable_gzip(self, enable_gzip: bool) -> Self

Whether to enable gzip compression. When set to true, clients that accept gzip compressed files, but not brotli compressed files, are served gzip compressed files.

pub fn enable_brotli(self, enable_brotli: bool) -> Self

Whether to enable brotli compression. When set to true, clients that accept brotli compressed files are served brotli compressed files.

pub fn html_cache_control(self, html_cache_control: CacheControl) -> Self

The Cache-Control header to set for HTML files. See Cache control for options.

pub fn cache_control(self, cache_control: CacheControl) -> Self

Cache header to non-HTML files. See Cache control for options.

pub fn add_alias(self, from: &'static str, to: &'static str) -> Self

Create an alias for a route / file

pub fn into_router<S>(self) -> Router<S>

where S: Clone + Send + Sync + 'static,

Create an axum Router instance that will serve the included static assets Caution! This method leaks memory. It should only be called once (at startup).

Trait Implementations

impl Debug for MemoryServe

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for MemoryServe

fn default() -> MemoryServe

Returns the “default value” for a type.