How eytanohana/fast-pager works
fast-pager is a FastAPI query-parameter and database-query compilation library. The main workflow starts when a route registers FilterDepends: model metadata and configuration define the exposed filter surface; FastAPI validates request parameters; FilterQuery parses them into a backend-neutral AST; a backend compiler produces a query for the application’s database. Pagination can additionally return a Page envelope. The graph includes the documented MongoDB and SQLAlchemy backends. Some internal relationships are evidenced only by the source index; conformance is included as a substantial module, but its runtime role is unclear from the excerpts.
Main entry points: query.py FilterQuery · dependency.py FastAPI dependency · params.py Query parameters · introspection.py Model introspection
Components 16
API configuration
- FastAPI dependency
src/fast_pager/dependency.py - Filter config
src/fast_pager/config.py - FilterSet allow-list
src/fast_pager/filterset.py - Field controls
src/fast_pager/filterable.py
Request modeling
- Model introspection
src/fast_pager/introspection.py - Operator registry
src/fast_pager/operators.py - Query parameters
src/fast_pager/params.py
Query representation
- FilterQuery
src/fast_pager/query.py - Filter AST
src/fast_pager/ast.py - Page envelope
src/fast_pager/pagination.py
Backend compilation
- Compiler contract
src/fast_pager/backends/base.py - Mongo compiler
src/fast_pager/backends/mongo.py - SQLAlchemy compiler
src/fast_pager/backends/sqlalchemy.py - Conformance module
src/fast_pager/conformance.py
Other components
- Route author
- Application database
Connections 22
- Route author → FastAPI dependency: registers filters
README.md - FastAPI dependency → Filter config: uses settings
src/fast_pager/dependency.py - FastAPI dependency → FilterSet allow-list: accepts filter set
src/fast_pager/dependency.py - FastAPI dependency → Query parameters: builds parameters
src/fast_pager/dependency.py - FastAPI dependency → FilterQuery: provides query
src/fast_pager/dependency.py - Query parameters → Model introspection: derives fields
src/fast_pager/params.py - Query parameters → Operator registry: resolves operators
src/fast_pager/params.py - Model introspection → Field controls: reads metadata
src/fast_pager/introspection.py - Model introspection → Operator registry: classifies types
src/fast_pager/introspection.py - FilterSet allow-list → Model introspection: selects fields
src/fast_pager/filterset.py - FilterSet allow-list → Query parameters: defines surface
src/fast_pager/filterset.py - FilterQuery → Query parameters: parses validated values
src/fast_pager/query.py - FilterQuery → Filter AST: builds AST
src/fast_pager/query.py - FilterQuery → Mongo compiler: compiles Mongo query
src/fast_pager/query.py - FilterQuery → SQLAlchemy compiler: applies SQL query
README.md - FilterQuery → Page envelope: paginates collection
src/fast_pager/query.py - Mongo compiler → Compiler contract: implements contract
src/fast_pager/backends/mongo.py - SQLAlchemy compiler → Compiler contract: implements contract
src/fast_pager/backends/sqlalchemy.py - Mongo compiler → Filter AST: compiles AST
src/fast_pager/backends/mongo.py - SQLAlchemy compiler → Filter AST: compiles AST
src/fast_pager/backends/sqlalchemy.py - Route author → Application database: executes compiled query
README.md - FilterQuery → Application database: paginates collection
README.md