-
Notifications
You must be signed in to change notification settings - Fork 73
Debug Logs
Thomas Pollet edited this page Mar 8, 2026
·
3 revisions
- Applies to: Flask and FastAPI
- Best sources:
safrs/config.py,safrs/errors.py - Related pages: Troubleshooting, Content Types and Errors
Verbose logs are useful during development, but they can expose sensitive details in production.
SAFRS error handling uses log-level driven debug behavior. In debug mode, errors may include more detail. In non-debug mode, client-visible messages are intentionally reduced.
Use application logging configuration and deployment log levels rather than relying on ad hoc prints.
- keep verbose tracebacks for local development
- avoid exposing internals to clients in production
- log server-side details that operators need, while returning JSON:API error documents to clients
- Home
- Installation
- Quickstart (Flask)
- Quickstart (FastAPI)
- JSON:API Basics
- Relationships and Includes
- Filtering
- Sorting, Pagination, and Sparse Fieldsets
- Content Types and Errors
- Bulk Requests
- RPC / Custom Methods
- Customization
- Security and Access Control
- Stateless Endpoints / JABase
- Performance
- Examples
- Existing Databases (Legacy)
- PostGIS / GeoAlchemy2
- Docker / Deployment
- Troubleshooting
- Reference: SAFRSBase
- Reference: SAFRSBase Customization