sigildocs

(sigil web middleware)

(sigil web middleware) - Composable Middleware

Provides middleware composition for request/response processing. Middleware wraps handlers to add cross-cutting concerns like logging, authentication, CORS, etc.

Two styles are supported:

  1. Factory style (traditional): (wrap-middleware handler (logger-middleware) (cors-middleware '("*")))
  2. Chain style (with chain/-> macro): (chain handler (with-logging) (with-cors "*") (with-not-found))

Exports

wrap-middlewareprocedure

Wrap a handler with multiple middleware Middleware are applied right-to-left (last middleware is outermost) Each middleware is: (handler) -> new-handler

compose-middlewareprocedure

Compose multiple middleware into one Returns a single middleware function

logger-middlewareprocedure

Log requests and responses Options:

  • output: port to write to (default: current-output-port)
current-time-msprocedure

Get current time in milliseconds

cors-middlewareprocedure

Add CORS headers to responses origins: list of allowed origins, or '("*") for any

content-type-middlewareprocedure

Set default Content-Type if not present

not-found-middlewareprocedure

Return 404 response if handler returns #f

with-loggingvariable

Wrap handler with request/response logging Keywords: output: - port for log output (default: current-output-port)

with-corsvariable

Wrap handler with CORS headers Keywords: allow-origin: - allowed origin ("" for any, default: "") allow-methods: - allowed methods string allow-headers: - allowed headers string

with-content-typevariable

Wrap handler with default Content-Type Keywords: default: - default content type (default: "text/html")

with-not-foundvariable

Wrap handler with 404 fallback Keywords: body: - custom 404 body HTML