Struct CacheBuster 

pub struct CacheBuster { /* private fields */ }

Resolves a logical asset path to its content-hashed one.

Implementations

impl CacheBuster

pub fn empty() -> Self

A cache buster that knows about nothing, for a server with no static assets at all.

pub fn load() -> Result<Self, CacheBusterError>

Loads the manifest the build produced.

A project with no static/ gets an empty map and serves no /static route. A project with static/ but no manifest is a build that never ran its asset step: every hashed URL would 404, so that is an error rather than a silent degradation.

Errors

CacheBusterError::MissingManifest if there are assets but no manifest, or CacheBusterError::ParseManifest if it is malformed.

pub fn get_file(&self, original: &str) -> String

The hashed path for original, or original itself when it is not a hashed asset.

Never fails: falling back is better than taking a page down over one image.

pub fn is_hashed(&self, original: &str) -> bool

Whether original is a known hashed asset.

The distinction get_file cannot make: it returns the input unchanged for anything it does not know, which is right for an absolute URL and wrong for a typo. Boot-time validation needs to tell those apart.

pub const fn manifest(&self) -> &Manifest

The manifest itself.

pub const fn cache(&self) -> &BTreeMap<String, String>

The whole map, as the templates see it.

pub fn is_empty(&self) -> bool

Whether any asset is hashed.

pub async fn never_cache_middleware( request: Request, next: Next, ) -> Result<Response, StatusCode>

Marks a response as never cacheable.

For everything whose URL does not carry a content hash: pages, API responses, robots.txt. Conditional-request headers are stripped as well, so an intermediary cannot revalidate its way back to a stale copy.

Errors

Never; the signature matches axum’s middleware shape.

pub async fn forever_cache_middleware( request: Request, next: Next, ) -> Result<Response, StatusCode>

Marks a response as immutable for a year.

Only ever correct for content-hashed URLs, where a changed file is a changed URL by construction. That invariant is why every byte under /static is hashed, including the well-known icons.

Errors

Never; the signature matches axum’s middleware shape.

Trait Implementations

impl Clone for CacheBuster

fn clone(&self) -> CacheBuster

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for CacheBuster

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

Formats the value using the given formatter.

impl Default for CacheBuster

fn default() -> CacheBuster

Returns the “default value” for a type.

impl Display for CacheBuster

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

Formats the value using the given formatter.