fastapi-deferred-init
The Problem
When using nested routers in a FastAPI project its start-up time can get long quite fast. That is because every router re-calculates the routes defined by a nested router when including it and the pre-calculated values by the nested router never get used. In short: values in nested routers are calculated although they will never be used.
The Solution
This library provides a modified APIRoute that defers the calculation of values to the first actual attribute access. A router which uses the route as a default is also provided.
Usage
Older versions of this library worked by simply using custom APIRoute and APIRouter classes, but since FastAPI version 0.137.0 the optimizations require monkey patching to take effect. The following example shows how the patches can be applied by creating an asgi.py file as your entrypoint:
# my_app/asgi.py
from fastapi_deferred_init import apply_patch
# important! don't import anything else before this to make sure the patch works as expected
apply_patch()
# run your app with i.e. gunicorn my_app.asgi:app
from my_app.app import app
# mark app as re-export
__all__ = ["app"]
Caveat
When using the deferred APIRoute on every layer of the app, startup errors are deferred to the first time a route is called. So errors related to route registration might go undetected if the route is not tested at least once.
Pull Request
I created a pull request to merge this change back into FastAPI: https://github.com/tiangolo/fastapi/pull/10589 It was closed since major refactors to FastAPI are underway, but I might re-open it once the maintainers are ready.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file fastapi_deferred_init-0.3.2.tar.gz.
File metadata
- Download URL: fastapi_deferred_init-0.3.2.tar.gz
- Upload date:
- Size: 9.7 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
pdm/2.28.0 CPython/3.10.20 Linux/6.17.0-1020-azure
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
190b469480fac1fb3cfbb9f699e6ed4e20cfad0f5417cf9ab06cec8fd50cc2d7
|
|
| MD5 |
094c5d15487a9935b8bd15ef5c873a76
|
|
| BLAKE2b-256 |
87610d43764931a2b9a6695b33c6c7c8b8597b935497b7fdf80a8111200aa852
|
File details
Details for the file fastapi_deferred_init-0.3.2-py3-none-any.whl.
File metadata
- Download URL: fastapi_deferred_init-0.3.2-py3-none-any.whl
- Upload date:
- Size: 7.0 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
pdm/2.28.0 CPython/3.10.20 Linux/6.17.0-1020-azure
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
e45632d1980df68b9f24bf8a93c3698afcc9e1d09d28fcfcb888ed92da9cfdf5
|
|
| MD5 |
37aa8df8535fa6c851e8a1d516a0a018
|
|
| BLAKE2b-256 |
daccc6259e4bfe31402735c2962328a128f20c829b7e252410691a42c9543b91
|
