Fastapi

Features

* ✨ Add support for declaring `UploadFile` parameters without explicit `File()`. PR [4469](https://github.com/tiangolo/fastapi/pull/4469) by [tiangolo](https://github.com/tiangolo). New docs: [Request Files - File Parameters with UploadFile](https://fastapi.tiangolo.com/tutorial/request-files/#file-parameters-with-uploadfile).
* ✨ Add support for tags with Enums. PR [4468](https://github.com/tiangolo/fastapi/pull/4468) by [tiangolo](https://github.com/tiangolo). New docs: [Path Operation Configuration - Tags with Enums](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/#tags-with-enums).
* ✨ Allow hiding from OpenAPI (and Swagger UI) `Query`, `Cookie`, `Header`, and `Path` parameters. PR [3144](https://github.com/tiangolo/fastapi/pull/3144) by [astraldawn](https://github.com/astraldawn). New docs: [Query Parameters and String Validations - Exclude from OpenAPI](https://fastapi.tiangolo.com/tutorial/query-params-str-validations/#exclude-from-openapi).

Docs

* 📝 Tweak and improve docs for Request Files. PR [4470](https://github.com/tiangolo/fastapi/pull/4470) by [tiangolo](https://github.com/tiangolo).

Fixes

* 🐛 Fix bug preventing to use OpenAPI when using tuples. PR [3874](https://github.com/tiangolo/fastapi/pull/3874) by [victorbenichoux](https://github.com/victorbenichoux).
* 🐛 Prefer custom encoder over defaults if specified in `jsonable_encoder`. PR [2061](https://github.com/tiangolo/fastapi/pull/2061) by [viveksunder](https://github.com/viveksunder).
* 💚 Duplicate PR to trigger CI. PR [4467](https://github.com/tiangolo/fastapi/pull/4467) by [tiangolo](https://github.com/tiangolo).

Internal

* 🐛 Fix docs dependencies cache, to get the latest Material for MkDocs. PR [4466](https://github.com/tiangolo/fastapi/pull/4466) by [tiangolo](https://github.com/tiangolo).
* 🔧 Add sponsor Dropbase. PR [4465](https://github.com/tiangolo/fastapi/pull/4465) by [tiangolo](https://github.com/tiangolo).

Features

* ✨ Enable configuring Swagger UI parameters. Original PR [2568](https://github.com/tiangolo/fastapi/pull/2568) by [jmriebold](https://github.com/jmriebold). Here are the new docs: [Configuring Swagger UI](https://fastapi.tiangolo.com/advanced/extending-openapi/#configuring-swagger-ui).

Docs

* 📝 Update Python Types docs, add missing 3.6 / 3.9 example. PR [4434](https://github.com/tiangolo/fastapi/pull/4434) by [tiangolo](https://github.com/tiangolo).

Translations

* 🌐 Update Chinese translation for `docs/help-fastapi.md`. PR [3847](https://github.com/tiangolo/fastapi/pull/3847) by [jaystone776](https://github.com/jaystone776).
* 🌐 Fix Korean translation for `docs/ko/docs/index.md`. PR [4195](https://github.com/tiangolo/fastapi/pull/4195) by [kty4119](https://github.com/kty4119).
* 🌐 Add Polish translation for `docs/pl/docs/index.md`. PR [4245](https://github.com/tiangolo/fastapi/pull/4245) by [MicroPanda123](https://github.com/MicroPanda123).
* 🌐 Add Chinese translation for `docs\tutorial\path-operation-configuration.md`. PR [3312](https://github.com/tiangolo/fastapi/pull/3312) by [jaystone776](https://github.com/jaystone776).

Internal

* 🔧 Enable MkDocs Material Insiders' `content.tabs.link`. PR [4399](https://github.com/tiangolo/fastapi/pull/4399) by [tiangolo](https://github.com/tiangolo).

Features

* ✨ Add docs and tests for Python 3.9 and Python 3.10. PR [3712](https://github.com/tiangolo/fastapi/pull/3712) by [tiangolo](https://github.com/tiangolo).
* You can start with [Python Types Intro](https://fastapi.tiangolo.com/python-types/), it explains what changes between different Python versions, in Python 3.9 and in Python 3.10.
* All the FastAPI docs are updated. Each code example in the docs that could use different syntax in Python 3.9 or Python 3.10 now has all the alternatives in tabs.
* ⬆️ Upgrade Starlette to 0.17.1. PR [4145](https://github.com/tiangolo/fastapi/pull/4145) by [simondale00](https://github.com/simondale00).

Internal

* 👥 Update FastAPI People. PR [4354](https://github.com/tiangolo/fastapi/pull/4354) by [github-actions[bot]](https://github.com/apps/github-actions).
* 🔧 Add FastAPI Trove Classifier for PyPI as now there's one 🤷😁. PR [4386](https://github.com/tiangolo/fastapi/pull/4386) by [tiangolo](https://github.com/tiangolo).
* ⬆ Upgrade MkDocs Material and configs. PR [4385](https://github.com/tiangolo/fastapi/pull/4385) by [tiangolo](https://github.com/tiangolo).

There's nothing interesting in this particular FastAPI release. It is mainly to enable/unblock the release of the next version of Pydantic that comes packed with features and improvements. 🤩

Fixes

* 🐛 Fix JSON Schema for dataclasses, supporting the fixes in Pydantic 1.9. PR [4272](https://github.com/tiangolo/fastapi/pull/4272) by [PrettyWood](https://github.com/PrettyWood).

Translations

* 🌐 Add Korean translation for `docs/tutorial/request-forms-and-files.md`. PR [3744](https://github.com/tiangolo/fastapi/pull/3744) by [NinaHwang](https://github.com/NinaHwang).
* 🌐 Add Korean translation for `docs/tutorial/request-files.md`. PR [3743](https://github.com/tiangolo/fastapi/pull/3743) by [NinaHwang](https://github.com/NinaHwang).
* 🌐 Add portuguese translation for `docs/tutorial/query-params-str-validations.md`. PR [3965](https://github.com/tiangolo/fastapi/pull/3965) by [leandrodesouzadev](https://github.com/leandrodesouzadev).
* 🌐 Add Korean translation for `docs/tutorial/response-status-code.md`. PR [3742](https://github.com/tiangolo/fastapi/pull/3742) by [NinaHwang](https://github.com/NinaHwang).
* 🌐 Add Korean translation for Tutorial - JSON Compatible Encoder. PR [3152](https://github.com/tiangolo/fastapi/pull/3152) by [NEONKID](https://github.com/NEONKID).
* 🌐 Add Korean translation for Tutorial - Path Parameters and Numeric Validations. PR [2432](https://github.com/tiangolo/fastapi/pull/2432) by [hard-coders](https://github.com/hard-coders).
* 🌐 Add Korean translation for `docs/ko/docs/deployment/versions.md`. PR [4121](https://github.com/tiangolo/fastapi/pull/4121) by [DevDae](https://github.com/DevDae).
* 🌐 Fix Korean translation for `docs/ko/docs/tutorial/index.md`. PR [4193](https://github.com/tiangolo/fastapi/pull/4193) by [kimjaeyoonn](https://github.com/kimjaeyoonn).
* 🔧 Add CryptAPI sponsor. PR [4264](https://github.com/tiangolo/fastapi/pull/4264) by [tiangolo](https://github.com/tiangolo).
* 📝 Update `docs/tutorial/dependencies/classes-as-dependencies`: Add type of query parameters in a description of `Classes as dependencies`. PR [4015](https://github.com/tiangolo/fastapi/pull/4015) by [0417taehyun](https://github.com/0417taehyun).
* 🌐 Add French translation for Tutorial - First steps. PR [3455](https://github.com/tiangolo/fastapi/pull/3455) by [Smlep](https://github.com/Smlep).
* 🌐 Add French translation for `docs/tutorial/path-params.md`. PR [3548](https://github.com/tiangolo/fastapi/pull/3548) by [Smlep](https://github.com/Smlep).
* 🌐 Add French translation for `docs/tutorial/query-params.md`. PR [3556](https://github.com/tiangolo/fastapi/pull/3556) by [Smlep](https://github.com/Smlep).
* 🌐 Add Turkish translation for `docs/python-types.md`. PR [3926](https://github.com/tiangolo/fastapi/pull/3926) by [BilalAlpaslan](https://github.com/BilalAlpaslan).

Internal

* 👥 Update FastAPI People. PR [4274](https://github.com/tiangolo/fastapi/pull/4274) by [github-actions[bot]](https://github.com/apps/github-actions).

This release just upgrades Starlette to the latest version, `0.16.0`, which includes several bug fixes and some small breaking changes.

These last **three consecutive releases** are independent so that you can **migrate gradually**:

* First to FastAPI `0.68.2`, with no breaking changes, but upgrading all the sub-dependencies.
* Next to FastAPI `0.69.0`, which upgrades Starlette to `0.15.0`, with AnyIO support, and a higher chance of having breaking changes in your code.
* Finally to FastAPI `0.70.0`, just upgrading Starlette to the latest version `0.16.0` with additional bug fixes.

This way, in case there was a breaking change for your code in one of the releases, you can still benefit from the previous upgrades. ✨

Breaking Changes - Upgrade

* ⬆️ Upgrade Starlette to 0.16.0. PR [4016](https://github.com/tiangolo/fastapi/pull/4016) by [tiangolo](https://github.com/tiangolo).

Also upgrades the ranges of optional dependencies:

* `"jinja2 >=2.11.2,<4.0.0"`
* `"itsdangerous >=1.1.0,<3.0.0"`

Breaking Changes - Upgrade

This release adds support for [Trio](https://trio.readthedocs.io/en/stable/). ✨

It upgrades the version of Starlette to `0.15.0`, now based on [AnyIO](https://anyio.readthedocs.io/en/stable/), and the internal async components in **FastAPI** are now based on AnyIO as well, making it compatible with both **asyncio** and **Trio**.

You can read the docs about running [FastAPI with Trio using Hypercorn](https://fastapi.tiangolo.com/deployment/manually/#hypercorn-with-trio).

This release also removes `graphene` as an optional dependency for GraphQL. If you need to work with GraphQL, the recommended library now is [Strawberry](https://strawberry.rocks/). You can read the new [FastAPI with GraphQL docs](https://fastapi.tiangolo.com/advanced/graphql/).

Features

* ✨ Add support for Trio via AnyIO, upgrading Starlette to `0.15.0`. PR [3372](https://github.com/tiangolo/fastapi/pull/3372) by [graingert](https://github.com/graingert).
* ➖ Remove `graphene` as an optional dependency. PR [4007](https://github.com/tiangolo/fastapi/pull/4007) by [tiangolo](https://github.com/tiangolo).

Docs

* 📝 Add docs for using Trio with Hypercorn. PR [4014](https://github.com/tiangolo/fastapi/pull/4014) by [tiangolo](https://github.com/tiangolo).
* ✏ Fix typos in Deployment Guide. PR [3975](https://github.com/tiangolo/fastapi/pull/3975) by [ghandic](https://github.com/ghandic).
* 📝 Update docs with pip install calls when using extras with brackets, use quotes for compatibility with Zsh. PR [3131](https://github.com/tiangolo/fastapi/pull/3131) by [tomwei7](https://github.com/tomwei7).
* 📝 Add external link to article: Deploying ML Models as API Using FastAPI and Heroku. PR [3904](https://github.com/tiangolo/fastapi/pull/3904) by [kaustubhgupta](https://github.com/kaustubhgupta).
* ✏ Fix typo in file paths in `docs/en/docs/contributing.md`. PR [3752](https://github.com/tiangolo/fastapi/pull/3752) by [NinaHwang](https://github.com/NinaHwang).
* ✏ Fix a typo in `docs/en/docs/advanced/path-operation-advanced-configuration.md` and `docs/en/docs/release-notes.md`. PR [3750](https://github.com/tiangolo/fastapi/pull/3750) by [saintmalik](https://github.com/saintmalik).
* ✏️ Add a missing comma in the security tutorial. PR [3564](https://github.com/tiangolo/fastapi/pull/3564) by [jalvaradosegura](https://github.com/jalvaradosegura).
* ✏ Fix typo in `docs/en/docs/help-fastapi.md`. PR [3760](https://github.com/tiangolo/fastapi/pull/3760) by [jaystone776](https://github.com/jaystone776).
* ✏ Fix typo about file path in `docs/en/docs/tutorial/bigger-applications.md`. PR [3285](https://github.com/tiangolo/fastapi/pull/3285) by [HolyDorus](https://github.com/HolyDorus).
* ✏ Re-word to clarify test client in `docs/en/docs/tutorial/testing.md`. PR [3382](https://github.com/tiangolo/fastapi/pull/3382) by [Bharat123rox](https://github.com/Bharat123rox).
* 📝 Fix incorrect highlighted code. PR [3325](https://github.com/tiangolo/fastapi/pull/3325) by [paxcodes](https://github.com/paxcodes).
* 📝 Add external link to article: How-to deploy FastAPI app to Heroku. PR [3241](https://github.com/tiangolo/fastapi/pull/3241) by [Jarmos-san](https://github.com/Jarmos-san).
* ✏ Fix typo (mistranslation) in `docs/en/docs/advanced/templates.md`. PR [3211](https://github.com/tiangolo/fastapi/pull/3211) by [oerpli](https://github.com/oerpli).
* 📝 Remove note about (now supported) feature from Swagger UI in `docs/en/docs/tutorial/request-files.md`. PR [2803](https://github.com/tiangolo/fastapi/pull/2803) by [gsganden](https://github.com/gsganden).
* ✏ Fix typo re-word in `docs/tutorial/handling-errors.md`. PR [2700](https://github.com/tiangolo/fastapi/pull/2700) by [graue70](https://github.com/graue70).

Translations

* 🌐 Initialize Azerbaijani translations. PR [3941](https://github.com/tiangolo/fastapi/pull/3941) by [madatbay](https://github.com/madatbay).
* 🌐 Add Turkish translation for `docs/fastapi-people.md`. PR [3848](https://github.com/tiangolo/fastapi/pull/3848) by [BilalAlpaslan](https://github.com/BilalAlpaslan).

Internal

* 📝 Add supported Python versions badge. PR [2794](https://github.com/tiangolo/fastapi/pull/2794) by [hramezani](https://github.com/hramezani).
* ✏ Fix link in Japanese docs for `docs/ja/docs/deployment/docker.md`. PR [3245](https://github.com/tiangolo/fastapi/pull/3245) by [utamori](https://github.com/utamori).
* 🔧 Correct DeprecationWarning config and comment in pytest settings. PR [4008](https://github.com/tiangolo/fastapi/pull/4008) by [graingert](https://github.com/graingert).
* 🔧 Swap light/dark theme button icon. PR [3246](https://github.com/tiangolo/fastapi/pull/3246) by [eddsalkield](https://github.com/eddsalkield).
* 🔧 Lint only in Python 3.7 and above. PR [4006](https://github.com/tiangolo/fastapi/pull/4006) by [tiangolo](https://github.com/tiangolo).
* 🔧 Add GitHub Action notify-translations config for Azerbaijani. PR [3995](https://github.com/tiangolo/fastapi/pull/3995) by [tiangolo](https://github.com/tiangolo).