mooncakes.io

README

mizchi/crater-browser-http/cache does not have a README file

#
HttpCacheBackend

pub(open) trait HttpCacheBackend {
  fn lookup(Self, String) -> CacheEntry?
  fn store(Self, CacheEntry) -> Unit
  fn remove(Self, String) -> Unit
  fn clear(Self) -> Unit
}

Shared cache backend contract used by cached_fetch.

#
CacheDirectives

source

pub(all) struct CacheDirectives {
  max_age : Int?
  no_cache : Bool
  no_store : Bool
  must_revalidate : Bool
  public_ : Bool
  private_ : Bool
  immutable : Bool
} derive(@moonbitlang/core/debug.Debug
Debug)

Parsed Cache-Control header directives

impl Show for CacheDirectives

#
CacheDirectives::default

source

fn CacheDirectives::default() -> CacheDirectives

#
CacheEntry

source

pub(all) struct CacheEntry {
  url : String
  status : Int
  headers : Map[String, String]
  body : String
  etag : String?
  last_modified : String?
  directives : CacheDirectives
  stored_at : Double
} derive(@moonbitlang/core/debug.Debug
Debug)

Cached HTTP response entry

#
MemoryCacheBackend

source

pub(all) struct MemoryCacheBackend {
  entries : Map[String, CacheEntry]
  max_entries : Int
}

In-memory cache backend with LRU-style eviction by oldest stored_at.

impl HttpCacheBackend for MemoryCacheBackend

fn clear(self : MemoryCacheBackend) -> Unit

source

fn lookup(self : MemoryCacheBackend, url : String) -> CacheEntry?

source

fn remove(self : MemoryCacheBackend, url : String) -> Unit

source

fn store(self : MemoryCacheBackend, entry : CacheEntry) -> Unit

source

#
MemoryCacheBackend::clear

source

fn MemoryCacheBackend::clear(self : MemoryCacheBackend) -> Unit

Clear all cache entries.

#
MemoryCacheBackend::lookup

source

fn MemoryCacheBackend::lookup(self : MemoryCacheBackend, url : String) -> CacheEntry?

Look up a cache entry by URL. Returns None if not found.

#
MemoryCacheBackend::new

source

fn MemoryCacheBackend::new(max_entries? : Int) -> MemoryCacheBackend

#
MemoryCacheBackend::remove

source

fn MemoryCacheBackend::remove(self : MemoryCacheBackend, url : String) -> Unit

Remove a cache entry by URL.

#
MemoryCacheBackend::store

source

fn MemoryCacheBackend::store(self : MemoryCacheBackend, entry : CacheEntry) -> Unit

Store a cache entry. If at capacity and key is new, evict the oldest entry by stored_at.

#
cached_fetch

source

fn[CacheBackend : HttpCacheBackend] cached_fetch(url~ : String, options~ : @mizchi/crater-browser-http.FetchOptions
FetchOptions, cache~ : CacheBackend, fetcher~ : (String, @mizchi/crater-browser-http.FetchOptions
FetchOptions) -> @mizchi/crater-browser-http.HttpResponse
HttpResponse raise @mizchi/crater-browser-http.HttpError
HttpError) -> @mizchi/crater-browser-http.HttpResponse
HttpResponse raise @mizchi/crater-browser-http.HttpError
HttpError

Fetch with transparent HTTP caching (sync version for testing). Only GET requests are cached. The fetcher parameter allows callers to inject any transport function.

#
cached_fetch_async

source

async fn[CacheBackend : HttpCacheBackend] cached_fetch_async(url~ : String, options~ : @mizchi/crater-browser-http.FetchOptions
FetchOptions, cache~ : CacheBackend, fetcher~ : async (String, @mizchi/crater-browser-http.FetchOptions
FetchOptions) -> @mizchi/crater-browser-http.HttpResponse
HttpResponse raise @mizchi/crater-browser-http.HttpError
HttpError) -> @mizchi/crater-browser-http.HttpResponse
HttpResponse raise @mizchi/crater-browser-http.HttpError
HttpError

Fetch with transparent HTTP caching (async version). Wraps an async fetcher (e.g. @http.fetch) with cache lookup/store. Only GET requests are cached.

#
is_cacheable_status

source

fn is_cacheable_status(status : Int) -> Bool

Check if an HTTP status code is cacheable. Only 200, 203, 204, 206, 300, 301, 308 are cacheable by default (RFC 9111 §4.2.2).

#
is_fresh

source

fn is_fresh(entry : CacheEntry, now : Double) -> Bool

Check whether a cache entry is still fresh at the given time.

#
now_seconds

source

fn now_seconds() -> Double

Get current time in seconds since epoch. Delegates to platform-specific FFI.

#
parse_cache_control

source

fn parse_cache_control(header : String) -> CacheDirectives

Parse a Cache-Control header value into CacheDirectives.

Source Files

Site source Report issue Packages Build queue Skills Statistics

#HttpCacheBackend

#CacheDirectives

#CacheDirectives::default

#CacheEntry

#MemoryCacheBackend

#MemoryCacheBackend::clear

#MemoryCacheBackend::lookup

#MemoryCacheBackend::new

#MemoryCacheBackend::remove

#MemoryCacheBackend::store

#cached_fetch

#cached_fetch_async

#is_cacheable_status

#is_fresh

#now_seconds

#parse_cache_control

Source Files

#
HttpCacheBackend

#
CacheDirectives

#
CacheDirectives::default

#
CacheEntry

#
MemoryCacheBackend

#
MemoryCacheBackend::clear

#
MemoryCacheBackend::lookup

#
MemoryCacheBackend::new

#
MemoryCacheBackend::remove

#
MemoryCacheBackend::store

#
cached_fetch

#
cached_fetch_async

#
is_cacheable_status

#
is_fresh

#
now_seconds

#
parse_cache_control