[pull] master from tiangolo:master

[pull]

See Commits and Changes for more details.

---

Created by pull[bot] (v2.0.0-alpha.4)

Can you help keep this open source service alive? 💖 Please sponsor : )

[kritsada1998mtcn-ctrl]

Release Notes

Latest Changes

0.71.0

Features

• ✨ Add docs and tests for Python 3.9 and Python 3.10. PR #3712 by @tiangolo.
  • You can start with Python Types Intro, 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 by @simondale00.

Internal

• 👥 Update FastAPI People. PR #4354 by @github-actions[bot].
• 🔧 Add FastAPI Trove Classifier for PyPI as now there's one 🤷😁. PR #4386 by @tiangolo.
• ⬆ Upgrade MkDocs Material and configs. PR #4385 by @tiangolo.

0.70.1

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 by @PrettyWood.

Translations

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

Internal

• 👥 Update FastAPI People. PR #4274 by @github-actions[bot].

0.70.0

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 by @tiangolo.

Also upgrades the ranges of optional dependencies:

• "jinja2 >=2.11.2,<4.0.0"
• "itsdangerous >=1.1.0,<3.0.0"

0.69.0

Breaking Changes - Upgrade

This release adds support for Trio. ✨

It upgrades the version of Starlette to 0.15.0, now based on AnyIO, 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.

This release also removes graphene as an optional dependency for GraphQL. If you need to work with GraphQL, the recommended library now is Strawberry. You can read the new FastAPI with GraphQL docs.

Features

• ✨ Add support for Trio via AnyIO, upgrading Starlette to 0.15.0. PR #3372 by @graingert.
• ➖ Remove graphene as an optional dependency. PR #4007 by @tiangolo.

Docs

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

Translations

• 🌐 Initialize Azerbaijani translations. PR #3941 by @madatbay.
• 🌐 Add Turkish translation for docs/fastapi-people.md. PR #3848 by @BilalAlpaslan.

Internal

• 📝 Add supported Python versions badge. PR #2794 by @hramezani.
• ✏ Fix link in Japanese docs for docs/ja/docs/deployment/docker.md. PR #3245 by @utamori.
• 🔧 Correct DeprecationWarning config and comment in pytest settings. PR #4008 by @graingert.
• 🔧 Swap light/dark theme button icon. PR #3246 by @eddsalkield.
• 🔧 Lint only in Python 3.7 and above. PR #4006 by @tiangolo.
• 🔧 Add GitHub Action notify-translations config for Azerbaijani. PR #3995 by @tiangolo.

0.68.2

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 by @SnkSynthesis.
• ➖ Do not require backports in Python >= 3.7. PR #1880 by @FFY00.
• ⬆ Upgrade required Python version to >= 3.6.1, needed by typing.Deque, used by Pydantic. PR #2733 by @hukkin.
• ⬆️ Bump Uvicorn max range to 0.15.0. PR #3345 by @Kludex.

Docs

• 📝 Update GraphQL docs, recommend Strawberry. PR #3981 by @tiangolo.
• 📝 Re-write and extend Deployment guide: Concepts, Uvicorn, Gunicorn, Docker, Containers, Kubernetes. PR #3974 by @tiangolo.
• 📝 Upgrade HTTPS guide with more explanations and diagrams. PR #3950 by @tiangolo.

Translations

• 🌐 Add Turkish translation for docs/features.md. PR #1950 by @ycd.
• 🌐 Add Turkish translation for docs/benchmarks.md. PR #2729 by @Telomeraz.
• 🌐 Add Turkish translation for docs/index.md. PR #1908 by @ycd.
• 🌐 Add French translation for docs/tutorial/body.md. PR #3671 by @Smlep.
• 🌐 Add French translation for deployment/docker.md. PR #3694 by @rjNemo.
• 🌐 Add Portuguese translation for docs/tutorial/path-params.md. PR #3664 by @FelipeSilva93.
• 🌐 Add Portuguese translation for docs/deployment/https.md. PR #3754 by @lsglucas.
• 🌐 Add German translation for docs/features.md. PR #3699 by @mawassk.

Internal

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

0.68.1

• ✨ Add support for read_with_orm_mode, to support SQLModel relationship attributes. PR #3757 by @tiangolo.

Translations

• 🌐 Add Portuguese translation of docs/fastapi-people.md. PR #3461 by @ComicShrimp.
• 🌐 Add Chinese translation for docs/tutorial/dependencies/dependencies-in-path-operation-decorators.md. PR #3492 by @jaystone776.
• 🔧 Add new Translation tracking issues for German and Indonesian. PR #3718 by @tiangolo.
• 🌐 Add Chinese translation for docs/tutorial/dependencies/sub-dependencies.md. PR #3491 by @jaystone776.
• 🌐 Add Portuguese translation for docs/advanced/index.md. PR #3460 by @ComicShrimp.
• 🌐 Portuguese translation of docs/async.md. PR #1330 by @Serrones.
• 🌐 Add French translation for docs/async.md. PR #3416 by @Smlep.

Internal

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

0.68.0

Features

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

Docs

• 📝 Update docs about async and response-model with more gender neutral language. PR #1869 by @Edward-Knight.

Translations

• 🌐 Add Russian translation for docs/python-types.md. PR #3039 by @dukkee.
• 🌐 Add Chinese translation for docs/tutorial/dependencies/index.md. PR #3489 by @jaystone776.
• 🌐 Add Russian translation for docs/external-links.md. PR #3036 by @dukkee.
• 🌐 Add Chinese translation for docs/tutorial/dependencies/global-dependencies.md. PR #3493 by @jaystone776.
• 🌐 Add Portuguese translation for docs/deployment/versions.md. PR #3618 by @lsglucas.
• 🌐 Add Japanese translation for docs/tutorial/security/oauth2-jwt.md. PR #3526 by @sattosan.

Internal

• ✅ Add the docs_src directory to