Skip to content

Customization

Thomas Pollet edited this page Mar 8, 2026 · 7 revisions

Customization

Use this page as a map to the main customization mechanisms in SAFRS.

Serialization customization

Use Serialization and jsonapi_attr when you need to:

  • override to_dict
  • expose computed attributes
  • add writable computed properties with setters
  • hide attributes or relationships

HTTP methods and hooks

Use HTTP Methods and Hooks when you need to:

  • restrict allowed CRUD methods with http_methods
  • override _s_post or _s_patch
  • implement hook-style behavior around writes

Endpoint decorators and auth

Use Endpoint Decorators and Security and Access Control when you need:

  • decorators on model endpoints
  • relationship-level decorators
  • auth examples
  • permission hooks such as _s_check_perm

OpenAPI / Swagger customization

Use OpenAPI / Swagger Customization for:

  • custom swagger/openapi fragments
  • docstring-driven docs
  • prefix and dispatch customizations

Column and relationship exposure

See:

Configuration

See Configuration Reference for pagination limits, relationship toggles, and config strategy.

Clone this wiki locally