Ludo
86464f3e21
Import from agentic-semantic-web/ into restructured repo: - 7 packs (apache, caddy, flask, hugo, nginx, pandoc, python) - shared error pages (403-503) - 17 lab experiments (boilerplate, charts, misc) - 31 example pages (charts, components, content, layout, vault) - 2 themes (garden, trentuna stub) - 4 docs (llms.txt, vocabulary, philosophy, agent-directive) - lineage.md (Pico/Open Props/Charts.css history) - Hugo mounts for lab/ and examples/ All agentic.css references updated to asw.css. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com> |
||
|---|---|---|
| .. | ||
| __pycache__ | ||
| asw_errors.py | ||
| README.md | ||
ASW Flask/FastAPI Error Pack
Drop-in styled error responses for Flask and FastAPI applications.
Usage
# Copy asw_errors.py to your project directory, then:
from flask import Flask
from asw_errors import register_asw_errors
app = Flask(__name__)
register_asw_errors(app)
from fastapi import FastAPI
from asw_errors import register_asw_errors
app = FastAPI()
register_asw_errors(app)
What you get
ASW-styled HTML error pages for all HTTP error codes:
| Code | Status |
|---|---|
| 400 | Bad Request |
| 401 | Unauthorized |
| 403 | Forbidden |
| 404 | Not Found |
| 405 | Method Not Allowed |
| 408 | Request Timeout |
| 409 | Conflict |
| 410 | Gone |
| 415 | Unsupported Media Type |
| 422 | Unprocessable Entity |
| 429 | Too Many Requests |
| 500 | Internal Server Error |
| 502 | Bad Gateway |
| 503 | Service Unavailable |
| 504 | Gateway Timeout |
For FastAPI, RequestValidationError (422) is also caught separately.
Linking asw.css
By default, styles are inlined — no external dependencies needed. If your app already serves asw.css, link it instead:
register_asw_errors(app, css_url="/static/asw.css")
The pages will then use your full theme including custom fonts.
Custom app name
The nav bar shows your app's name. Override it:
register_asw_errors(app, app_name="My Service")
Flask auto-detects from app.name; FastAPI from app.title. Both fall back to sensible defaults.
Standalone HTML generation
The error_html() function is also exported if you need to generate pages directly:
from asw_errors import error_html
html = error_html(404, path="/missing/route")
html = error_html(500, css_url="/static/asw.css", app_name="My API")
No dependencies at module level
Flask and FastAPI are imported lazily inside register_asw_errors() — so this file can live in a project that uses either framework without both installed.