Fastapi

This release has **no breaking changes**. 🎉

It upgrades the version ranges of sub-dependencies to allow applications using FastAPI to easily upgrade them.

Soon there will be a new FastAPI release upgrading Starlette to take advantage of recent improvements, but as that has a higher chance of having breaking changes, it will be in a separate release.

Features

* ⬆Increase supported version of aiofiles to suppress warnings. PR [2899](https://github.com/tiangolo/fastapi/pull/2899) by [SnkSynthesis](https://github.com/SnkSynthesis).
* ➖ Do not require backports in Python >= 3.7. PR [1880](https://github.com/tiangolo/fastapi/pull/1880) by [FFY00](https://github.com/FFY00).
* ⬆ Upgrade required Python version to >= 3.6.1, needed by typing.Deque, used by Pydantic. PR [2733](https://github.com/tiangolo/fastapi/pull/2733) by [hukkin](https://github.com/hukkin).
* ⬆️ Bump Uvicorn max range to 0.15.0. PR [3345](https://github.com/tiangolo/fastapi/pull/3345) by [Kludex](https://github.com/Kludex).

Docs

* 📝 Update GraphQL docs, recommend Strawberry. PR [3981](https://github.com/tiangolo/fastapi/pull/3981) by [tiangolo](https://github.com/tiangolo).
* 📝 Re-write and extend Deployment guide: Concepts, Uvicorn, Gunicorn, Docker, Containers, Kubernetes. PR [3974](https://github.com/tiangolo/fastapi/pull/3974) by [tiangolo](https://github.com/tiangolo).
* 📝 Upgrade HTTPS guide with more explanations and diagrams. PR [3950](https://github.com/tiangolo/fastapi/pull/3950) by [tiangolo](https://github.com/tiangolo).

Translations

* 🌐 Add Turkish translation for `docs/features.md`. PR [1950](https://github.com/tiangolo/fastapi/pull/1950) by [ycd](https://github.com/ycd).
* 🌐 Add Turkish translation for `docs/benchmarks.md`. PR [2729](https://github.com/tiangolo/fastapi/pull/2729) by [Telomeraz](https://github.com/Telomeraz).
* 🌐 Add Turkish translation for `docs/index.md`. PR [1908](https://github.com/tiangolo/fastapi/pull/1908) by [ycd](https://github.com/ycd).
* 🌐 Add French translation for `docs/tutorial/body.md`. PR [3671](https://github.com/tiangolo/fastapi/pull/3671) by [Smlep](https://github.com/Smlep).
* 🌐 Add French translation for `deployment/docker.md`. PR [3694](https://github.com/tiangolo/fastapi/pull/3694) by [rjNemo](https://github.com/rjNemo).
* 🌐 Add Portuguese translation for `docs/tutorial/path-params.md`. PR [3664](https://github.com/tiangolo/fastapi/pull/3664) by [FelipeSilva93](https://github.com/FelipeSilva93).
* 🌐 Add Portuguese translation for `docs/deployment/https.md`. PR [3754](https://github.com/tiangolo/fastapi/pull/3754) by [lsglucas](https://github.com/lsglucas).
* 🌐 Add German translation for `docs/features.md`. PR [3699](https://github.com/tiangolo/fastapi/pull/3699) by [mawassk](https://github.com/mawassk).

Internal

* ✨ Update GitHub Action: notify-translations, to avoid a race conditions. PR [3989](https://github.com/tiangolo/fastapi/pull/3989) by [tiangolo](https://github.com/tiangolo).
* ⬆️ Upgrade development `autoflake`, supporting multi-line imports. PR [3988](https://github.com/tiangolo/fastapi/pull/3988) by [tiangolo](https://github.com/tiangolo).
* ⬆️ Increase dependency ranges for tests and docs: pytest-cov, pytest-asyncio, black, httpx, sqlalchemy, databases, mkdocs-markdownextradata-plugin. PR [3987](https://github.com/tiangolo/fastapi/pull/3987) by [tiangolo](https://github.com/tiangolo).
* 👥 Update FastAPI People. PR [3986](https://github.com/tiangolo/fastapi/pull/3986) by [github-actions[bot]](https://github.com/apps/github-actions).
* 💚 Fix badges in README and main page. PR [3979](https://github.com/tiangolo/fastapi/pull/3979) by [ghandic](https://github.com/ghandic).
* ⬆ Upgrade internal testing dependencies: mypy to version 0.910, add newly needed type packages. PR [3350](https://github.com/tiangolo/fastapi/pull/3350) by [ArcLightSlavik](https://github.com/ArcLightSlavik).
* ✨ Add Deepset Sponsorship. PR [3976](https://github.com/tiangolo/fastapi/pull/3976) by [tiangolo](https://github.com/tiangolo).
* 🎨 Tweak CSS styles for shell animations. PR [3888](https://github.com/tiangolo/fastapi/pull/3888) by [tiangolo](https://github.com/tiangolo).
* 🔧 Add new Sponsor Calmcode.io. PR [3777](https://github.com/tiangolo/fastapi/pull/3777) by [tiangolo](https://github.com/tiangolo).

* ✨ Add support for `read_with_orm_mode`, to support [SQLModel](https://sqlmodel.tiangolo.com/) relationship attributes. PR [#3757](https://github.com/tiangolo/fastapi/pull/3757) by [tiangolo](https://github.com/tiangolo).

Translations

* 🌐 Add Portuguese translation of `docs/fastapi-people.md`. PR [3461](https://github.com/tiangolo/fastapi/pull/3461) by [ComicShrimp](https://github.com/ComicShrimp).
* 🌐 Add Chinese translation for `docs/tutorial/dependencies/dependencies-in-path-operation-decorators.md`. PR [3492](https://github.com/tiangolo/fastapi/pull/3492) by [jaystone776](https://github.com/jaystone776).
* 🔧 Add new Translation tracking issues for German and Indonesian. PR [3718](https://github.com/tiangolo/fastapi/pull/3718) by [tiangolo](https://github.com/tiangolo).
* 🌐 Add Chinese translation for `docs/tutorial/dependencies/sub-dependencies.md`. PR [3491](https://github.com/tiangolo/fastapi/pull/3491) by [jaystone776](https://github.com/jaystone776).
* 🌐 Add Portuguese translation for `docs/advanced/index.md`. PR [3460](https://github.com/tiangolo/fastapi/pull/3460) by [ComicShrimp](https://github.com/ComicShrimp).
* 🌐 Portuguese translation of `docs/async.md`. PR [1330](https://github.com/tiangolo/fastapi/pull/1330) by [Serrones](https://github.com/Serrones).
* 🌐 Add French translation for `docs/async.md`. PR [3416](https://github.com/tiangolo/fastapi/pull/3416) by [Smlep](https://github.com/Smlep).

Internal

* ✨ Add GitHub Action: Notify Translations. PR [3715](https://github.com/tiangolo/fastapi/pull/3715) by [tiangolo](https://github.com/tiangolo).
* ✨ Update computation of FastAPI People and sponsors. PR [3714](https://github.com/tiangolo/fastapi/pull/3714) by [tiangolo](https://github.com/tiangolo).
* ✨ Enable recent Material for MkDocs Insiders features. PR [3710](https://github.com/tiangolo/fastapi/pull/3710) by [tiangolo](https://github.com/tiangolo).
* 🔥 Remove/clean extra imports from examples in docs for features. PR [3709](https://github.com/tiangolo/fastapi/pull/3709) by [tiangolo](https://github.com/tiangolo).
* ➕ Update docs library to include sources in Markdown. PR [3648](https://github.com/tiangolo/fastapi/pull/3648) by [tiangolo](https://github.com/tiangolo).
* ⬆ Enable tests for Python 3.9. PR [2298](https://github.com/tiangolo/fastapi/pull/2298) by [Kludex](https://github.com/Kludex).
* 👥 Update FastAPI People. PR [3642](https://github.com/tiangolo/fastapi/pull/3642) by [github-actions[bot]](https://github.com/apps/github-actions).

Features

* ✨ Add support for extensions and updates to the OpenAPI schema in each *path operation*. New docs: [FastAPI Path Operation Advanced Configuration - OpenAPI Extra](https://fastapi.tiangolo.com/advanced/path-operation-advanced-configuration/#openapi-extra). Initial PR [1922](https://github.com/tiangolo/fastapi/pull/1922) by [edouardlp](https://github.com/edouardlp).
* ✨ Add additonal OpenAPI metadata parameters to `FastAPI` class, shown on the automatic API docs UI. New docs: [Metadata and Docs URLs](https://fastapi.tiangolo.com/tutorial/metadata/). Initial PR [#1812](https://github.com/tiangolo/fastapi/pull/1812) by [dkreeft](https://github.com/dkreeft).
* ✨ Add `description` parameter to all the security scheme classes, e.g. `APIKeyQuery(name="key", description="A very cool API key")`. PR [1757](https://github.com/tiangolo/fastapi/pull/1757) by [hylkepostma](https://github.com/hylkepostma).
* ✨ Update OpenAPI models, supporting recursive models and extensions. PR [3628](https://github.com/tiangolo/fastapi/pull/3628) by [tiangolo](https://github.com/tiangolo).
* ✨ Import and re-export data structures from Starlette, used by Request properties, on `fastapi.datastructures`. Initial PR [1872](https://github.com/tiangolo/fastapi/pull/1872) by [jamescurtin](https://github.com/jamescurtin).

Docs

* 📝 Update docs about async and response-model with more gender neutral language. PR [1869](https://github.com/tiangolo/fastapi/pull/1869) by [Edward-Knight](https://github.com/Edward-Knight).

Translations

* 🌐 Add Russian translation for `docs/python-types.md`. PR [3039](https://github.com/tiangolo/fastapi/pull/3039) by [dukkee](https://github.com/dukkee).
* 🌐 Add Chinese translation for `docs/tutorial/dependencies/index.md`. PR [3489](https://github.com/tiangolo/fastapi/pull/3489) by [jaystone776](https://github.com/jaystone776).
* 🌐 Add Russian translation for `docs/external-links.md`. PR [3036](https://github.com/tiangolo/fastapi/pull/3036) by [dukkee](https://github.com/dukkee).
* 🌐 Add Chinese translation for `docs/tutorial/dependencies/global-dependencies.md`. PR [3493](https://github.com/tiangolo/fastapi/pull/3493) by [jaystone776](https://github.com/jaystone776).
* 🌐 Add Portuguese translation for `docs/deployment/versions.md`. PR [3618](https://github.com/tiangolo/fastapi/pull/3618) by [lsglucas](https://github.com/lsglucas).
* 🌐 Add Japanese translation for `docs/tutorial/security/oauth2-jwt.md`. PR [3526](https://github.com/tiangolo/fastapi/pull/3526) by [sattosan](https://github.com/sattosan).

Internal

* ✅ Add the `docs_src` directory to test coverage and update tests. Initial PR [1904](https://github.com/tiangolo/fastapi/pull/1904) by [Kludex](https://github.com/Kludex).
* 🔧 Add new GitHub templates with forms for new issues. PR [3612](https://github.com/tiangolo/fastapi/pull/3612) by [tiangolo](https://github.com/tiangolo).
* 📝 Add official FastAPI Twitter to docs: [fastapi](https://twitter.com/fastapi). PR [#3578](https://github.com/tiangolo/fastapi/pull/3578) by [tiangolo](https://github.com/tiangolo).

Features

* ✨ Add support for `dataclasses` in request bodies and `response_model`. New documentation: [Advanced User Guide - Using Dataclasses](https://fastapi.tiangolo.com/advanced/dataclasses/). PR [#3577](https://github.com/tiangolo/fastapi/pull/3577) by [tiangolo](https://github.com/tiangolo).
* ✨ Support `dataclasses` in responses. PR [3576](https://github.com/tiangolo/fastapi/pull/3576) by [tiangolo](https://github.com/tiangolo), continuation from initial PR [#2722](https://github.com/tiangolo/fastapi/pull/2722) by [amitlissack](https://github.com/amitlissack).

Docs

* 📝 Add external link: How to Create A Fake Certificate Authority And Generate TLS Certs for FastAPI. PR [2839](https://github.com/tiangolo/fastapi/pull/2839) by [aitoehigie](https://github.com/aitoehigie).
* ✏ Fix code highlighted line in: `body-nested-models.md`. PR [3463](https://github.com/tiangolo/fastapi/pull/3463) by [jaystone776](https://github.com/jaystone776).
* ✏ Fix typo in `body-nested-models.md`. PR [3462](https://github.com/tiangolo/fastapi/pull/3462) by [jaystone776](https://github.com/jaystone776).
* ✏ Fix typo "might me" -> "might be" in `docs/en/docs/tutorial/schema-extra-example.md`. PR [3362](https://github.com/tiangolo/fastapi/pull/3362) by [dbrakman](https://github.com/dbrakman).
* 📝 Add external link: Building simple E-Commerce with NuxtJS and FastAPI. PR [3271](https://github.com/tiangolo/fastapi/pull/3271) by [ShahriyarR](https://github.com/ShahriyarR).
* 📝 Add external link: Serve a machine learning model using Sklearn, FastAPI and Docker. PR [2974](https://github.com/tiangolo/fastapi/pull/2974) by [rodrigo-arenas](https://github.com/rodrigo-arenas).
* ✏️ Fix typo on docstring in datastructures file. PR [2887](https://github.com/tiangolo/fastapi/pull/2887) by [Kludex](https://github.com/Kludex).
* 📝 Add External Link: Deploy FastAPI on Ubuntu and Serve using Caddy 2 Web Server. PR [3572](https://github.com/tiangolo/fastapi/pull/3572) by [tiangolo](https://github.com/tiangolo).
* 📝 Add External Link, replaces 1898. PR [3571](https://github.com/tiangolo/fastapi/pull/3571) by [tiangolo](https://github.com/tiangolo).

Internal

* 🎨 Improve style for sponsors, add radius border. PR [2388](https://github.com/tiangolo/fastapi/pull/2388) by [Kludex](https://github.com/Kludex).
* 👷 Update GitHub Action latest-changes. PR [3574](https://github.com/tiangolo/fastapi/pull/3574) by [tiangolo](https://github.com/tiangolo).
* 👷 Update GitHub Action latest-changes. PR [3573](https://github.com/tiangolo/fastapi/pull/3573) by [tiangolo](https://github.com/tiangolo).
* 👷 Rename and clarify CI workflow job names. PR [3570](https://github.com/tiangolo/fastapi/pull/3570) by [tiangolo](https://github.com/tiangolo).
* 👷 Update GitHub Action latest-changes, strike 2 ⚾. PR [3575](https://github.com/tiangolo/fastapi/pull/3575) by [tiangolo](https://github.com/tiangolo).
* 🔧 Sort external links in docs to have the most recent at the top. PR [3568](https://github.com/tiangolo/fastapi/pull/3568) by [tiangolo](https://github.com/tiangolo).

Translations

* 🌐 Add basic setup for German translations. PR [3522](https://github.com/tiangolo/fastapi/pull/3522) by [0x4Dark](https://github.com/0x4Dark).
* 🌐 Add Portuguese translation for `docs/tutorial/security/index.md`. PR [3507](https://github.com/tiangolo/fastapi/pull/3507) by [oandersonmagalhaes](https://github.com/oandersonmagalhaes).
* 🌐 Add Portuguese translation for `docs/deployment/index.md`. PR [3337](https://github.com/tiangolo/fastapi/pull/3337) by [lsglucas](https://github.com/lsglucas).

Internal

* 🔧 Configure strict pytest options and update/refactor tests. Upgrade pytest to `>=6.2.4,<7.0.0` and pytest-cov to `>=2.12.0,<3.0.0`. Initial PR [2790](https://github.com/tiangolo/fastapi/pull/2790) by [graingert](https://github.com/graingert).
* ⬆️ Upgrade python-jose dependency to `>=3.3.0,<4.0.0` for tests. PR [3468](https://github.com/tiangolo/fastapi/pull/3468) by [tiangolo](https://github.com/tiangolo).

Features

* ✨ Allow setting the `response_class` to `RedirectResponse` or `FileResponse` and returning the URL from the function. New and updated docs are in the tutorial section **Custom Response - HTML, Stream, File, others**, in [RedirectResponse](https://fastapi.tiangolo.com/advanced/custom-response/#redirectresponse) and in [FileResponse](https://fastapi.tiangolo.com/advanced/custom-response/#fileresponse). PR [3457](https://github.com/tiangolo/fastapi/pull/3457) by [tiangolo](https://github.com/tiangolo).

Fixes

* 🐛 Fix include/exclude for dicts in `jsonable_encoder`. PR [2016](https://github.com/tiangolo/fastapi/pull/2016) by [Rubikoid](https://github.com/Rubikoid).
* 🐛 Support custom OpenAPI / JSON Schema fields in the generated output OpenAPI. PR [1429](https://github.com/tiangolo/fastapi/pull/1429) by [jmagnusson](https://github.com/jmagnusson).

Translations

* 🌐 Add Spanish translation for `tutorial/query-params.md`. PR [2243](https://github.com/tiangolo/fastapi/pull/2243) by [mariacamilagl](https://github.com/mariacamilagl).
* 🌐 Add Spanish translation for `advanced/response-directly.md`. PR [1253](https://github.com/tiangolo/fastapi/pull/1253) by [jfunez](https://github.com/jfunez).
* 🌐 Add Spanish translation for `advanced/additional-status-codes.md`. PR [1252](https://github.com/tiangolo/fastapi/pull/1252) by [jfunez](https://github.com/jfunez).
* 🌐 Add Spanish translation for `advanced/path-operation-advanced-configuration.md`. PR [1251](https://github.com/tiangolo/fastapi/pull/1251) by [jfunez](https://github.com/jfunez).