User Guide#

In-depth coverage of every FastAPI-Restly feature. Start with the tutorial if you are new to the framework; jump to any topic guide if you are looking for something specific.


Tutorial#

A walkthrough that builds a complete blog API from scratch, introducing the core patterns progressively.

Part 1: Building a CRUD API

Models, schemas, generated endpoints, read/write field control, querying lists, and testing.

Tutorial
Part 2: Customizing Views

Override hooks, low-level object helpers, custom routes, and shared base classes.

Tutorial Part 2: Customizing Views

Topic Guides#

Custom Schemas and Aliases

Define schemas with field aliases, write-only fields, and read-only computed fields.

How-To: Use Custom Schemas and Aliases
Override Endpoints

Customize on_* hooks and add custom routes alongside generated CRUD.

How-To: Override CRUD Behavior and Add Custom Endpoints
Share Behaviour with Base Views

Use Python inheritance to share CRUD overrides, dependencies, URL prefixes, and access control across multiple views.

How-To: Share Behaviour with Base Views
Filter, Sort, and Paginate

Use V1 (JSONAPI-style) and V2 (HTTP-style) query parameter interfaces.

How-To: Filter, Sort, and Paginate Lists
Foreign Keys with IDSchema

Reference related objects by ID with automatic resolution and 404 on missing.

How-To: Work with Foreign Keys Using IDSchema
Testing

Use RestlyTestClient and savepoint-based pytest fixtures for isolated tests.

How-To: Test APIs with RestlyTestClient and Fixtures
pytest Fixtures Reference

Full fixture reference with isolation model details and async test setup.

pytest Fixtures Reference
Existing Project Integration

Plug FastAPI-Restly into a project that already manages its own sessions.

How-To: Use FastAPI-Restly in an Existing Project
Technical Details

Schema generation internals, view registration, and query modifier lifecycle.

Technical Details