Merge branch 'master' into fix_reallow_abitrary_types

.pre-commit-config.yaml

@@ -14,7 +14,7 @@ repos:
     -   id: end-of-file-fixer
     -   id: trailing-whitespace
 -   repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: v0.11.13
+    rev: v0.12.1
     hooks:
     -   id: ruff
         args:

README.md

@@ -470,15 +470,20 @@ Used by Starlette:
 * <a href="https://jinja.palletsprojects.com" target="_blank"><code>jinja2</code></a> - Required if you want to use the default template configuration.
 * <a href="https://github.com/Kludex/python-multipart" target="_blank"><code>python-multipart</code></a> - Required if you want to support form <abbr title="converting the string that comes from an HTTP request into Python data">"parsing"</abbr>, with `request.form()`.
 
-Used by FastAPI / Starlette:
+Used by FastAPI:
 
 * <a href="https://www.uvicorn.org" target="_blank"><code>uvicorn</code></a> - for the server that loads and serves your application. This includes `uvicorn[standard]`, which includes some dependencies (e.g. `uvloop`) needed for high performance serving.
-* `fastapi-cli` - to provide the `fastapi` command.
+* `fastapi-cli[standard]` - to provide the `fastapi` command.
+    * This includes `fastapi-cloud-cli`, which allows you to deploy your FastAPI application to <a href="https://fastapicloud.com" class="external-link" target="_blank">FastAPI Cloud</a>.
 
 ### Without `standard` Dependencies
 
 If you don't want to include the `standard` optional dependencies, you can install with `pip install fastapi` instead of `pip install "fastapi[standard]"`.
 
+### Without `fastapi-cloud-cli`
+
+If you want to install FastAPI with the standard dependencies but without the `fastapi-cloud-cli`, you can install with `pip install "fastapi[standard-no-fastapi-cloud-cli]"`.
+
 ### Additional Optional Dependencies
 
 There are some additional dependencies you might want to install.

docs/en/data/contributors.yml

@@ -1,11 +1,11 @@
 tiangolo:
   login: tiangolo
-  count: 747
+  count: 753
   avatarUrl: https://avatars.githubusercontent.com/u/1326112?u=cb5d06e73a9e1998141b1641aa88e443c6717651&v=4
   url: https://github.com/tiangolo
 dependabot:
   login: dependabot
-  count: 102
+  count: 104
   avatarUrl: https://avatars.githubusercontent.com/in/29110?v=4
   url: https://github.com/apps/dependabot
 alejsdev:
@@ -15,7 +15,7 @@ alejsdev:
   url: https://github.com/alejsdev
 pre-commit-ci:
   login: pre-commit-ci
-  count: 30
+  count: 33
   avatarUrl: https://avatars.githubusercontent.com/in/68672?v=4
   url: https://github.com/apps/pre-commit-ci
 github-actions:
@@ -116,7 +116,7 @@ hitrust:
 ShahriyarR:
   login: ShahriyarR
   count: 4
-  avatarUrl: https://avatars.githubusercontent.com/u/3852029?u=c9a1691e5ebdc94cbf543086099a6ed705cdb873&v=4
+  avatarUrl: https://avatars.githubusercontent.com/u/3852029?u=631b2ae59360ab380c524b32bc3d245aff1165af&v=4
   url: https://github.com/ShahriyarR
 adriangb:
   login: adriangb
@@ -513,6 +513,11 @@ tamird:
   count: 2
   avatarUrl: https://avatars.githubusercontent.com/u/1535036?v=4
   url: https://github.com/tamird
+ndimares:
+  login: ndimares
+  count: 2
+  avatarUrl: https://avatars.githubusercontent.com/u/6267663?u=cfb27efde7a7212be8142abb6c058a1aeadb41b1&v=4
+  url: https://github.com/ndimares
 rabinlamadong:
   login: rabinlamadong
   count: 2
@@ -538,8 +543,18 @@ DanielYang59:
   count: 2
   avatarUrl: https://avatars.githubusercontent.com/u/80093591?u=63873f701c7c74aac83c906800a1dddc0bc8c92f&v=4
   url: https://github.com/DanielYang59
+valentinDruzhinin:
+  login: valentinDruzhinin
+  count: 2
+  avatarUrl: https://avatars.githubusercontent.com/u/12831905?u=aae1ebc675c91e8fa582df4fcc4fc4128106344d&v=4
+  url: https://github.com/valentinDruzhinin
 blueswen:
   login: blueswen
   count: 2
   avatarUrl: https://avatars.githubusercontent.com/u/1564148?u=6d6b8cc8f2b5cef715e68d6175154a8a94d518ee&v=4
   url: https://github.com/blueswen
+YuriiMotov:
+  login: YuriiMotov
+  count: 2
+  avatarUrl: https://avatars.githubusercontent.com/u/109919500?u=e83a39697a2d33ab2ec9bfbced794ee48bc29cec&v=4
+  url: https://github.com/YuriiMotov

docs/en/data/github_sponsors.yml

@@ -1,10 +1,10 @@
 sponsors:
+- - login: classmethod
+    avatarUrl: https://avatars.githubusercontent.com/u/1532151?v=4
+    url: https://github.com/classmethod
 - - login: renderinc
     avatarUrl: https://avatars.githubusercontent.com/u/36424661?v=4
     url: https://github.com/renderinc
-  - login: Nixtla
-    avatarUrl: https://avatars.githubusercontent.com/u/79945230?v=4
-    url: https://github.com/Nixtla
   - login: andrew-propelauth
     avatarUrl: https://avatars.githubusercontent.com/u/89474256?u=c98993dec8553c09d424ede67bbe86e5c35f48c9&v=4
     url: https://github.com/andrew-propelauth
@@ -17,12 +17,15 @@ sponsors:
   - login: coderabbitai
     avatarUrl: https://avatars.githubusercontent.com/u/132028505?v=4
     url: https://github.com/coderabbitai
+  - login: madisonredtfeldt
+    avatarUrl: https://avatars.githubusercontent.com/u/152656511?v=4
+    url: https://github.com/madisonredtfeldt
   - login: subtotal
     avatarUrl: https://avatars.githubusercontent.com/u/176449348?v=4
     url: https://github.com/subtotal
-  - login: porter-dev
+  - login: Nixtla
-    avatarUrl: https://avatars.githubusercontent.com/u/62078005?v=4
+    avatarUrl: https://avatars.githubusercontent.com/u/79945230?v=4
-    url: https://github.com/porter-dev
+    url: https://github.com/Nixtla
   - login: scalar
     avatarUrl: https://avatars.githubusercontent.com/u/301879?v=4
     url: https://github.com/scalar
@@ -41,27 +44,27 @@ sponsors:
   - login: speakeasy-api
     avatarUrl: https://avatars.githubusercontent.com/u/91446104?v=4
     url: https://github.com/speakeasy-api
-  - login: snapit-cypher
-    avatarUrl: https://avatars.githubusercontent.com/u/115662654?v=4
-    url: https://github.com/snapit-cypher
   - login: databento
     avatarUrl: https://avatars.githubusercontent.com/u/64141749?v=4
     url: https://github.com/databento
   - login: permitio
     avatarUrl: https://avatars.githubusercontent.com/u/71775833?v=4
     url: https://github.com/permitio
-- - login: mercedes-benz
+- - login: xoflare
-    avatarUrl: https://avatars.githubusercontent.com/u/34240465?v=4
-    url: https://github.com/mercedes-benz
-  - login: xoflare
     avatarUrl: https://avatars.githubusercontent.com/u/74335107?v=4
     url: https://github.com/xoflare
   - login: marvin-robot
     avatarUrl: https://avatars.githubusercontent.com/u/41086007?u=b9fcab402d0cd0aec738b6574fe60855cb0cd36d&v=4
     url: https://github.com/marvin-robot
+  - login: mercedes-benz
+    avatarUrl: https://avatars.githubusercontent.com/u/34240465?v=4
+    url: https://github.com/mercedes-benz
   - login: Ponte-Energy-Partners
     avatarUrl: https://avatars.githubusercontent.com/u/114745848?v=4
     url: https://github.com/Ponte-Energy-Partners
+  - login: snapit-cypher
+    avatarUrl: https://avatars.githubusercontent.com/u/115662654?v=4
+    url: https://github.com/snapit-cypher
   - login: LambdaTest-Inc
     avatarUrl: https://avatars.githubusercontent.com/u/171592363?u=96606606a45fa170427206199014f2a5a2a4920b&v=4
     url: https://github.com/LambdaTest-Inc
@@ -98,15 +101,21 @@ sponsors:
 - - login: samuelcolvin
     avatarUrl: https://avatars.githubusercontent.com/u/4039449?u=42eb3b833047c8c4b4f647a031eaef148c16d93f&v=4
     url: https://github.com/samuelcolvin
+  - login: CoodingPenguin
+    avatarUrl: https://avatars.githubusercontent.com/u/37505775?u=6a9e1f6647fbf95f99afeee82a3682e15fc6e959&v=4
+    url: https://github.com/CoodingPenguin
+  - login: deight93
+    avatarUrl: https://avatars.githubusercontent.com/u/37678115?u=a608798b5bd0034183a9c430ebb42fb266db86ce&v=4
+    url: https://github.com/deight93
   - login: otosky
     avatarUrl: https://avatars.githubusercontent.com/u/42260747?u=69d089387c743d89427aa4ad8740cfb34045a9e0&v=4
     url: https://github.com/otosky
   - login: ramonalmeidam
     avatarUrl: https://avatars.githubusercontent.com/u/45269580?u=3358750b3a5854d7c3ed77aaca7dd20a0f529d32&v=4
     url: https://github.com/ramonalmeidam
-  - login: ashi-agrawal
+  - login: kaoru0310
-    avatarUrl: https://avatars.githubusercontent.com/u/17105294?u=99c7a854035e5398d8e7b674f2d42baae6c957f8&v=4
+    avatarUrl: https://avatars.githubusercontent.com/u/80977929?u=1b61d10142b490e56af932ddf08a390fae8ee94f&v=4
-    url: https://github.com/ashi-agrawal
+    url: https://github.com/kaoru0310
   - login: RaamEEIL
     avatarUrl: https://avatars.githubusercontent.com/u/20320552?v=4
     url: https://github.com/RaamEEIL
@@ -125,9 +134,6 @@ sponsors:
   - login: ProteinQure
     avatarUrl: https://avatars.githubusercontent.com/u/33707203?v=4
     url: https://github.com/ProteinQure
-  - login: kaoru0310
-    avatarUrl: https://avatars.githubusercontent.com/u/80977929?u=1b61d10142b490e56af932ddf08a390fae8ee94f&v=4
-    url: https://github.com/kaoru0310
   - login: DelfinaCare
     avatarUrl: https://avatars.githubusercontent.com/u/83734439?v=4
     url: https://github.com/DelfinaCare
@@ -191,9 +197,6 @@ sponsors:
   - login: gorhack
     avatarUrl: https://avatars.githubusercontent.com/u/4141690?u=ec119ebc4bdf00a7bc84657a71aa17834f4f27f3&v=4
     url: https://github.com/gorhack
-  - login: Ryandaydev
-    avatarUrl: https://avatars.githubusercontent.com/u/4292423?u=679ff84cb7b988c5795a5fa583857f574a055763&v=4
-    url: https://github.com/Ryandaydev
   - login: vincentkoc
     avatarUrl: https://avatars.githubusercontent.com/u/25068?u=fbd5b2d51142daa4bdbc21e21953a3b8b8188a4a&v=4
     url: https://github.com/vincentkoc
@@ -227,15 +230,9 @@ sponsors:
   - login: mintuhouse
     avatarUrl: https://avatars.githubusercontent.com/u/769950?u=ecfbd79a97d33177e0d093ddb088283cf7fe8444&v=4
     url: https://github.com/mintuhouse
-  - login: TrevorBenson
-    avatarUrl: https://avatars.githubusercontent.com/u/9167887?u=dccbea3327a57750923333d8ebf1a0b3f1948949&v=4
-    url: https://github.com/TrevorBenson
   - login: wdwinslow
-    avatarUrl: https://avatars.githubusercontent.com/u/11562137?u=dc01daafb354135603a263729e3d26d939c0c452&v=4
+    avatarUrl: https://avatars.githubusercontent.com/u/11562137?u=371272f2c69e680e0559a7b0a57385e83a5dc728&v=4
     url: https://github.com/wdwinslow
-  - login: catherinenelson1
-    avatarUrl: https://avatars.githubusercontent.com/u/11951946?u=fe11bc35d36b6038cd46a946e4e46ef8aa5688ab&v=4
-    url: https://github.com/catherinenelson1
   - login: jsoques
     avatarUrl: https://avatars.githubusercontent.com/u/12414216?u=620921d94196546cc8b9eae2cc4cbc3f95bab42f&v=4
     url: https://github.com/jsoques
@@ -251,6 +248,12 @@ sponsors:
   - login: mjohnsey
     avatarUrl: https://avatars.githubusercontent.com/u/16784016?u=38fad2e6b411244560b3af99c5f5a4751bc81865&v=4
     url: https://github.com/mjohnsey
+  - login: ashi-agrawal
+    avatarUrl: https://avatars.githubusercontent.com/u/17105294?u=99c7a854035e5398d8e7b674f2d42baae6c957f8&v=4
+    url: https://github.com/ashi-agrawal
+  - login: Ryandaydev
+    avatarUrl: https://avatars.githubusercontent.com/u/4292423?u=679ff84cb7b988c5795a5fa583857f574a055763&v=4
+    url: https://github.com/Ryandaydev
   - login: jaredtrog
     avatarUrl: https://avatars.githubusercontent.com/u/4381365?v=4
     url: https://github.com/jaredtrog
@@ -278,9 +281,6 @@ sponsors:
 - - login: pawamoy
     avatarUrl: https://avatars.githubusercontent.com/u/3999221?u=b030e4c89df2f3a36bc4710b925bdeb6745c9856&v=4
     url: https://github.com/pawamoy
-  - login: bnkc
-    avatarUrl: https://avatars.githubusercontent.com/u/34930566?u=db5e6f4f87836cad26c2aa90ce390ce49041c5a9&v=4
-    url: https://github.com/bnkc
   - login: petercool
     avatarUrl: https://avatars.githubusercontent.com/u/37613029?u=81c525232bb35780945a68e88afd96bb2cdad9c4&v=4
     url: https://github.com/petercool
@@ -296,12 +296,6 @@ sponsors:
   - login: caviri
     avatarUrl: https://avatars.githubusercontent.com/u/45425937?u=4e14bd64282bad8f385eafbdb004b5a279366d6e&v=4
     url: https://github.com/caviri
-  - login: hgalytoby
-    avatarUrl: https://avatars.githubusercontent.com/u/50397689?u=62c7ff3519858423579676cd0efbd7e3f1ffe63a&v=4
-    url: https://github.com/hgalytoby
-  - login: browniebroke
-    avatarUrl: https://avatars.githubusercontent.com/u/861044?u=5abfca5588f3e906b31583d7ee62f6de4b68aa24&v=4
-    url: https://github.com/browniebroke
   - login: joshuatz
     avatarUrl: https://avatars.githubusercontent.com/u/17817563?u=f1bf05b690d1fc164218f0b420cdd3acb7913e21&v=4
     url: https://github.com/joshuatz
@@ -323,21 +317,24 @@ sponsors:
   - login: engineerjoe440
     avatarUrl: https://avatars.githubusercontent.com/u/33275230?u=eb223cad27017bb1e936ee9b429b450d092d0236&v=4
     url: https://github.com/engineerjoe440
+  - login: bnkc
+    avatarUrl: https://avatars.githubusercontent.com/u/34930566?u=db5e6f4f87836cad26c2aa90ce390ce49041c5a9&v=4
+    url: https://github.com/bnkc
   - login: lukzmu
-    avatarUrl: https://avatars.githubusercontent.com/u/175964415?u=83ea9b0b7b7b0f15bcb5747d93f303447a19a00b&v=4
+    avatarUrl: https://avatars.githubusercontent.com/u/175964415?u=75348f25bb99a5f92ddb40c0b9b1ff7acb39c150&v=4
     url: https://github.com/lukzmu
-  - login: conservative-dude
+  - login: hgalytoby
-    avatarUrl: https://avatars.githubusercontent.com/u/55538308?u=f250c44942ea6e73a6bd90739b381c470c192c11&v=4
+    avatarUrl: https://avatars.githubusercontent.com/u/50397689?u=62c7ff3519858423579676cd0efbd7e3f1ffe63a&v=4
-    url: https://github.com/conservative-dude
+    url: https://github.com/hgalytoby
-  - login: CR1337
-    avatarUrl: https://avatars.githubusercontent.com/u/62649536?u=57a6aab10d2421a497306da8bcded01b826c54ae&v=4
-    url: https://github.com/CR1337
   - login: PunRabbit
     avatarUrl: https://avatars.githubusercontent.com/u/70463212?u=1a835cfbc99295a60c8282f6aa6199d1b42241a5&v=4
     url: https://github.com/PunRabbit
   - login: PelicanQ
     avatarUrl: https://avatars.githubusercontent.com/u/77930606?v=4
     url: https://github.com/PelicanQ
+  - login: browniebroke
+    avatarUrl: https://avatars.githubusercontent.com/u/861044?u=5abfca5588f3e906b31583d7ee62f6de4b68aa24&v=4
+    url: https://github.com/browniebroke
   - login: miguelgr
     avatarUrl: https://avatars.githubusercontent.com/u/1484589?u=54556072b8136efa12ae3b6902032ea2a39ace4b&v=4
     url: https://github.com/miguelgr
@@ -347,9 +344,6 @@ sponsors:
   - login: my3
     avatarUrl: https://avatars.githubusercontent.com/u/1825270?v=4
     url: https://github.com/my3
-  - login: leobiscassi
-    avatarUrl: https://avatars.githubusercontent.com/u/1977418?u=f9f82445a847ab479bd7223debd677fcac6c49a0&v=4
-    url: https://github.com/leobiscassi
   - login: Alisa-lisa
     avatarUrl: https://avatars.githubusercontent.com/u/4137964?u=e7e393504f554f4ff15863a1e01a5746863ef9ce&v=4
     url: https://github.com/Alisa-lisa
@@ -425,9 +419,6 @@ sponsors:
   - login: harsh183
     avatarUrl: https://avatars.githubusercontent.com/u/7780198?v=4
     url: https://github.com/harsh183
-  - login: hcristea
-    avatarUrl: https://avatars.githubusercontent.com/u/7814406?u=19092923a4ea5b338567961c8270b9206a6d81bb&v=4
-    url: https://github.com/hcristea
 - - login: andrecorumba
     avatarUrl: https://avatars.githubusercontent.com/u/37807517?u=9b9be3b41da9bda60957da9ef37b50dbf65baa61&v=4
     url: https://github.com/andrecorumba
@@ -446,15 +437,21 @@ sponsors:
   - login: larsyngvelundin
     avatarUrl: https://avatars.githubusercontent.com/u/34173819?u=74958599695bf83ac9f1addd935a51548a10c6b0&v=4
     url: https://github.com/larsyngvelundin
-  - login: one-st-one
+  - login: 0ne-stone
     avatarUrl: https://avatars.githubusercontent.com/u/62360849?u=746dd21c34e7e06eefb11b03e8bb01aaae3c2a4f&v=4
-    url: https://github.com/one-st-one
+    url: https://github.com/0ne-stone
-  - login: federicsp
+  - login: darixsamani
-    avatarUrl: https://avatars.githubusercontent.com/u/62903636?u=05004f4a2c590f1d18c200e17978bf2e17acb632&v=4
+    avatarUrl: https://avatars.githubusercontent.com/u/67915678?u=cfa82128692eeeec4bf0e7a0faaa9a614695c0f9&v=4
-    url: https://github.com/federicsp
+    url: https://github.com/darixsamani
+  - login: nayasinghania
+    avatarUrl: https://avatars.githubusercontent.com/u/74111380?u=af853245a21fe052b6a27e41a8de8cf4cdf76e85&v=4
+    url: https://github.com/nayasinghania
   - login: Toothwitch
     avatarUrl: https://avatars.githubusercontent.com/u/1710406?u=5eebb23b46cd26e48643b9e5179536cad491c17a&v=4
     url: https://github.com/Toothwitch
+  - login: roboman-tech
+    avatarUrl: https://avatars.githubusercontent.com/u/8183070?u=fdeaa2ed29f598eb7901693884c0ad32b16982e3&v=4
+    url: https://github.com/roboman-tech
   - login: andreagrandi
     avatarUrl: https://avatars.githubusercontent.com/u/636391?u=13d90cb8ec313593a5b71fbd4e33b78d6da736f5&v=4
     url: https://github.com/andreagrandi

docs/en/data/topic_repos.yml

@@ -1,495 +1,495 @@
 - name: full-stack-fastapi-template
   html_url: https://github.com/fastapi/full-stack-fastapi-template
-  stars: 33079
+  stars: 34156
   owner_login: fastapi
   owner_html_url: https://github.com/fastapi
 - name: Hello-Python
   html_url: https://github.com/mouredev/Hello-Python
-  stars: 30350
+  stars: 30835
   owner_login: mouredev
   owner_html_url: https://github.com/mouredev
 - name: serve
   html_url: https://github.com/jina-ai/serve
-  stars: 21593
+  stars: 21631
   owner_login: jina-ai
   owner_html_url: https://github.com/jina-ai
 - name: HivisionIDPhotos
   html_url: https://github.com/Zeyi-Lin/HivisionIDPhotos
-  stars: 17229
+  stars: 18125
   owner_login: Zeyi-Lin
   owner_html_url: https://github.com/Zeyi-Lin
 - name: sqlmodel
   html_url: https://github.com/fastapi/sqlmodel
-  stars: 16068
+  stars: 16249
   owner_login: fastapi
   owner_html_url: https://github.com/fastapi
 - name: Douyin_TikTok_Download_API
   html_url: https://github.com/Evil0ctal/Douyin_TikTok_Download_API
-  stars: 12689
+  stars: 13279
   owner_login: Evil0ctal
   owner_html_url: https://github.com/Evil0ctal
 - name: fastapi-best-practices
   html_url: https://github.com/zhanymkanov/fastapi-best-practices
-  stars: 11965
+  stars: 12334
   owner_login: zhanymkanov
   owner_html_url: https://github.com/zhanymkanov
 - name: awesome-fastapi
   html_url: https://github.com/mjhea0/awesome-fastapi
-  stars: 9773
+  stars: 9934
   owner_login: mjhea0
   owner_html_url: https://github.com/mjhea0
 - name: FastUI
   html_url: https://github.com/pydantic/FastUI
-  stars: 8829
+  stars: 8838
   owner_login: pydantic
   owner_html_url: https://github.com/pydantic
+- name: XHS-Downloader
+  html_url: https://github.com/JoeanAmier/XHS-Downloader
+  stars: 7962
+  owner_login: JoeanAmier
+  owner_html_url: https://github.com/JoeanAmier
 - name: nonebot2
   html_url: https://github.com/nonebot/nonebot2
-  stars: 6779
+  stars: 6834
   owner_login: nonebot
   owner_html_url: https://github.com/nonebot
 - name: FileCodeBox
   html_url: https://github.com/vastsa/FileCodeBox
-  stars: 6652
+  stars: 6783
   owner_login: vastsa
   owner_html_url: https://github.com/vastsa
-- name: serge
+- name: fastapi_mcp
-  html_url: https://github.com/serge-chat/serge
+  html_url: https://github.com/tadata-org/fastapi_mcp
-  stars: 5722
+  stars: 5846
-  owner_login: serge-chat
+  owner_login: tadata-org
-  owner_html_url: https://github.com/serge-chat
+  owner_html_url: https://github.com/tadata-org
 - name: hatchet
   html_url: https://github.com/hatchet-dev/hatchet
-  stars: 5607
+  stars: 5773
   owner_login: hatchet-dev
   owner_html_url: https://github.com/hatchet-dev
+- name: serge
+  html_url: https://github.com/serge-chat/serge
+  stars: 5728
+  owner_login: serge-chat
+  owner_html_url: https://github.com/serge-chat
 - name: polar
   html_url: https://github.com/polarsource/polar
-  stars: 5327
+  stars: 5709
   owner_login: polarsource
   owner_html_url: https://github.com/polarsource
 - name: fastapi-users
   html_url: https://github.com/fastapi-users/fastapi-users
-  stars: 5235
+  stars: 5336
   owner_login: fastapi-users
   owner_html_url: https://github.com/fastapi-users
-- name: fastapi_mcp
-  html_url: https://github.com/tadata-org/fastapi_mcp
-  stars: 5193
-  owner_login: tadata-org
-  owner_html_url: https://github.com/tadata-org
-- name: SurfSense
-  html_url: https://github.com/MODSetter/SurfSense
-  stars: 4833
-  owner_login: MODSetter
-  owner_html_url: https://github.com/MODSetter
-- name: chatgpt-web-share
-  html_url: https://github.com/chatpire/chatgpt-web-share
-  stars: 4307
-  owner_login: chatpire
-  owner_html_url: https://github.com/chatpire
 - name: strawberry
   html_url: https://github.com/strawberry-graphql/strawberry
-  stars: 4281
+  stars: 4317
   owner_login: strawberry-graphql
   owner_html_url: https://github.com/strawberry-graphql
+- name: chatgpt-web-share
+  html_url: https://github.com/chatpire/chatgpt-web-share
+  stars: 4301
+  owner_login: chatpire
+  owner_html_url: https://github.com/chatpire
 - name: atrilabs-engine
   html_url: https://github.com/Atri-Labs/atrilabs-engine
-  stars: 4110
+  stars: 4106
   owner_login: Atri-Labs
   owner_html_url: https://github.com/Atri-Labs
 - name: dynaconf
   html_url: https://github.com/dynaconf/dynaconf
-  stars: 4008
+  stars: 4045
   owner_login: dynaconf
   owner_html_url: https://github.com/dynaconf
 - name: poem
   html_url: https://github.com/poem-web/poem
-  stars: 3977
+  stars: 4037
   owner_login: poem-web
   owner_html_url: https://github.com/poem-web
 - name: farfalle
   html_url: https://github.com/rashadphz/farfalle
-  stars: 3317
+  stars: 3348
   owner_login: rashadphz
   owner_html_url: https://github.com/rashadphz
+- name: LitServe
+  html_url: https://github.com/Lightning-AI/LitServe
+  stars: 3347
+  owner_login: Lightning-AI
+  owner_html_url: https://github.com/Lightning-AI
 - name: fastapi-admin
   html_url: https://github.com/fastapi-admin/fastapi-admin
-  stars: 3253
+  stars: 3309
   owner_login: fastapi-admin
   owner_html_url: https://github.com/fastapi-admin
 - name: datamodel-code-generator
   html_url: https://github.com/koxudaxi/datamodel-code-generator
-  stars: 3228
+  stars: 3291
   owner_login: koxudaxi
   owner_html_url: https://github.com/koxudaxi
-- name: LitServe
-  html_url: https://github.com/Lightning-AI/LitServe
-  stars: 3175
-  owner_login: Lightning-AI
-  owner_html_url: https://github.com/Lightning-AI
 - name: logfire
   html_url: https://github.com/pydantic/logfire
-  stars: 3172
+  stars: 3288
   owner_login: pydantic
   owner_html_url: https://github.com/pydantic
-- name: opyrator
-  html_url: https://github.com/ml-tooling/opyrator
-  stars: 3122
-  owner_login: ml-tooling
-  owner_html_url: https://github.com/ml-tooling
 - name: huma
   html_url: https://github.com/danielgtaylor/huma
-  stars: 3110
+  stars: 3201
   owner_login: danielgtaylor
   owner_html_url: https://github.com/danielgtaylor
+- name: opyrator
+  html_url: https://github.com/ml-tooling/opyrator
+  stars: 3132
+  owner_login: ml-tooling
+  owner_html_url: https://github.com/ml-tooling
+- name: Kokoro-FastAPI
+  html_url: https://github.com/remsky/Kokoro-FastAPI
+  stars: 3099
+  owner_login: remsky
+  owner_html_url: https://github.com/remsky
 - name: docarray
   html_url: https://github.com/docarray/docarray
-  stars: 3068
+  stars: 3075
   owner_login: docarray
   owner_html_url: https://github.com/docarray
 - name: fastapi-realworld-example-app
   html_url: https://github.com/nsidnev/fastapi-realworld-example-app
-  stars: 2892
+  stars: 2902
   owner_login: nsidnev
   owner_html_url: https://github.com/nsidnev
-- name: Kokoro-FastAPI
-  html_url: https://github.com/remsky/Kokoro-FastAPI
-  stars: 2883
-  owner_login: remsky
-  owner_html_url: https://github.com/remsky
-- name: uvicorn-gunicorn-fastapi-docker
-  html_url: https://github.com/tiangolo/uvicorn-gunicorn-fastapi-docker
-  stars: 2770
-  owner_login: tiangolo
-  owner_html_url: https://github.com/tiangolo
 - name: tracecat
   html_url: https://github.com/TracecatHQ/tracecat
-  stars: 2740
+  stars: 2888
   owner_login: TracecatHQ
   owner_html_url: https://github.com/TracecatHQ
+- name: uvicorn-gunicorn-fastapi-docker
+  html_url: https://github.com/tiangolo/uvicorn-gunicorn-fastapi-docker
+  stars: 2775
+  owner_login: tiangolo
+  owner_html_url: https://github.com/tiangolo
 - name: best-of-web-python
   html_url: https://github.com/ml-tooling/best-of-web-python
-  stars: 2517
+  stars: 2537
   owner_login: ml-tooling
   owner_html_url: https://github.com/ml-tooling
 - name: RasaGPT
   html_url: https://github.com/paulpierre/RasaGPT
-  stars: 2423
+  stars: 2427
   owner_login: paulpierre
   owner_html_url: https://github.com/paulpierre
 - name: fastapi-react
   html_url: https://github.com/Buuntu/fastapi-react
-  stars: 2376
+  stars: 2397
   owner_login: Buuntu
   owner_html_url: https://github.com/Buuntu
 - name: FastAPI-template
   html_url: https://github.com/s3rius/FastAPI-template
-  stars: 2301
+  stars: 2334
   owner_login: s3rius
   owner_html_url: https://github.com/s3rius
 - name: nextpy
   html_url: https://github.com/dot-agent/nextpy
-  stars: 2289
+  stars: 2295
   owner_login: dot-agent
   owner_html_url: https://github.com/dot-agent
 - name: sqladmin
   html_url: https://github.com/aminalaee/sqladmin
-  stars: 2196
+  stars: 2235
   owner_login: aminalaee
   owner_html_url: https://github.com/aminalaee
 - name: 30-Days-of-Python
   html_url: https://github.com/codingforentrepreneurs/30-Days-of-Python
-  stars: 2179
+  stars: 2181
   owner_login: codingforentrepreneurs
   owner_html_url: https://github.com/codingforentrepreneurs
 - name: langserve
   html_url: https://github.com/langchain-ai/langserve
-  stars: 2098
+  stars: 2119
   owner_login: langchain-ai
   owner_html_url: https://github.com/langchain-ai
 - name: fastapi-utils
   html_url: https://github.com/fastapiutils/fastapi-utils
-  stars: 2077
+  stars: 2100
   owner_login: fastapiutils
   owner_html_url: https://github.com/fastapiutils
 - name: supabase-py
   html_url: https://github.com/supabase/supabase-py
-  stars: 2047
+  stars: 2084
   owner_login: supabase
   owner_html_url: https://github.com/supabase
 - name: solara
   html_url: https://github.com/widgetti/solara
-  stars: 2044
+  stars: 2056
   owner_login: widgetti
   owner_html_url: https://github.com/widgetti
 - name: mangum
   html_url: https://github.com/Kludex/mangum
-  stars: 1905
+  stars: 1923
   owner_login: Kludex
   owner_html_url: https://github.com/Kludex
 - name: python-week-2022
   html_url: https://github.com/rochacbruno/python-week-2022
-  stars: 1823
+  stars: 1821
   owner_login: rochacbruno
   owner_html_url: https://github.com/rochacbruno
-- name: manage-fastapi
-  html_url: https://github.com/ycd/manage-fastapi
-  stars: 1754
-  owner_login: ycd
-  owner_html_url: https://github.com/ycd
 - name: agentkit
   html_url: https://github.com/BCG-X-Official/agentkit
-  stars: 1746
+  stars: 1765
   owner_login: BCG-X-Official
   owner_html_url: https://github.com/BCG-X-Official
+- name: manage-fastapi
+  html_url: https://github.com/ycd/manage-fastapi
+  stars: 1756
+  owner_login: ycd
+  owner_html_url: https://github.com/ycd
 - name: ormar
   html_url: https://github.com/collerek/ormar
-  stars: 1742
+  stars: 1755
   owner_login: collerek
   owner_html_url: https://github.com/collerek
 - name: langchain-serve
   html_url: https://github.com/jina-ai/langchain-serve
-  stars: 1630
+  stars: 1631
   owner_login: jina-ai
   owner_html_url: https://github.com/jina-ai
-- name: termpair
-  html_url: https://github.com/cs01/termpair
-  stars: 1611
-  owner_login: cs01
-  owner_html_url: https://github.com/cs01
 - name: piccolo
   html_url: https://github.com/piccolo-orm/piccolo
-  stars: 1609
+  stars: 1629
   owner_login: piccolo-orm
   owner_html_url: https://github.com/piccolo-orm
-- name: coronavirus-tracker-api
+- name: termpair
-  html_url: https://github.com/ExpDev07/coronavirus-tracker-api
+  html_url: https://github.com/cs01/termpair
-  stars: 1587
+  stars: 1616
-  owner_login: ExpDev07
+  owner_login: cs01
-  owner_html_url: https://github.com/ExpDev07
+  owner_html_url: https://github.com/cs01
-- name: fastapi-cache
-  html_url: https://github.com/long2ice/fastapi-cache
-  stars: 1575
-  owner_login: long2ice
-  owner_html_url: https://github.com/long2ice
 - name: openapi-python-client
   html_url: https://github.com/openapi-generators/openapi-python-client
-  stars: 1568
+  stars: 1603
   owner_login: openapi-generators
   owner_html_url: https://github.com/openapi-generators
-- name: fastapi-crudrouter
+- name: fastapi-cache
-  html_url: https://github.com/awtkns/fastapi-crudrouter
+  html_url: https://github.com/long2ice/fastapi-cache
-  stars: 1508
+  stars: 1589
-  owner_login: awtkns
+  owner_login: long2ice
-  owner_html_url: https://github.com/awtkns
+  owner_html_url: https://github.com/long2ice
+- name: coronavirus-tracker-api
+  html_url: https://github.com/ExpDev07/coronavirus-tracker-api
+  stars: 1580
+  owner_login: ExpDev07
+  owner_html_url: https://github.com/ExpDev07
 - name: slowapi
   html_url: https://github.com/laurentS/slowapi
-  stars: 1501
+  stars: 1533
   owner_login: laurentS
   owner_html_url: https://github.com/laurentS
+- name: fastapi-crudrouter
+  html_url: https://github.com/awtkns/fastapi-crudrouter
+  stars: 1518
+  owner_login: awtkns
+  owner_html_url: https://github.com/awtkns
 - name: awesome-fastapi-projects
   html_url: https://github.com/Kludex/awesome-fastapi-projects
-  stars: 1453
+  stars: 1461
   owner_login: Kludex
   owner_html_url: https://github.com/Kludex
+- name: vue-fastapi-admin
+  html_url: https://github.com/mizhexiaoxiao/vue-fastapi-admin
+  stars: 1409
+  owner_login: mizhexiaoxiao
+  owner_html_url: https://github.com/mizhexiaoxiao
 - name: awesome-python-resources
   html_url: https://github.com/DjangoEx/awesome-python-resources
-  stars: 1390
+  stars: 1393
   owner_login: DjangoEx
   owner_html_url: https://github.com/DjangoEx
 - name: fastapi-pagination
   html_url: https://github.com/uriyyo/fastapi-pagination
-  stars: 1353
+  stars: 1378
   owner_login: uriyyo
   owner_html_url: https://github.com/uriyyo
-- name: budgetml
-  html_url: https://github.com/ebhy/budgetml
-  stars: 1342
-  owner_login: ebhy
-  owner_html_url: https://github.com/ebhy
 - name: fastapi-boilerplate
   html_url: https://github.com/teamhide/fastapi-boilerplate
-  stars: 1325
+  stars: 1348
   owner_login: teamhide
   owner_html_url: https://github.com/teamhide
-- name: vue-fastapi-admin
+- name: budgetml
-  html_url: https://github.com/mizhexiaoxiao/vue-fastapi-admin
+  html_url: https://github.com/ebhy/budgetml
-  stars: 1306
+  stars: 1344
-  owner_login: mizhexiaoxiao
+  owner_login: ebhy
-  owner_html_url: https://github.com/mizhexiaoxiao
+  owner_html_url: https://github.com/ebhy
 - name: fastapi-amis-admin
   html_url: https://github.com/amisadmin/fastapi-amis-admin
-  stars: 1256
+  stars: 1284
   owner_login: amisadmin
   owner_html_url: https://github.com/amisadmin
+- name: bracket
+  html_url: https://github.com/evroon/bracket
+  stars: 1274
+  owner_login: evroon
+  owner_html_url: https://github.com/evroon
 - name: fastapi-tutorial
   html_url: https://github.com/liaogx/fastapi-tutorial
-  stars: 1245
+  stars: 1265
   owner_login: liaogx
   owner_html_url: https://github.com/liaogx
 - name: fastapi-code-generator
   html_url: https://github.com/koxudaxi/fastapi-code-generator
-  stars: 1201
+  stars: 1216
   owner_login: koxudaxi
   owner_html_url: https://github.com/koxudaxi
-- name: bracket
-  html_url: https://github.com/evroon/bracket
-  stars: 1201
-  owner_login: evroon
-  owner_html_url: https://github.com/evroon
 - name: bolt-python
   html_url: https://github.com/slackapi/bolt-python
-  stars: 1179
+  stars: 1190
   owner_login: slackapi
   owner_html_url: https://github.com/slackapi
-- name: fastapi_production_template
+- name: fastcrud
-  html_url: https://github.com/zhanymkanov/fastapi_production_template
+  html_url: https://github.com/benavlabs/fastcrud
-  stars: 1147
+  stars: 1169
-  owner_login: zhanymkanov
+  owner_login: benavlabs
-  owner_html_url: https://github.com/zhanymkanov
+  owner_html_url: https://github.com/benavlabs
 - name: prometheus-fastapi-instrumentator
   html_url: https://github.com/trallnag/prometheus-fastapi-instrumentator
-  stars: 1145
+  stars: 1167
   owner_login: trallnag
   owner_html_url: https://github.com/trallnag
+- name: fastapi_production_template
+  html_url: https://github.com/zhanymkanov/fastapi_production_template
+  stars: 1165
+  owner_login: zhanymkanov
+  owner_html_url: https://github.com/zhanymkanov
 - name: bedrock-chat
   html_url: https://github.com/aws-samples/bedrock-chat
-  stars: 1143
+  stars: 1163
   owner_login: aws-samples
   owner_html_url: https://github.com/aws-samples
 - name: langchain-extract
   html_url: https://github.com/langchain-ai/langchain-extract
-  stars: 1134
+  stars: 1142
   owner_login: langchain-ai
   owner_html_url: https://github.com/langchain-ai
 - name: odmantic
   html_url: https://github.com/art049/odmantic
-  stars: 1118
+  stars: 1121
   owner_login: art049
   owner_html_url: https://github.com/art049
+- name: fastapi_best_architecture
+  html_url: https://github.com/fastapi-practices/fastapi_best_architecture
+  stars: 1118
+  owner_login: fastapi-practices
+  owner_html_url: https://github.com/fastapi-practices
 - name: fastapi-alembic-sqlmodel-async
   html_url: https://github.com/jonra1993/fastapi-alembic-sqlmodel-async
-  stars: 1110
+  stars: 1116
   owner_login: jonra1993
   owner_html_url: https://github.com/jonra1993
-- name: fastcrud
+- name: FastAPI-boilerplate
-  html_url: https://github.com/benavlabs/fastcrud
+  html_url: https://github.com/benavlabs/FastAPI-boilerplate
-  stars: 1080
+  stars: 1070
   owner_login: benavlabs
   owner_html_url: https://github.com/benavlabs
 - name: restish
   html_url: https://github.com/rest-sh/restish
-  stars: 1056
+  stars: 1069
   owner_login: rest-sh
   owner_html_url: https://github.com/rest-sh
-- name: fastapi_best_architecture
-  html_url: https://github.com/fastapi-practices/fastapi_best_architecture
-  stars: 1050
-  owner_login: fastapi-practices
-  owner_html_url: https://github.com/fastapi-practices
 - name: runhouse
   html_url: https://github.com/run-house/runhouse
-  stars: 1034
+  stars: 1037
   owner_login: run-house
   owner_html_url: https://github.com/run-house
 - name: autollm
   html_url: https://github.com/viddexa/autollm
-  stars: 992
+  stars: 994
   owner_login: viddexa
   owner_html_url: https://github.com/viddexa
 - name: lanarky
   html_url: https://github.com/ajndkr/lanarky
-  stars: 990
+  stars: 992
   owner_login: ajndkr
   owner_html_url: https://github.com/ajndkr
-- name: FastAPI-boilerplate
-  html_url: https://github.com/benavlabs/FastAPI-boilerplate
-  stars: 985
-  owner_login: benavlabs
-  owner_html_url: https://github.com/benavlabs
 - name: authx
   html_url: https://github.com/yezz123/authx
-  stars: 938
+  stars: 953
   owner_login: yezz123
   owner_html_url: https://github.com/yezz123
 - name: secure
   html_url: https://github.com/TypeError/secure
-  stars: 935
+  stars: 941
   owner_login: TypeError
   owner_html_url: https://github.com/TypeError
-- name: langcorn
-  html_url: https://github.com/msoedov/langcorn
-  stars: 925
-  owner_login: msoedov
-  owner_html_url: https://github.com/msoedov
 - name: energy-forecasting
   html_url: https://github.com/iusztinpaul/energy-forecasting
-  stars: 913
+  stars: 928
   owner_login: iusztinpaul
   owner_html_url: https://github.com/iusztinpaul
+- name: langcorn
+  html_url: https://github.com/msoedov/langcorn
+  stars: 927
+  owner_login: msoedov
+  owner_html_url: https://github.com/msoedov
 - name: titiler
   html_url: https://github.com/developmentseed/titiler
-  stars: 886
+  stars: 901
   owner_login: developmentseed
   owner_html_url: https://github.com/developmentseed
 - name: flock
   html_url: https://github.com/Onelevenvy/flock
-  stars: 866
+  stars: 896
   owner_login: Onelevenvy
   owner_html_url: https://github.com/Onelevenvy
-- name: httpdbg
+- name: fastapi-langgraph-agent-production-ready-template
-  html_url: https://github.com/cle-b/httpdbg
+  html_url: https://github.com/wassim249/fastapi-langgraph-agent-production-ready-template
-  stars: 863
+  stars: 896
-  owner_login: cle-b
+  owner_login: wassim249
-  owner_html_url: https://github.com/cle-b
+  owner_html_url: https://github.com/wassim249
 - name: marker-api
   html_url: https://github.com/adithya-s-k/marker-api
-  stars: 859
+  stars: 875
   owner_login: adithya-s-k
   owner_html_url: https://github.com/adithya-s-k
-- name: ludic
+- name: httpdbg
-  html_url: https://github.com/getludic/ludic
+  html_url: https://github.com/cle-b/httpdbg
-  stars: 845
+  stars: 870
-  owner_login: getludic
+  owner_login: cle-b
-  owner_html_url: https://github.com/getludic
+  owner_html_url: https://github.com/cle-b
 - name: fastapi-do-zero
   html_url: https://github.com/dunossauro/fastapi-do-zero
-  stars: 827
+  stars: 855
   owner_login: dunossauro
   owner_html_url: https://github.com/dunossauro
+- name: ludic
+  html_url: https://github.com/getludic/ludic
+  stars: 849
+  owner_login: getludic
+  owner_html_url: https://github.com/getludic
 - name: fastapi-observability
   html_url: https://github.com/blueswen/fastapi-observability
-  stars: 823
+  stars: 837
   owner_login: blueswen
   owner_html_url: https://github.com/blueswen
-- name: fastapi-langgraph-agent-production-ready-template
+- name: fastapi-scaf
-  html_url: https://github.com/wassim249/fastapi-langgraph-agent-production-ready-template
+  html_url: https://github.com/atpuxiner/fastapi-scaf
-  stars: 803
+  stars: 821
-  owner_login: wassim249
+  owner_login: atpuxiner
-  owner_html_url: https://github.com/wassim249
+  owner_html_url: https://github.com/atpuxiner
-- name: fastapi-mail
-  html_url: https://github.com/sabuhish/fastapi-mail
-  stars: 798
-  owner_login: sabuhish
-  owner_html_url: https://github.com/sabuhish
 - name: starlette-admin
   html_url: https://github.com/jowilf/starlette-admin
-  stars: 785
+  stars: 808
   owner_login: jowilf
   owner_html_url: https://github.com/jowilf
-- name: lccn_predictor
+- name: fastapi-mail
-  html_url: https://github.com/baoliay2008/lccn_predictor
+  html_url: https://github.com/sabuhish/fastapi-mail
-  stars: 767
+  stars: 807
-  owner_login: baoliay2008
+  owner_login: sabuhish
-  owner_html_url: https://github.com/baoliay2008
+  owner_html_url: https://github.com/sabuhish
 - name: aktools
   html_url: https://github.com/akfamily/aktools
-  stars: 759
+  stars: 796
   owner_login: akfamily
   owner_html_url: https://github.com/akfamily
-- name: KonomiTV
+- name: RuoYi-Vue3-FastAPI
-  html_url: https://github.com/tsukumijima/KonomiTV
+  html_url: https://github.com/insistence/RuoYi-Vue3-FastAPI
-  stars: 748
+  stars: 782
-  owner_login: tsukumijima
+  owner_login: insistence
-  owner_html_url: https://github.com/tsukumijima
+  owner_html_url: https://github.com/insistence

docs/en/data/translation_reviewers.yml

@@ -10,7 +10,7 @@ Xewus:
   url: https://github.com/Xewus
 sodaMelon:
   login: sodaMelon
-  count: 125
+  count: 126
   avatarUrl: https://avatars.githubusercontent.com/u/66295123?u=be939db90f1119efee9e6110cc05066ff1f40f00&v=4
   url: https://github.com/sodaMelon
 ceb10n:
@@ -30,7 +30,7 @@ hasansezertasan:
   url: https://github.com/hasansezertasan
 hard-coders:
   login: hard-coders
-  count: 92
+  count: 93
   avatarUrl: https://avatars.githubusercontent.com/u/9651103?u=95db33927bbff1ed1c07efddeb97ac2ff33068ed&v=4
   url: https://github.com/hard-coders
 alv2017:
@@ -70,7 +70,7 @@ mattwang44:
   url: https://github.com/mattwang44
 tiangolo:
   login: tiangolo
-  count: 52
+  count: 53
   avatarUrl: https://avatars.githubusercontent.com/u/1326112?u=cb5d06e73a9e1998141b1641aa88e443c6717651&v=4
   url: https://github.com/tiangolo
 Laineyzhang55:
@@ -148,6 +148,11 @@ nilslindemann:
   count: 35
   avatarUrl: https://avatars.githubusercontent.com/u/6892179?u=1dca6a22195d6cd1ab20737c0e19a4c55d639472&v=4
   url: https://github.com/nilslindemann
+mezgoodle:
+  login: mezgoodle
+  count: 35
+  avatarUrl: https://avatars.githubusercontent.com/u/41520940?u=4a9c765af688389d54296845d18b8f6cd6ddf09a&v=4
+  url: https://github.com/mezgoodle
 rjNemo:
   login: rjNemo
   count: 34
@@ -158,11 +163,6 @@ codingjenny:
   count: 34
   avatarUrl: https://avatars.githubusercontent.com/u/103817302?u=3a042740dc0ff58615da0d8679230966fd7693e8&v=4
   url: https://github.com/codingjenny
-mezgoodle:
-  login: mezgoodle
-  count: 33
-  avatarUrl: https://avatars.githubusercontent.com/u/41520940?u=4a9c765af688389d54296845d18b8f6cd6ddf09a&v=4
-  url: https://github.com/mezgoodle
 akarev0:
   login: akarev0
   count: 33
@@ -243,6 +243,11 @@ mycaule:
   count: 25
   avatarUrl: https://avatars.githubusercontent.com/u/6161385?u=e3cec75bd6d938a0d73fae0dc5534d1ab2ed1b0e&v=4
   url: https://github.com/mycaule
+YuriiMotov:
+  login: YuriiMotov
+  count: 24
+  avatarUrl: https://avatars.githubusercontent.com/u/109919500?u=e83a39697a2d33ab2ec9bfbced794ee48bc29cec&v=4
+  url: https://github.com/YuriiMotov
 Aruelius:
   login: Aruelius
   count: 24
@@ -268,6 +273,11 @@ axel584:
   count: 23
   avatarUrl: https://avatars.githubusercontent.com/u/1334088?u=9667041f5b15dc002b6f9665fda8c0412933ac04&v=4
   url: https://github.com/axel584
+DianaTrufanova:
+  login: DianaTrufanova
+  count: 23
+  avatarUrl: https://avatars.githubusercontent.com/u/119067607?u=1cd55f841b68b4a187fa6d06a7dafa5f070195aa&v=4
+  url: https://github.com/DianaTrufanova
 AGolicyn:
   login: AGolicyn
   count: 21
@@ -328,6 +338,11 @@ Limsunoh:
   count: 18
   avatarUrl: https://avatars.githubusercontent.com/u/90311848?u=f456e0c5709fd50c8cd2898b551558eda14e5f21&v=4
   url: https://github.com/Limsunoh
+SofiiaTrufanova:
+  login: SofiiaTrufanova
+  count: 18
+  avatarUrl: https://avatars.githubusercontent.com/u/63260929?u=483e0b64fabc76343b3be39b7e1dcb930a95e1bb&v=4
+  url: https://github.com/SofiiaTrufanova
 bezaca:
   login: bezaca
   count: 17
@@ -373,11 +388,6 @@ JaeHyuckSa:
   count: 16
   avatarUrl: https://avatars.githubusercontent.com/u/104830931?u=6e352201714a05154e5d0ccf91b4715a951c622e&v=4
   url: https://github.com/JaeHyuckSa
-SofiiaTrufanova:
-  login: SofiiaTrufanova
-  count: 16
-  avatarUrl: https://avatars.githubusercontent.com/u/63260929?u=483e0b64fabc76343b3be39b7e1dcb930a95e1bb&v=4
-  url: https://github.com/SofiiaTrufanova
 Jedore:
   login: Jedore
   count: 15
@@ -388,11 +398,6 @@ kim-sangah:
   count: 15
   avatarUrl: https://avatars.githubusercontent.com/u/173775778?v=4
   url: https://github.com/kim-sangah
-DianaTrufanova:
-  login: DianaTrufanova
-  count: 15
-  avatarUrl: https://avatars.githubusercontent.com/u/119067607?u=1cd55f841b68b4a187fa6d06a7dafa5f070195aa&v=4
-  url: https://github.com/DianaTrufanova
 PandaHun:
   login: PandaHun
   count: 14
@@ -533,6 +538,11 @@ Lufa1u:
   count: 11
   avatarUrl: https://avatars.githubusercontent.com/u/112495876?u=087658920ed9e74311597bdd921d8d2de939d276&v=4
   url: https://github.com/Lufa1u
+waketzheng:
+  login: waketzheng
+  count: 11
+  avatarUrl: https://avatars.githubusercontent.com/u/35413830?u=df19e4fd5bb928e7d086e053ef26a46aad23bf84&v=4
+  url: https://github.com/waketzheng
 KNChiu:
   login: KNChiu
   count: 11
@@ -593,16 +603,21 @@ nick-cjyx9:
   count: 10
   avatarUrl: https://avatars.githubusercontent.com/u/119087246?u=c35aab03f082430be8a1edd80f5625b44819a0d8&v=4
   url: https://github.com/nick-cjyx9
-waketzheng:
-  login: waketzheng
-  count: 10
-  avatarUrl: https://avatars.githubusercontent.com/u/35413830?u=df19e4fd5bb928e7d086e053ef26a46aad23bf84&v=4
-  url: https://github.com/waketzheng
 lucasbalieiro:
   login: lucasbalieiro
   count: 10
   avatarUrl: https://avatars.githubusercontent.com/u/37416577?u=eabaf4aebbaa88a94a4886273edba689012cee70&v=4
   url: https://github.com/lucasbalieiro
+maru0123-2004:
+  login: maru0123-2004
+  count: 10
+  avatarUrl: https://avatars.githubusercontent.com/u/43961566?u=16ed8603a4d6a4665cb6c53a7aece6f31379b769&v=4
+  url: https://github.com/maru0123-2004
+Zhongheng-Cheng:
+  login: Zhongheng-Cheng
+  count: 10
+  avatarUrl: https://avatars.githubusercontent.com/u/95612344?u=a0f7730a3cc7486827965e01a119ad610bda4b0a&v=4
+  url: https://github.com/Zhongheng-Cheng
 RunningIkkyu:
   login: RunningIkkyu
   count: 9
@@ -646,7 +661,7 @@ riroan:
 MinLee0210:
   login: MinLee0210
   count: 9
-  avatarUrl: https://avatars.githubusercontent.com/u/57653278?u=3c4b6e9d69bff148d09fe022ddf867e564acaa44&v=4
+  avatarUrl: https://avatars.githubusercontent.com/u/57653278?u=8ca05a7efbc76048183da00da87d148b755a3ba8&v=4
   url: https://github.com/MinLee0210
 yodai-yodai:
   login: yodai-yodai
@@ -663,11 +678,6 @@ JoaoGustavoRogel:
   count: 9
   avatarUrl: https://avatars.githubusercontent.com/u/29525510?u=a0a91251f5e43e132608d55d28ccb8645c5ea405&v=4
   url: https://github.com/JoaoGustavoRogel
-Zhongheng-Cheng:
-  login: Zhongheng-Cheng
-  count: 9
-  avatarUrl: https://avatars.githubusercontent.com/u/95612344?u=a0f7730a3cc7486827965e01a119ad610bda4b0a&v=4
-  url: https://github.com/Zhongheng-Cheng
 Yarous:
   login: Yarous
   count: 9
@@ -713,11 +723,6 @@ camigomezdev:
   count: 8
   avatarUrl: https://avatars.githubusercontent.com/u/16061815?u=25b5ebc042fff53fa03dc107ded10e36b1b7a5b9&v=4
   url: https://github.com/camigomezdev
-maru0123-2004:
-  login: maru0123-2004
-  count: 8
-  avatarUrl: https://avatars.githubusercontent.com/u/43961566?u=16ed8603a4d6a4665cb6c53a7aece6f31379b769&v=4
-  url: https://github.com/maru0123-2004
 minaton-ru:
   login: minaton-ru
   count: 8
@@ -748,6 +753,11 @@ anthonycepeda:
   count: 7
   avatarUrl: https://avatars.githubusercontent.com/u/72019805?u=60bdf46240cff8fca482ff0fc07d963fd5e1a27c&v=4
   url: https://github.com/anthonycepeda
+Muaytie666:
+  login: Muaytie666
+  count: 7
+  avatarUrl: https://avatars.githubusercontent.com/u/198508825?v=4
+  url: https://github.com/Muaytie666
 fabioueno:
   login: fabioueno
   count: 7
@@ -773,6 +783,11 @@ d2a-raudenaerde:
   count: 7
   avatarUrl: https://avatars.githubusercontent.com/u/5213150?v=4
   url: https://github.com/d2a-raudenaerde
+valentinDruzhinin:
+  login: valentinDruzhinin
+  count: 7
+  avatarUrl: https://avatars.githubusercontent.com/u/12831905?u=aae1ebc675c91e8fa582df4fcc4fc4128106344d&v=4
+  url: https://github.com/valentinDruzhinin
 Zerohertz:
   login: Zerohertz
   count: 7
@@ -781,7 +796,7 @@ Zerohertz:
 deniscapeto:
   login: deniscapeto
   count: 6
-  avatarUrl: https://avatars.githubusercontent.com/u/12864353?u=dbc20c5c1171feab5df4db46488b675d53cb5b07&v=4
+  avatarUrl: https://avatars.githubusercontent.com/u/12864353?u=20c5b2300b264a585a8381acf3cef44bcfcc1ead&v=4
   url: https://github.com/deniscapeto
 bsab:
   login: bsab
@@ -878,11 +893,11 @@ bankofsardine:
   count: 6
   avatarUrl: https://avatars.githubusercontent.com/u/44944207?u=0368e1b698ffab6bf29e202f9fd2dddd352429f1&v=4
   url: https://github.com/bankofsardine
-valentinDruzhinin:
+Rekl0w:
-  login: valentinDruzhinin
+  login: Rekl0w
   count: 6
-  avatarUrl: https://avatars.githubusercontent.com/u/12831905?u=aae1ebc675c91e8fa582df4fcc4fc4128106344d&v=4
+  avatarUrl: https://avatars.githubusercontent.com/u/91488737?u=3b62b04a3e6699eab9b1eea4e88c09a39b753a17&v=4
-  url: https://github.com/valentinDruzhinin
+  url: https://github.com/Rekl0w
 rsip22:
   login: rsip22
   count: 5
@@ -966,7 +981,7 @@ ChuyuChoyeon:
 frwl404:
   login: frwl404
   count: 5
-  avatarUrl: https://avatars.githubusercontent.com/u/42642656?u=572a5a33762e07eaa6ebd58d9d773abdb1de41c3&v=4
+  avatarUrl: https://avatars.githubusercontent.com/u/42642656?u=8395a3d991d9fac86901277d76f0f70857b56ec5&v=4
   url: https://github.com/frwl404
 esrefzeki:
   login: esrefzeki
@@ -1328,6 +1343,11 @@ Sion99:
   count: 3
   avatarUrl: https://avatars.githubusercontent.com/u/82511301?v=4
   url: https://github.com/Sion99
+nymous:
+  login: nymous
+  count: 3
+  avatarUrl: https://avatars.githubusercontent.com/u/4216559?u=360a36fb602cded27273cbfc0afc296eece90662&v=4
+  url: https://github.com/nymous
 EpsilonRationes:
   login: EpsilonRationes
   count: 3
@@ -1366,7 +1386,7 @@ GDemay:
 maxscheijen:
   login: maxscheijen
   count: 3
-  avatarUrl: https://avatars.githubusercontent.com/u/47034840?u=eb98f37882528ea349ca4e5255fa64ac3fef0294&v=4
+  avatarUrl: https://avatars.githubusercontent.com/u/47034840?v=4
   url: https://github.com/maxscheijen
 celestywang:
   login: celestywang
@@ -1566,7 +1586,7 @@ raphaelauv:
 Fahad-Md-Kamal:
   login: Fahad-Md-Kamal
   count: 2
-  avatarUrl: https://avatars.githubusercontent.com/u/34704464?u=f96c6cbd25b06274e3ff96bc961ca91b3f876481&v=4
+  avatarUrl: https://avatars.githubusercontent.com/u/34704464?u=141086368c5557d5a1a533fe291f21f9fc584458&v=4
   url: https://github.com/Fahad-Md-Kamal
 zxcq544:
   login: zxcq544
@@ -1753,6 +1773,11 @@ kiharito:
   count: 2
   avatarUrl: https://avatars.githubusercontent.com/u/38311245?v=4
   url: https://github.com/kiharito
+t4f1d:
+  login: t4f1d
+  count: 2
+  avatarUrl: https://avatars.githubusercontent.com/u/4054172?u=463d5ce0ec8ad8582f6e9351bb8c9a5105b39bb7&v=4
+  url: https://github.com/t4f1d
 J-Fuji:
   login: J-Fuji
   count: 2
@@ -1783,3 +1808,13 @@ Azazul123:
   count: 2
   avatarUrl: https://avatars.githubusercontent.com/u/102759111?u=b48ce6e30a81a23467cc30e0c011bcc57f0326ab&v=4
   url: https://github.com/Azazul123
+ykertytsky:
+  login: ykertytsky
+  count: 2
+  avatarUrl: https://avatars.githubusercontent.com/u/83857001?u=1172902656ee604cf37f5e36abe938cd34a97a32&v=4
+  url: https://github.com/ykertytsky
+NavesSapnis:
+  login: NavesSapnis
+  count: 2
+  avatarUrl: https://avatars.githubusercontent.com/u/79222417?u=b5b10291b8e9130ca84fd20f0a641e04ed94b6b1&v=4
+  url: https://github.com/NavesSapnis

docs/en/data/translators.yml

@@ -8,16 +8,16 @@ jaystone776:
   count: 46
   avatarUrl: https://avatars.githubusercontent.com/u/11191137?u=299205a95e9b6817a43144a48b643346a5aac5cc&v=4
   url: https://github.com/jaystone776
+valentinDruzhinin:
+  login: valentinDruzhinin
+  count: 29
+  avatarUrl: https://avatars.githubusercontent.com/u/12831905?u=aae1ebc675c91e8fa582df4fcc4fc4128106344d&v=4
+  url: https://github.com/valentinDruzhinin
 ceb10n:
   login: ceb10n
   count: 27
   avatarUrl: https://avatars.githubusercontent.com/u/235213?u=edcce471814a1eba9f0cdaa4cd0de18921a940a6&v=4
   url: https://github.com/ceb10n
-valentinDruzhinin:
-  login: valentinDruzhinin
-  count: 24
-  avatarUrl: https://avatars.githubusercontent.com/u/12831905?u=aae1ebc675c91e8fa582df4fcc4fc4128106344d&v=4
-  url: https://github.com/valentinDruzhinin
 tokusumi:
   login: tokusumi
   count: 23
@@ -108,6 +108,11 @@ ptt3199:
   count: 7
   avatarUrl: https://avatars.githubusercontent.com/u/51350651?u=2c3d947a80283e32bf616d4c3af139a6be69680f&v=4
   url: https://github.com/ptt3199
+NinaHwang:
+  login: NinaHwang
+  count: 6
+  avatarUrl: https://avatars.githubusercontent.com/u/79563565?u=241f2cb6d38a2d379536608a8ea5a22ed4b1a3ea&v=4
+  url: https://github.com/NinaHwang
 batlopes:
   login: batlopes
   count: 6
@@ -138,11 +143,6 @@ Attsun1031:
   count: 5
   avatarUrl: https://avatars.githubusercontent.com/u/1175560?v=4
   url: https://github.com/Attsun1031
-NinaHwang:
-  login: NinaHwang
-  count: 5
-  avatarUrl: https://avatars.githubusercontent.com/u/79563565?u=241f2cb6d38a2d379536608a8ea5a22ed4b1a3ea&v=4
-  url: https://github.com/NinaHwang
 tiangolo:
   login: tiangolo
   count: 5
@@ -296,7 +296,7 @@ pe-brian:
 maxscheijen:
   login: maxscheijen
   count: 3
-  avatarUrl: https://avatars.githubusercontent.com/u/47034840?u=eb98f37882528ea349ca4e5255fa64ac3fef0294&v=4
+  avatarUrl: https://avatars.githubusercontent.com/u/47034840?v=4
   url: https://github.com/maxscheijen
 ilacftemp:
   login: ilacftemp
@@ -343,6 +343,11 @@ Rishat-F:
   count: 3
   avatarUrl: https://avatars.githubusercontent.com/u/66554797?v=4
   url: https://github.com/Rishat-F
+ruzia:
+  login: ruzia
+  count: 3
+  avatarUrl: https://avatars.githubusercontent.com/u/24503?v=4
+  url: https://github.com/ruzia
 izaguerreiro:
   login: izaguerreiro
   count: 2
@@ -523,3 +528,8 @@ EgorOnishchuk:
   count: 2
   avatarUrl: https://avatars.githubusercontent.com/u/120256301?v=4
   url: https://github.com/EgorOnishchuk
+NavesSapnis:
+  login: NavesSapnis
+  count: 2
+  avatarUrl: https://avatars.githubusercontent.com/u/79222417?u=b5b10291b8e9130ca84fd20f0a641e04ed94b6b1&v=4
+  url: https://github.com/NavesSapnis

docs/en/docs/index.md

@@ -468,15 +468,20 @@ Used by Starlette:
 * <a href="https://jinja.palletsprojects.com" target="_blank"><code>jinja2</code></a> - Required if you want to use the default template configuration.
 * <a href="https://github.com/Kludex/python-multipart" target="_blank"><code>python-multipart</code></a> - Required if you want to support form <abbr title="converting the string that comes from an HTTP request into Python data">"parsing"</abbr>, with `request.form()`.
 
-Used by FastAPI / Starlette:
+Used by FastAPI:
 
 * <a href="https://www.uvicorn.org" target="_blank"><code>uvicorn</code></a> - for the server that loads and serves your application. This includes `uvicorn[standard]`, which includes some dependencies (e.g. `uvloop`) needed for high performance serving.
-* `fastapi-cli` - to provide the `fastapi` command.
+* `fastapi-cli[standard]` - to provide the `fastapi` command.
+    * This includes `fastapi-cloud-cli`, which allows you to deploy your FastAPI application to <a href="https://fastapicloud.com" class="external-link" target="_blank">FastAPI Cloud</a>.
 
 ### Without `standard` Dependencies
 
 If you don't want to include the `standard` optional dependencies, you can install with `pip install fastapi` instead of `pip install "fastapi[standard]"`.
 
+### Without `fastapi-cloud-cli`
+
+If you want to install FastAPI with the standard dependencies but without the `fastapi-cloud-cli`, you can install with `pip install "fastapi[standard-no-fastapi-cloud-cli]"`.
+
 ### Additional Optional Dependencies
 
 There are some additional dependencies you might want to install.

docs/en/docs/release-notes.md

@@ -7,18 +7,57 @@ hide:
 
 ## Latest Changes
 
+## 0.116.0
+
+### Features
+
+* ✨ Add support for deploying to FastAPI Cloud with `fastapi deploy`. PR [#13870](https://github.com/fastapi/fastapi/pull/13870) by [@tiangolo](https://github.com/tiangolo).
+
+Installing `fastapi[standard]` now includes `fastapi-cloud-cli`.
+
+This will allow you to deploy to [FastAPI Cloud](https://fastapicloud.com) with the `fastapi deploy` command.
+
+If you want to install `fastapi` with the standard dependencies but without `fastapi-cloud-cli`, you can install instead `fastapi[standard-no-fastapi-cloud-cli]`.
+
+### Translations
+
+* 🌐 Add Russian translation for `docs/ru/docs/advanced/response-directly.md`. PR [#13801](https://github.com/fastapi/fastapi/pull/13801) by [@NavesSapnis](https://github.com/NavesSapnis).
+* 🌐 Add Russian translation for `docs/ru/docs/advanced/additional-status-codes.md`. PR [#13799](https://github.com/fastapi/fastapi/pull/13799) by [@NavesSapnis](https://github.com/NavesSapnis).
+* 🌐 Add Ukrainian translation for `docs/uk/docs/tutorial/body-updates.md`. PR [#13804](https://github.com/fastapi/fastapi/pull/13804) by [@valentinDruzhinin](https://github.com/valentinDruzhinin).
+
+### Internal
+
+* ⬆ Bump pillow from 11.1.0 to 11.3.0. PR [#13852](https://github.com/fastapi/fastapi/pull/13852) by [@dependabot[bot]](https://github.com/apps/dependabot).
+* 👥 Update FastAPI People - Sponsors. PR [#13846](https://github.com/fastapi/fastapi/pull/13846) by [@tiangolo](https://github.com/tiangolo).
+* 👥 Update FastAPI GitHub topic repositories. PR [#13848](https://github.com/fastapi/fastapi/pull/13848) by [@tiangolo](https://github.com/tiangolo).
+* ⬆ Bump mkdocs-material from 9.6.1 to 9.6.15. PR [#13849](https://github.com/fastapi/fastapi/pull/13849) by [@dependabot[bot]](https://github.com/apps/dependabot).
+* ⬆ [pre-commit.ci] pre-commit autoupdate. PR [#13843](https://github.com/fastapi/fastapi/pull/13843) by [@pre-commit-ci[bot]](https://github.com/apps/pre-commit-ci).
+* 👥 Update FastAPI People - Contributors and Translators. PR [#13845](https://github.com/fastapi/fastapi/pull/13845) by [@tiangolo](https://github.com/tiangolo).
+
+## 0.115.14
+
+### Fixes
+
+* 🐛 Fix support for unions when using `Form`. PR [#13827](https://github.com/fastapi/fastapi/pull/13827) by [@patrick91](https://github.com/patrick91).
+
 ### Docs
 
-* Misprint. PR [#13800](https://github.com/fastapi/fastapi/pull/13800) by [@NavesSapnis](https://github.com/NavesSapnis).
+* ✏️ Fix grammar mistake in `docs/en/docs/advanced/response-directly.md`. PR [#13800](https://github.com/fastapi/fastapi/pull/13800) by [@NavesSapnis](https://github.com/NavesSapnis).
 * 📝 Update Speakeasy URL to Speakeasy Sandbox. PR [#13697](https://github.com/fastapi/fastapi/pull/13697) by [@ndimares](https://github.com/ndimares).
 
 ### Translations
 
+* 🌐 Add Ukrainian translation for `docs/uk/docs/tutorial/response-model.md`. PR [#13792](https://github.com/fastapi/fastapi/pull/13792) by [@valentinDruzhinin](https://github.com/valentinDruzhinin).
+* 🌐 Add Ukrainian translation for `docs/uk/docs/tutorial/security/index.md`. PR [#13805](https://github.com/fastapi/fastapi/pull/13805) by [@valentinDruzhinin](https://github.com/valentinDruzhinin).
 * ✏️ Fix typo in `docs/ja/docs/tutorial/encoder.md`. PR [#13815](https://github.com/fastapi/fastapi/pull/13815) by [@ruzia](https://github.com/ruzia).
 * ✏️ Fix typo in `docs/ja/docs/tutorial/handling-errors.md`. PR [#13814](https://github.com/fastapi/fastapi/pull/13814) by [@ruzia](https://github.com/ruzia).
 * ✏️ Fix typo in `docs/ja/docs/tutorial/body-fields.md`. PR [#13802](https://github.com/fastapi/fastapi/pull/13802) by [@ruzia](https://github.com/ruzia).
 * 🌐 Add Russian translation for `docs/ru/docs/advanced/index.md`. PR [#13797](https://github.com/fastapi/fastapi/pull/13797) by [@NavesSapnis](https://github.com/NavesSapnis).
 
+### Internal
+
+* ⬆ [pre-commit.ci] pre-commit autoupdate. PR [#13823](https://github.com/fastapi/fastapi/pull/13823) by [@pre-commit-ci[bot]](https://github.com/apps/pre-commit-ci).
+
 ## 0.115.13
 
 ### Fixes

docs/en/docs/tutorial/index.md

@@ -76,10 +76,12 @@ $ pip install "fastapi[standard]"
 
 /// note
 
-When you install with `pip install "fastapi[standard]"` it comes with some default optional standard dependencies.
+When you install with `pip install "fastapi[standard]"` it comes with some default optional standard dependencies, including `fastapi-cloud-cli`, which allows you to deploy to <a href="https://fastapicloud.com" class="external-link" target="_blank">FastAPI Cloud</a>.
 
 If you don't want to have those optional dependencies, you can instead install `pip install fastapi`.
 
+If you want to install the standard dependencies but without the `fastapi-cloud-cli`, you can install with `pip install "fastapi[standard-no-fastapi-cloud-cli]"`.
+
 ///
 
 ## Advanced User Guide

docs/ru/docs/advanced/additional-status-codes.md

@@ -0,0 +1,41 @@
+# Дополнительные статус коды
+
+По умолчанию **FastAPI** возвращает ответы, используя `JSONResponse`, помещая содержимое, которое вы возвращаете из вашей *операции пути*, внутрь этого `JSONResponse`.
+
+Он будет использовать код статуса по умолчанию или тот, который вы укажете в вашей *операции пути*.
+
+## Дополнительные статус коды
+
+Если вы хотите возвращать дополнительный статус код помимо основного, вы можете сделать это, возвращая объект `Response` напрямую, как `JSONResponse`, и устанавливая нужный статус код напрямую.
+
+Например, скажем, вы хотите создать *операцию пути*, которая позволяет обновлять элементы и возвращает HTTP-код 200 "OK" при успешном выполнении.
+
+Но вы также хотите, чтобы она принимала новые элементы. И если элемент ранее не существовал, он создаётся, и возвращался HTTP-код 201 "Created".
+
+Чтобы реализовать это, импортируйте `JSONResponse` и возвращайте ваш контент напрямую, устанавливая нужный `status_code`:
+
+{* ../../docs_src/additional_status_codes/tutorial001_an_py310.py hl[4,25] *}
+
+/// warning | Внимание
+
+Когда вы возвращаете объект `Response` напрямую, как в примере выше, он будет возвращён как есть.
+
+Он не будет сериализован при помощи модели и т.д.
+
+Убедитесь, что в нём содержатся именно те данные, которые вы хотите, и что значения являются валидным JSON (если вы используете `JSONResponse`).
+
+///
+
+/// note | Технические детали
+
+Вы также можете использовать `from starlette.responses import JSONResponse`.
+
+**FastAPI** предоставляет тот же `starlette.responses` через `fastapi.responses` просто для вашего удобства, как разработчика. Но большинство доступных Response-классов поступают напрямую из Starlette. То же самое касается и `status`.
+
+///
+
+## OpenAPI и документация API
+
+Если вы возвращаете дополнительные коды статусов и ответы напрямую, они не будут включены в схему OpenAPI (документацию API), потому что FastAPI не может заранее знать, что вы собираетесь вернуть.
+
+Но вы можете задокументировать это в вашем коде, используя: [Дополнительные ответы в OpenAPI](additional-responses.md){.internal-link target=_blank}.

docs/ru/docs/advanced/response-directly.md

@@ -0,0 +1,65 @@
+# Возврат ответа напрямую
+
+Когда вы создаёте **FastAPI** *операцию пути*, вы можете возвращать из неё любые данные: `dict`, `list`, Pydantic-модель, модель базы данных и т.д.
+
+По умолчанию **FastAPI** автоматически преобразует возвращаемое значение в JSON с помощью `jsonable_encoder`, как описано в [JSON кодировщик](../tutorial/encoder.md){.internal-link target=_blank}.
+
+Затем "под капотом" эти данные, совместимые с JSON (например `dict`), помещаются в `JSONResponse`, который используется для отправки ответа клиенту.
+
+Но вы можете возвращать `JSONResponse` напрямую из ваших *операций пути*.
+
+Это может быть полезно, например, если нужно вернуть пользовательские заголовки или куки.
+
+## Возврат `Response`
+
+На самом деле, вы можете возвращать любой объект `Response` или его подкласс.
+
+/// tip | Подсказка
+
+`JSONResponse` сам по себе является подклассом `Response`.
+
+///
+
+И когда вы возвращаете `Response`, **FastAPI** передаст его напрямую.
+
+Это не приведет к преобразованию данных с помощью Pydantic-моделей, содержимое не будет преобразовано в какой-либо тип и т.д.
+
+Это даёт вам большую гибкость. Вы можете возвращать любые типы данных, переопределять любые объявления или валидацию данных и т.д.
+
+## Использование `jsonable_encoder` в `Response`
+
+Поскольку **FastAPI** не изменяет объект `Response`, который вы возвращаете, вы должны убедиться, что его содержимое готово к отправке.
+
+Например, вы не можете поместить Pydantic-модель в `JSONResponse`, не преобразовав её сначала в `dict` с помощью преобразования всех типов данных (таких как `datetime`, `UUID` и т.д.) в совместимые с JSON типы.
+
+В таких случаях вы можете использовать `jsonable_encoder` для преобразования данных перед передачей их в ответ:
+
+{* ../../docs_src/response_directly/tutorial001.py hl[6:7,21:22] *}
+
+/// note | Технические детали
+
+Вы также можете использовать `from starlette.responses import JSONResponse`.
+
+**FastAPI** предоставляет `starlette.responses` через `fastapi.responses` просто для вашего удобства, как разработчика. Но большинство доступных Response-классов поступают напрямую из Starlette.
+
+///
+
+## Возврат пользовательского `Response`
+
+Пример выше показывает все необходимые части, но он пока не очень полезен, так как вы могли бы просто вернуть `item` напрямую, и **FastAPI** поместил бы его в `JSONResponse`, преобразовав в `dict` и т.д. Всё это происходит по умолчанию.
+
+Теперь давайте посмотрим, как можно использовать это для возврата пользовательского ответа.
+
+Допустим, вы хотите вернуть ответ в формате <a href="https://en.wikipedia.org/wiki/XML" class="external-link" target="_blank">XML</a>.
+
+Вы можете поместить ваш XML-контент в строку, поместить её в `Response` и вернуть:
+
+{* ../../docs_src/response_directly/tutorial002.py hl[1,18] *}
+
+## Примечания
+
+Когда вы возвращаете объект `Response` напрямую, его данные не валидируются, не преобразуются (не сериализуются) и не документируются автоматически.
+
+Но вы всё равно можете задокументировать это, как описано в [Дополнительные ответы в OpenAPI](additional-responses.md){.internal-link target=_blank}.
+
+В следующих разделах вы увидите, как использовать/объявлять такие кастомные `Response`, при этом сохраняя автоматическое преобразование данных, документацию и т.д.

docs/uk/docs/tutorial/body-updates.md

@@ -0,0 +1,116 @@
+# Тіло – Оновлення
+
+## Оновлення з використанням `PUT`
+
+Щоб оновити елемент, Ви можете використати <a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Methods/PUT" class="external-link" target="_blank">HTTP `PUT`</a> операцію.
+
+Ви можете використати `jsonable_encoder`, щоб перетворити вхідні дані на такі, які можна зберігати як JSON (наприклад, у NoSQL базі даних). Наприклад, перетворюючи `datetime` у `str`.
+
+{* ../../docs_src/body_updates/tutorial001_py310.py hl[28:33] *}
+
+`PUT` використовується для отримання даних, які мають замінити чинні дані.
+
+### Попередження про заміну
+
+Це означає, що якщо Ви хочете оновити елемент `bar`, використовуючи `PUT` з тілом:
+
+```Python
+{
+    "name": "Barz",
+    "price": 3,
+    "description": None,
+}
+```
+
+оскільки він не містить вже збереженого атрибута `"tax": 20.2`, модель введення прийме значення за замовчуванням `"tax": 10.5`.
+
+І дані будуть збережені з цим "новим" значенням `tax` = `10.5`.
+
+## Часткові оновлення з `PATCH`
+
+Ви також можете використовувати операцію <a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Methods/PATCH" class="external-link" target="_blank">HTTP `PATCH`</a> для *часткового* оновлення даних.
+
+Це означає, що Ви можете надіслати лише ті дані, які хочете оновити, залишаючи інші без змін.
+
+/// note | Примітка
+
+`PATCH` менш відомий і рідше використовується, ніж `PUT`.
+
+І багато команд використовують лише `PUT`, навіть для часткових оновлень.
+
+Ви **вільні** використовувати їх так, як хочете, **FastAPI** не накладає обмежень.
+
+Але цей посібник показує Вам більш-менш як їх задумано використовувати.
+
+///
+
+### Використання параметра `exclude_unset` у Pydantic
+
+Якщо Ви хочете отримати часткові оновлення, дуже зручно використовувати параметр `exclude_unset` у методі `.model_dump()` моделі Pydantic.
+
+Наприклад: `item.model_dump(exclude_unset=True)`.
+
+/// info | Інформація
+
+У Pydantic v1 цей метод називався `.dict()`, він був застарілий (але все ще підтримується) у Pydantic v2, і був перейменований у `.model_dump()`.
+
+Приклади тут використовують `.dict()` для сумісності з Pydantic v1, але Вам слід використовувати `.model_dump()`, якщо можете використовувати Pydantic v2.
+
+///
+
+Це створить `dict` лише з тими даними, які були явно встановлені під час створення моделі `item`, виключаючи значення за замовчуванням.
+
+Тоді Ви можете використовувати це, щоб створити `dict` лише з даними, які були встановлені (надіслані у запиті), пропускаючи значення за замовчуванням:
+
+{* ../../docs_src/body_updates/tutorial002_py310.py hl[32] *}
+
+### Використання параметра `update` у Pydantic
+
+Тепер Ви можете створити копію наявної моделі за допомогою `.model_copy()`, і передати параметр `update` з `dict` , який містить дані для оновлення.
+
+/// info | Інформація
+
+У Pydantic v1 метод називався `.copy()`, він був застарілий (але все ще підтримується) у Pydantic v2, і був перейменований у `.model_copy()`.
+
+Приклади тут використовують `.copy()` для сумісності з Pydantic v1, але якщо Ви можете використовувати Pydantic v2 — Вам слід використовувати `.model_copy()` замість цього.
+
+///
+
+Наприклад: `stored_item_model.model_copy(update=update_data)`:
+
+{* ../../docs_src/body_updates/tutorial002_py310.py hl[33] *}
+
+### Підсумок часткових оновлень
+
+У підсумку, щоб застосувати часткові оновлення, Ви:
+
+* (Опціонально) використовуєте `PATCH` замість `PUT`.
+* Отримуєте збережені дані.
+* Поміщаєте ці дані в модель Pydantic.
+* Генеруєте `dict` без значень за замовчуванням з моделі введення (використовуючи `exclude_unset`).
+    * Таким чином Ви оновите лише ті значення, які були явно задані користувачем, замість того, щоб перезаписувати вже збережені значення значеннями за замовчуванням з вашої моделі.
+* Створюєте копію збереженої моделі, оновлюючи її атрибути отриманими частковими оновленнями (використовуючи параметр `update`).
+* Перетворюєте скопійовану модель на щось, що можна зберегти у вашу БД (наприклад, використовуючи `jsonable_encoder`).
+    * Це можна порівняти з повторним використанням методу `.model_dump()` моделі, але це гарантує (і перетворює) значення у типи даних, які можна перетворити на JSON, наприклад, `datetime` на `str`.
+* Зберігаєте дані у вашу БД.
+* Повертаєте оновлену модель.
+
+{* ../../docs_src/body_updates/tutorial002_py310.py hl[28:35] *}
+
+/// tip | Порада
+
+Насправді Ви можете використовувати цю саму техніку і з операцією HTTP `PUT`.
+
+Але приклад тут використовує `PATCH`, тому що він був створений саме для таких випадків.
+
+///
+
+/// note | Примітка
+
+Зверніть увагу, що модель запиту все ще проходить валідацію.
+
+Тож, якщо Ви хочете отримувати часткові оновлення, які можуть не містити жодного атрибута, Вам потрібно мати модель, де всі атрибути позначені як необов’язкові (зі значеннями за замовчуванням або `None`).
+
+Щоб розрізняти моделі з усіма необов’язковими значеннями для **оновлення** і моделі з обов’язковими значеннями для **створення**, Ви можете скористатись ідеями, описаними у [Додаткові моделі](extra-models.md){.internal-link target=_blank}.
+
+///

docs/uk/docs/tutorial/response-model.md

@@ -0,0 +1,358 @@
+# Модель відповіді — Тип, що повертається
+
+Ви можете оголосити тип, який використовуватиметься у відповіді, за допомогою *анотації типу, що повертається* *функцією операцією шляху* (path operation)
+
+**Анотацію типу** можна вказати так само як і для вхідних **параметрів** функції: це можуть бути моделі Pydantic, списки (lists), словники (dictionaries), скалярні значення, як-от цілі числа (integers), булеві значення (booleans) тощо.
+
+{* ../../docs_src/response_model/tutorial001_01_py310.py hl[16,21] *}
+
+FastAPI використовуватиме цей тип, щоб:
+
+* **Перевірити правильність** повернених даних.
+    * Якщо дані не валідні (наприклад, відсутнє поле), це означає, що Ваш код додатку працює некоректно і не повертає те, що повинен. У такому випадку FastAPI поверне помилку сервера, замість того щоб віддати недопустимі дані. Так Ви та Ваші клієнти будете впевнені, що отримуєте очікувані дані у правильному форматі.
+
+* Додати **JSON Schema** відповіді до специфікації OpenAPI в *операціях шляху*.
+    * Це буде використано в **автоматичній документації**.
+    * А також інструментами, які автоматично генерують клієнтський код.
+
+Але найголовніше:
+
+* FastAPI **обмежить та відфільтрує** вихідні дані відповідно до типу, вказаного у відповіді.
+    * Це особливо важливо для **безпеки**. Деталі нижче.
+
+## Параметр `response_model`
+
+Іноді Вам потрібно або зручно повертати інші типи даних, ніж ті, що зазначені як тип відповіді.
+
+Наприклад, Ви можете **повертати словник** або об’єкт бази даних, але **оголосити модель Pydantic** як модель відповіді. Тоді модель Pydantic автоматично оброблятиме валідацію, документацію тощо.
+
+Якщо Ви додасте анотацію типу для повернення, редактор коду або mypy можуть поскаржитися, що функція повертає інший тип (наприклад, dict замість Item).
+
+У таких випадках можна скористатися параметром `response_model` в декораторі маршруту (наприклад, @app.get()).
+
+Параметр `response_model` працює з будь-яким *оператором шляху*:
+
+* `@app.get()`
+* `@app.post()`
+* `@app.put()`
+* `@app.delete()`
+* тощо.
+
+{* ../../docs_src/response_model/tutorial001_py310.py hl[17,22,24:27] *}
+
+/// note | Примітка
+
+Зверніть увагу, що `response_model` є параметром методу-декоратора (`get`, `post`, тощо), а не *функцією операцією шляху* (path operation function), як це робиться з параметрами або тілом запиту.
+
+///
+
+`response_model` приймає такий самий тип, який Ви б вказали для поля моделі Pydantic. Тобто це може бути як Pydantic-модель, так і, наприклад, `list` із моделей Pydantic — `List[Item]`.
+
+FastAPI використовуватиме `response_model` для створення документації, валідації даних та — найважливіше — **перетворення та фільтрації вихідних даних** згідно з оголошеним типом.
+
+/// tip | Порада
+
+Якщо у Вас увімкнено сувору перевірку типів у редакторі, mypy тощо, Ви можете оголосити тип повернення функції як `Any`.
+
+Таким чином, Ви повідомляєте редактору, що свідомо повертаєте будь-що. Але FastAPI усе одно виконуватиме створення документації, валідацію, фільтрацію тощо за допомогою параметра `response_model`.
+
+///
+
+### Пріоритет `response_model`
+
+Якщо Ви вказуєте і тип повернення, і `response_model`, то FastAPI використовуватиме `response_model` з пріоритетом.
+
+Таким чином, Ви можете додати правильні анотації типів до ваших функцій, навіть якщо вони повертають тип, відмінний від `response_model`. Це буде корисно для редакторів коду та інструментів, таких як mypy. І при цьому FastAPI продовжить виконувати валідацію даних, генерувати документацію тощо на основі `response_model`.
+
+Ви також можете використати `response_model=None`, щоб вимкнути створення моделі відповіді для цієї *операції шляху*. Це може знадобитися, якщо Ви додаєте анотації типів до об'єктів, які не є допустимими полями Pydantic — приклад цього Ви побачите в одному з наступних розділів.
+
+## Повернути ті самі вхідні дані
+
+Тут ми оголошуємо модель `UserIn`, яка містить звичайний текстовий пароль:
+
+{* ../../docs_src/response_model/tutorial002_py310.py hl[7,9] *}
+
+/// info | Інформація
+
+Щоб використовувати `EmailStr`, спочатку встановіть <a href="https://github.com/JoshData/python-email-validator" class="external-link" target="_blank">`email-validator`</a>.
+
+Переконайтесь, що Ви створили [віртуальне середовище](../virtual-environments.md){.internal-link target=_blank}, активували його, а потім встановили пакет, наприклад:
+
+```console
+$ pip install email-validator
+```
+
+or with:
+
+```console
+$ pip install "pydantic[email]"
+```
+
+///
+
+І ми використовуємо цю модель, щоб оголосити і вхідні, і вихідні дані:
+
+{* ../../docs_src/response_model/tutorial002_py310.py hl[16] *}
+
+Тепер, коли браузер створює користувача з паролем, API поверне той самий пароль у відповіді.
+
+У цьому випадку це може не бути проблемою, адже саме користувач надіслав пароль.
+
+Але якщо ми використаємо цю ж модель для іншої операції шляху, ми можемо випадково надіслати паролі наших користувачів кожному клієнту.
+
+/// danger | Обережно
+
+Ніколи не зберігайте пароль користувача у відкритому вигляді та не надсилайте його у відповіді, якщо тільки Ви не знаєте всі ризики і точно розумієте, що робите.
+
+///
+
+## Додайте окрему вихідну модель
+
+Замість цього ми можемо створити вхідну модель з відкритим паролем і вихідну модель без нього:
+
+{* ../../docs_src/response_model/tutorial003_py310.py hl[9,11,16] *}
+
+Тут, навіть якщо *функція операції шляху* повертає об'єкт користувача, який містить пароль:
+
+{* ../../docs_src/response_model/tutorial003_py310.py hl[24] *}
+
+...ми оголосили `response_model` як нашу модель `UserOut`, яка не містить пароля:
+
+{* ../../docs_src/response_model/tutorial003_py310.py hl[22] *}
+
+Таким чином, **FastAPI** автоматично відфільтрує всі дані, які не вказані у вихідній моделі (за допомогою Pydantic).
+
+### `response_model` або тип повернення
+
+У цьому випадку, оскільки дві моделі різні, якщо ми анотуємо тип повернення функції як `UserOut`, редактор і такі інструменти, як mypy, видадуть помилку, бо фактично ми повертаємо інший тип.
+
+Тому в цьому прикладі ми використовуємо параметр `response_model`, а не анотацію типу повернення.
+
+...але читайте далі, щоб дізнатися, як обійти це обмеження.
+
+## Тип повернення і фільтрація даних
+
+Продовжимо з попереднього прикладу. Ми хотіли **анотувати функцію одним типом**, але при цьому повертати з неї більше даних.
+
+Ми хочемо, щоб FastAPI продовжував **фільтрувати** ці дані за допомогою response_model. Тобто навіть якщо функція повертає більше інформації, у відповіді будуть лише ті поля, які вказані у response_model.
+
+У попередньому прикладі, оскільки класи були різні, нам довелося використовувати параметр `response_model`. Але це означає, що ми не отримуємо підтримки з боку редактора коду та інструментів перевірки типів щодо типу, який повертає функція.
+
+Проте в більшості випадків, коли нам потрібно зробити щось подібне, ми просто хочемо, щоб модель **відфільтрувала або прибрала** частину даних, як у цьому прикладі.
+
+У таких випадках ми можемо використати класи та спадкування, щоб скористатися **анотаціями типів** функцій — це дає кращу підтримку з боку редактора та інструментів типу mypy, і при цьому FastAPI продовжує виконувати **фільтрацію даних** у відповіді.
+
+{* ../../docs_src/response_model/tutorial003_01_py310.py hl[7:10,13:14,18] *}
+
+Завдяки цьому ми отримуємо підтримку інструментів — від редакторів і mypy, оскільки цей код є коректним з точки зору типів, — але ми також отримуємо фільтрацію даних від FastAPI.
+
+Як це працює? Давайте розберемося. 🤓
+
+### Типи та підтримка інструментів
+
+Спершу подивимось, як це бачать редактори, mypy та інші інструменти.
+
+`BaseUser` має базові поля. Потім `UserIn` успадковує `BaseUser` і додає поле `password`, отже, він матиме всі поля з обох моделей.
+
+Ми зазначаємо тип повернення функції як `BaseUser`, але фактично повертаємо екземпляр `UserIn`.
+
+Редактор, mypy та інші інструменти не скаржитимуться на це, тому що з точки зору типізації `UserIn` є підкласом `BaseUser`, а це означає, що він є `валідним` типом, коли очікується будь-що, що є `BaseUser`.
+
+### Фільтрація даних у FastAPI
+
+Тепер для FastAPI він бачить тип повернення і переконується, що те, що Ви повертаєте, містить **тільки** поля, які оголошені у цьому типі.
+
+FastAPI виконує кілька внутрішніх операцій з Pydantic, щоб гарантувати, що правила наслідування класів не застосовуються для фільтрації повернених даних, інакше Ви могли б повернути значно більше даних, ніж очікували.
+
+Таким чином, Ви отримуєте найкраще з двох світів: анотації типів **з підтримкою інструментів** і **фільтрацію даних**.
+
+## Подивитись у документації
+
+Коли Ви дивитесь автоматичну документацію, Ви можете побачити, що вхідна модель і вихідна модель мають власну JSON-схему:
+
+<img src="/img/tutorial/response-model/image01.png">
+
+І обидві моделі використовуються для інтерактивної API-документації:
+
+<img src="/img/tutorial/response-model/image02.png">
+
+## Інші анотації типів повернення
+
+Існують випадки, коли Ви повертаєте щось, що не є допустимим полем Pydantic, але анотуєте це у функції лише для того, щоб отримати підтримку від інструментів (редактора, mypy тощо).
+
+### Повернення Response напряму
+
+Найпоширенішим випадком буде [повернення Response напряму, як пояснюється пізніше у розширеній документації](../advanced/response-directly.md){.internal-link target=_blank}.
+
+{* ../../docs_src/response_model/tutorial003_02.py hl[8,10:11] *}
+
+Цей простий випадок автоматично обробляється FastAPI, тому що анотація типу повернення — це клас (або підклас) `Response`.
+
+І інструменти також будуть задоволені, бо і `RedirectResponse`, і `JSONResponse` є підкласами `Response`, отже анотація типу коректна.
+
+### Анотація підкласу Response
+
+Також можна використовувати підклас `Response` у анотації типу:
+
+{* ../../docs_src/response_model/tutorial003_03.py hl[8:9] *}
+
+Це теж працюватиме, бо `RedirectResponse` — підклас `Response`, і FastAPI автоматично обробить цей простий випадок.
+
+### Некоректні анотації типу повернення
+
+Але коли Ви повертаєте якийсь інший довільний об’єкт, що не є валідним типом Pydantic (наприклад, об’єкт бази даних), і анотуєте його так у функції, FastAPI спробує створити Pydantic модель відповіді на основі цієї анотації типу, і це завершиться помилкою.
+
+Те саме станеться, якщо Ви використовуєте <abbr title="Об'єднання (union) кількох типів означає: «будь-який з цих типів».">union</abbr> між різними типами, де один або більше не є валідними типами Pydantic, наприклад, це спричинить помилку 💥:
+
+{* ../../docs_src/response_model/tutorial003_04_py310.py hl[8] *}
+
+...це не працює, тому що тип анотації не є типом Pydantic і не є просто класом `Response` або його підкласом, а є об’єднанням (union) — або `Response`, або `dict`.
+
+### Відключення Моделі Відповіді
+
+Продовжуючи приклад вище, можливо, Ви не хочете використовувати стандартну валідацію даних, автоматичну документацію, фільтрацію тощо, які FastAPI виконує за замовчуванням.
+
+Але ви все одно можете залишити анотацію типу у функції, щоб зберегти підтримку з боку інструментів, таких як редактори коду або статичні перевірки типів (наприклад, mypy).
+
+У такому випадку ви можете вимкнути генерацію моделі відповіді, встановивши `response_model=None`:
+
+{* ../../docs_src/response_model/tutorial003_05_py310.py hl[7] *}
+
+Це змусить FastAPI пропустити генерацію моделі відповіді, і таким чином Ви зможете використовувати будь-які анотації типів повернення без впливу на вашу FastAPI аплікацію. 🤓
+
+## Параметри кодування моделі відповіді
+
+Ваша модель відповіді може мати значення за замовчуванням, наприклад:
+
+{* ../../docs_src/response_model/tutorial004_py310.py hl[9,11:12] *}
+
+* `description: Union[str, None] = None` (або `str | None = None` у Python 3.10) має значення за замовчуванням `None`.
+* `tax: float = 10.5` має значення за замовчуванням `10.5`.
+* `tags: List[str] = []` має значення за замовчуванням порожній список: `[]`.
+
+Але Ви можете захотіти не включати їх у результат, якщо вони фактично не були збережені.
+
+Наприклад, якщо у Вас є моделі з багатьма необов’язковими атрибутами у NoSQL базі даних, але Ви не хочете відправляти дуже довгі JSON-відповіді, повні значень за замовчуванням.
+
+### Використовуйте параметр `response_model_exclude_unset`
+
+Ви можете встановити параметр декоратора шляху `response_model_exclude_unset=True`:
+
+{* ../../docs_src/response_model/tutorial004_py310.py hl[22] *}
+
+і ці значення за замовчуванням не будуть включені у відповідь, тільки фактично встановлені значення.
+
+Отже, якщо Ви надішлете запит до цього оператора шляху для елемента з item_id `foo`, відповідь (без включення значень за замовчуванням) буде:
+
+```JSON
+{
+    "name": "Foo",
+    "price": 50.2
+}
+```
+
+/// info | Інформація
+
+У Pydantic версії 1 метод називався `.dict()`, він був застарілий (але ще підтримується) у Pydantic версії 2 і перейменований у `.model_dump()`.
+
+Приклади тут використовують `.dict()` для сумісності з Pydantic v1, але Вам слід використовувати `.model_dump()`, якщо Ви можете використовувати Pydantic v2.
+
+///
+
+/// info | Інформація
+
+FastAPI використовує `.dict()` моделі Pydantic з <a href="https://docs.pydantic.dev/1.10/usage/exporting_models/#modeldict" class="external-link" target="_blank">параметром `exclude_unset`</a>, щоб досягти цього.
+
+///
+
+/// info | Інформація
+
+Ви також можете використовувати:
+
+* `response_model_exclude_defaults=True`
+* `response_model_exclude_none=True`
+
+як описано в <a href="https://docs.pydantic.dev/1.10/usage/exporting_models/#modeldict" class="external-link" target="_blank">документації Pydantic</a> for `exclude_defaults` та `exclude_none`.
+
+///
+
+#### Дані зі значеннями для полів із типовими значеннями
+
+Але якщо Ваші дані мають значення для полів моделі з типовими значеннями, як у елемента з item_id `bar`:
+
+```Python hl_lines="3  5"
+{
+    "name": "Bar",
+    "description": "The bartenders",
+    "price": 62,
+    "tax": 20.2
+}
+```
+вони будуть включені у відповідь.
+
+#### Дані з тими самими значеннями, що й типові
+
+Якщо дані мають ті самі значення, що й типові, як у елемента з item_id `baz`:
+
+```Python hl_lines="3  5-6"
+{
+    "name": "Baz",
+    "description": None,
+    "price": 50.2,
+    "tax": 10.5,
+    "tags": []
+}
+```
+
+FastAPI достатньо розумний (насправді, Pydantic достатньо розумний), щоб зрозуміти, що, хоча `description`, `tax` і `tags` мають ті самі значення, що й типові, вони були встановлені явно (а не взяті як значення за замовчуванням).
+
+Отже, вони будуть включені у JSON-відповідь.
+
+/// tip | Порада
+
+Зверніть увагу, що типові значення можуть бути будь-якими, не лише `None`.
+
+Це може бути list (`[]`), `float` 10.5 тощо.
+
+///
+
+### `response_model_include` та `response_model_exclude`
+
+Ви також можете використовувати параметри *декоратора операції шляху* `response_model_include` та `response_model_exclude`.
+
+Вони приймають `set` (множину) рядків (`str`) з іменами атрибутів, які потрібно включити (пропускаючи інші) або виключити (включаючи інші).
+
+Це можна використовувати як швидкий спосіб, якщо у Вас є лише одна модель Pydantic і Ви хочете видалити деякі дані з виводу.
+
+/// tip | Порада
+
+Але все ж рекомендується використовувати описані вище підходи, із застосуванням кількох класів, замість цих параметрів.
+
+
+Це тому, що JSON Schema, який генерується у вашому OpenAPI додатку (і в документації), все одно буде відповідати повній моделі, навіть якщо Ви використовуєте `response_model_include` або `response_model_exclude` для виключення деяких атрибутів.
+
+Це також стосується `response_model_by_alias`, який працює подібним чином.
+
+///
+
+{* ../../docs_src/response_model/tutorial005_py310.py hl[29,35] *}
+
+/// tip | Порада
+
+Синтаксис `{"name", "description"}` створює `set` з цими двома значеннями.
+
+Він еквівалентний `set(["name", "description"])`.
+
+///
+
+#### Використання `list` замість `set`
+
+Якщо Ви забудете використати `set` і натомість застосуєте `list` або `tuple`, FastAPI все одно перетворить це на `set`, і все працюватиме правильно:
+
+{* ../../docs_src/response_model/tutorial006_py310.py hl[29,35] *}
+
+## Підсумок
+
+Використовуйте параметр `response_model` *декоратора операції шляху*, щоб визначати моделі відповіді, особливо щоб гарантувати фільтрацію приватних даних.
+
+Використовуйте `response_model_exclude_unset`, щоб повертати лише явно встановлені значення.

docs/uk/docs/tutorial/security/index.md

@@ -0,0 +1,104 @@
+# Безпека
+
+Існує багато способів реалізувати безпеку, автентифікацію та авторизацію.
+
+Це зазвичай складна і "непроста" тема.
+
+У багатьох фреймворках і системах забезпечення безпеки та автентифікації займає величезну частину зусиль і коду (іноді — понад 50% всього написаного коду).
+
+**FastAPI** надає кілька інструментів, які допоможуть Вам впоратися з **безпекою** легко, швидко, стандартним способом, без необхідності вивчати всі специфікації безпеки.
+
+Але спочатку — кілька коротких понять.
+
+## Поспішаєте?
+
+Якщо Вам не цікаві всі ці терміни й просто потрібно *швидко* додати автентифікацію за логіном і паролем — переходьте до наступних розділів.
+
+## OAuth2
+
+OAuth2 — це специфікація, що описує кілька способів обробки автентифікації та авторизації.
+
+Це досить об'ємна специфікація, яка охоплює складні випадки використання.
+
+Вона включає способи автентифікації через "третю сторону".
+
+Саме це лежить в основі "входу через Google, Facebook, X (Twitter), GitHub" тощо.
+
+### OAuth 1
+
+Раніше існував OAuth 1, який значно відрізняється від OAuth2 і є складнішим, оскільки містив специфікації для шифрування комунікацій.
+
+Зараз майже не використовується.
+
+OAuth2 не вказує, як саме шифрувати з'єднання — воно очікує, що ваш застосунок працює через HTTPS.
+
+/// tip | Порада
+
+У розділі про **деплой** Ви побачите, як налаштувати HTTPS безкоштовно з Traefik та Let's Encrypt.
+
+///
+
+## OpenID Connect
+
+OpenID Connect — ще одна специфікація, побудована на основі **OAuth2**.
+
+Вона розширює OAuth2, уточнюючи деякі неоднозначності для досягнення кращої сумісності.
+
+Наприклад, вхід через Google використовує OpenID Connect (який базується на OAuth2).
+
+Але вхід через Facebook — ні. Він має власну реалізацію на базі OAuth2.
+
+### OpenID (не "OpenID Connect")
+
+Існувала також специфікація "OpenID", яка намагалася розвʼязати ті самі задачі, що й **OpenID Connect**, але не базувалась на OAuth2.
+
+Це була зовсім інша система, і сьогодні вона майже не використовується.
+
+## OpenAPI
+
+OpenAPI (раніше Swagger) — це специфікація для побудови API (тепер під егідою Linux Foundation).
+
+**FastAPI** базується на **OpenAPI**.
+
+Завдяки цьому Ви отримуєте автоматичну інтерактивну документацію, генерацію коду та багато іншого.
+
+OpenAPI дозволяє описувати різні "схеми" безпеки.
+
+Використовуючи їх, Ви можете скористатися всіма цими інструментами, що базуються на стандартах, зокрема інтерактивними системами документації.
+
+OpenAPI визначає такі схеми безпеки:
+
+* `apiKey`: специфічний для застосунку ключ, який може передаватися через:
+    * Параметр запиту.
+    * Заголовок.
+    * Cookie.
+* `http`: стандартні методи HTTP-автентифікації, включаючи:
+    * `bearer`: заголовок `Authorization` зі значенням `Bearer` та токеном. Це успадковано з OAuth2.
+    * HTTP Basic автентифікація
+    * HTTP Digest, тощо.
+* `oauth2`: усі способи обробки безпеки за допомогою OAuth2 (так звані «потоки»).
+    * Деякі з цих потоків підходять для створення власного провайдера автентифікації OAuth 2.0 (наприклад, Google, Facebook, X (Twitter), GitHub тощо):
+        * `implicit`— неявний
+        * `clientCredentials`— облікові дані клієнта
+        * `authorizationCode` — код авторизації
+    * Але є один окремий «потік», який ідеально підходить для реалізації автентифікації всередині одного додатку:
+        * `password`: у наступних розділах буде приклад використання цього потоку.
+* `openIdConnect`: дозволяє автоматично виявляти параметри автентифікації OAuth2.
+    * Це автоматичне виявлення визначається у специфікації OpenID Connect.
+
+
+/// tip | Порада
+
+Інтеграція інших провайдерів автентифікації/авторизації, таких як Google, Facebook, X (Twitter), GitHub тощо — також можлива і відносно проста.
+
+Найскладніше — це створити власного провайдера автентифікації/авторизації, як Google чи Facebook. Але **FastAPI** надає Вам інструменти, щоб зробити це легко, беручи на себе важку частину роботи.
+
+///
+
+## Інструменти **FastAPI**
+
+FastAPI надає кілька інструментів для кожної з описаних схем безпеки в модулі `fastapi.security`, які спрощують використання цих механізмів захисту.
+
+У наступних розділах Ви побачите, як додати безпеку до свого API за допомогою цих інструментів **FastAPI**.
+
+А також побачите, як вона автоматично інтегрується в інтерактивну документацію вашого API.

fastapi/__init__.py

@@ -1,6 +1,6 @@
 """FastAPI framework, high performance, easy to learn, fast to code, ready for production"""
 
-__version__ = "0.115.13"
+__version__ = "0.116.0"
 
 from starlette import status as status
 

fastapi/dependencies/utils.py

@@ -816,6 +816,25 @@ def request_params_to_args(
     return values, errors
 
 
+def is_union_of_base_models(field_type: Any) -> bool:
+    """Check if field type is a Union where all members are BaseModel subclasses."""
+    from fastapi.types import UnionType
+
+    origin = get_origin(field_type)
+
+    # Check if it's a Union type (covers both typing.Union and types.UnionType in Python 3.10+)
+    if origin is not Union and origin is not UnionType:
+        return False
+
+    union_args = get_args(field_type)
+
+    for arg in union_args:
+        if not lenient_issubclass(arg, BaseModel):
+            return False
+
+    return True
+
+
 def _should_embed_body_fields(fields: List[ModelField]) -> bool:
     if not fields:
         return False
@@ -829,10 +848,12 @@ def _should_embed_body_fields(fields: List[ModelField]) -> bool:
     # If it explicitly specifies it is embedded, it has to be embedded
     if getattr(first_field.field_info, "embed", None):
         return True
-    # If it's a Form (or File) field, it has to be a BaseModel to be top level
+    # If it's a Form (or File) field, it has to be a BaseModel (or a union of BaseModels) to be top level
     # otherwise it has to be embedded, so that the key value pair can be extracted
-    if isinstance(first_field.field_info, params.Form) and not lenient_issubclass(
+    if (
-        first_field.type_, BaseModel
+        isinstance(first_field.field_info, params.Form)
+        and not lenient_issubclass(first_field.type_, BaseModel)
+        and not is_union_of_base_models(first_field.type_)
     ):
         return True
     return False

pyproject.toml

@@ -58,7 +58,26 @@ Changelog = "https://fastapi.tiangolo.com/release-notes/"
 [project.optional-dependencies]
 
 standard = [
-    "fastapi-cli[standard] >=0.0.5",
+    "fastapi-cli[standard] >=0.0.8",
+    # For the test client
+    "httpx >=0.23.0",
+    # For templates
+    "jinja2 >=3.1.5",
+    # For forms and file uploads
+    "python-multipart >=0.0.18",
+    # To validate email fields
+    "email-validator >=2.0.0",
+    # Uvicorn with uvloop
+    "uvicorn[standard] >=0.12.0",
+    # TODO: this should be part of some pydantic optional extra dependencies
+    # # Settings management
+    # "pydantic-settings >=2.0.0",
+    # # Extra Pydantic data types
+    # "pydantic-extra-types >=2.0.0",
+]
+
+standard-no-fastapi-cloud-cli = [
+    "fastapi-cli[standard-no-fastapi-cloud-cli] >=0.0.8",
     # For the test client
     "httpx >=0.23.0",
     # For templates
@@ -77,7 +96,7 @@ standard = [
 ]
 
 all = [
-    "fastapi-cli[standard] >=0.0.5",
+    "fastapi-cli[standard] >=0.0.8",
     # # For the test client
     "httpx >=0.23.0",
     # For templates

requirements-docs.txt

@@ -1,6 +1,6 @@
 -e .
 -r requirements-docs-tests.txt
-mkdocs-material==9.6.1
+mkdocs-material==9.6.15
 mdx-include >=1.4.1,<2.0.0
 mkdocs-redirects>=1.2.1,<1.3.0
 typer == 0.16.0
@@ -8,7 +8,7 @@ pyyaml >=5.3.1,<7.0.0
 # For Material for MkDocs, Chinese search
 jieba==0.42.1
 # For image processing by Material for MkDocs
-pillow==11.1.0
+pillow==11.3.0
 # For image processing by Material for MkDocs
 cairosvg==2.7.1
 mkdocstrings[python]==0.26.1

tests/test_union_forms.py

@@ -0,0 +1,156 @@
+from typing import Union
+
+from fastapi import FastAPI, Form
+from fastapi.testclient import TestClient
+from pydantic import BaseModel
+from typing_extensions import Annotated
+
+app = FastAPI()
+
+
+class UserForm(BaseModel):
+    name: str
+    email: str
+
+
+class CompanyForm(BaseModel):
+    company_name: str
+    industry: str
+
+
+@app.post("/form-union/")
+def post_union_form(data: Annotated[Union[UserForm, CompanyForm], Form()]):
+    return {"received": data}
+
+
+client = TestClient(app)
+
+
+def test_post_user_form():
+    response = client.post(
+        "/form-union/", data={"name": "John Doe", "email": "john@example.com"}
+    )
+    assert response.status_code == 200, response.text
+    assert response.json() == {
+        "received": {"name": "John Doe", "email": "john@example.com"}
+    }
+
+
+def test_post_company_form():
+    response = client.post(
+        "/form-union/", data={"company_name": "Tech Corp", "industry": "Technology"}
+    )
+    assert response.status_code == 200, response.text
+    assert response.json() == {
+        "received": {"company_name": "Tech Corp", "industry": "Technology"}
+    }
+
+
+def test_invalid_form_data():
+    response = client.post(
+        "/form-union/",
+        data={"name": "John", "company_name": "Tech Corp"},
+    )
+    assert response.status_code == 422, response.text
+
+
+def test_empty_form():
+    response = client.post("/form-union/")
+    assert response.status_code == 422, response.text
+
+
+def test_openapi_schema():
+    response = client.get("/openapi.json")
+    assert response.status_code == 200, response.text
+
+    assert response.json() == {
+        "openapi": "3.1.0",
+        "info": {"title": "FastAPI", "version": "0.1.0"},
+        "paths": {
+            "/form-union/": {
+                "post": {
+                    "summary": "Post Union Form",
+                    "operationId": "post_union_form_form_union__post",
+                    "requestBody": {
+                        "content": {
+                            "application/x-www-form-urlencoded": {
+                                "schema": {
+                                    "anyOf": [
+                                        {"$ref": "#/components/schemas/UserForm"},
+                                        {"$ref": "#/components/schemas/CompanyForm"},
+                                    ],
+                                    "title": "Data",
+                                }
+                            }
+                        },
+                        "required": True,
+                    },
+                    "responses": {
+                        "200": {
+                            "description": "Successful Response",
+                            "content": {"application/json": {"schema": {}}},
+                        },
+                        "422": {
+                            "description": "Validation Error",
+                            "content": {
+                                "application/json": {
+                                    "schema": {
+                                        "$ref": "#/components/schemas/HTTPValidationError"
+                                    }
+                                }
+                            },
+                        },
+                    },
+                }
+            }
+        },
+        "components": {
+            "schemas": {
+                "CompanyForm": {
+                    "properties": {
+                        "company_name": {"type": "string", "title": "Company Name"},
+                        "industry": {"type": "string", "title": "Industry"},
+                    },
+                    "type": "object",
+                    "required": ["company_name", "industry"],
+                    "title": "CompanyForm",
+                },
+                "HTTPValidationError": {
+                    "properties": {
+                        "detail": {
+                            "items": {"$ref": "#/components/schemas/ValidationError"},
+                            "type": "array",
+                            "title": "Detail",
+                        }
+                    },
+                    "type": "object",
+                    "title": "HTTPValidationError",
+                },
+                "UserForm": {
+                    "properties": {
+                        "name": {"type": "string", "title": "Name"},
+                        "email": {"type": "string", "title": "Email"},
+                    },
+                    "type": "object",
+                    "required": ["name", "email"],
+                    "title": "UserForm",
+                },
+                "ValidationError": {
+                    "properties": {
+                        "loc": {
+                            "items": {
+                                "anyOf": [{"type": "string"}, {"type": "integer"}]
+                            },
+                            "type": "array",
+                            "title": "Location",
+                        },
+                        "msg": {"type": "string", "title": "Message"},
+                        "type": {"type": "string", "title": "Error Type"},
+                    },
+                    "type": "object",
+                    "required": ["loc", "msg", "type"],
+                    "title": "ValidationError",
+                },
+            }
+        },
+    }