httpstatusx is a semantic, bidirectional, and framework-agnostic Python library for working with HTTP status codes.
It removes the need to memorize numeric HTTP codes and helps backend developers write clean, readable, and maintainable APIs.
- Full IANA HTTP status code coverage
- Name → Code and Code → Name lookup
- Semantic categories (success, client_error, server_error, etc.)
- Fuzzy matching for shorthand queries
- FastAPI & Flask integrations
- Command-line interface (CLI)
- Fully tested & open-source
pip install httpstatusxFor development:
pip install -e .from httpstatusx import HTTP
HTTP["ok"] # 200
HTTP["created"] # 201
HTTP["unauth"] # 401
HTTP.name(404) # "not_found"
HTTP.category(503) # "server_error"
HTTP.is_error(400) # Truefrom httpstatusx import fastapi
raise fastapi("not_found", "User not found")from httpstatusx import flask
flask("unauthorized")httpstatusx ok
httpstatusx 404
httpstatusx service_unavailablepytest
pytest --cov=httpstatusxMIT License © 2025 Adam Koda