mirror/fastapi
1
0
Fork 0
mirror of https://github.com/fastapi/fastapi.git synced 2026-05-04 13:44:20 -04:00
Code Issues Packages Projects Releases Wiki Activity

📝 Update source examples and docs from Python 3.9 to 3.10 (#14900)

Browse Source
This commit is contained in:
Sebastián Ramírez
2026-02-12 05:19:43 -08:00
committed by GitHub
parent d06ab3f5c7
commit c9e2277d8b
655 changed files with 3703 additions and 5660 deletions
Download Patch File Download Diff File Expand all files Collapse all files

13
docs_src/query_params_str_validations/tutorial001_py39.py
View File

@@ -1,13 +0,0 @@
from typing import Union
from fastapi import FastAPI
app = FastAPI()
@app.get("/items/")
async def read_items(q: Union[str, None] = None):
results = {"items": [{"item_id": "Foo"}, {"item_id": "Bar"}]}
if q:
results.update({"q": q})
return results

13
docs_src/query_params_str_validations/tutorial002_an_py39.py
View File

@@ -1,13 +0,0 @@
from typing import Annotated, Union
from fastapi import FastAPI, Query
app = FastAPI()
@app.get("/items/")
async def read_items(q: Annotated[Union[str, None], Query(max_length=50)] = None):
results = {"items": [{"item_id": "Foo"}, {"item_id": "Bar"}]}
if q:
results.update({"q": q})
return results

15
docs_src/query_params_str_validations/tutorial003_an_py39.py
View File

@@ -1,15 +0,0 @@
from typing import Annotated, Union
from fastapi import FastAPI, Query
app = FastAPI()
@app.get("/items/")
async def read_items(
q: Annotated[Union[str, None], Query(min_length=3, max_length=50)] = None,
):
results = {"items": [{"item_id": "Foo"}, {"item_id": "Bar"}]}
if q:
results.update({"q": q})
return results

15
docs_src/query_params_str_validations/tutorial003_py39.py
View File

@@ -1,15 +0,0 @@
from typing import Union
from fastapi import FastAPI, Query
app = FastAPI()
@app.get("/items/")
async def read_items(
q: Union[str, None] = Query(default=None, min_length=3, max_length=50),
):
results = {"items": [{"item_id": "Foo"}, {"item_id": "Bar"}]}
if q:
results.update({"q": q})
return results

17
docs_src/query_params_str_validations/tutorial004_an_py39.py
View File

@@ -1,17 +0,0 @@
from typing import Annotated, Union
from fastapi import FastAPI, Query
app = FastAPI()
@app.get("/items/")
async def read_items(
q: Annotated[
Union[str, None], Query(min_length=3, max_length=50, pattern="^fixedquery$")
] = None,
):
results = {"items": [{"item_id": "Foo"}, {"item_id": "Bar"}]}
if q:
results.update({"q": q})
return results

17
docs_src/query_params_str_validations/tutorial004_py39.py
View File

@@ -1,17 +0,0 @@
from typing import Union
from fastapi import FastAPI, Query
app = FastAPI()
@app.get("/items/")
async def read_items(
q: Union[str, None] = Query(
default=None, min_length=3, max_length=50, pattern="^fixedquery$"
),
):
results = {"items": [{"item_id": "Foo"}, {"item_id": "Bar"}]}
if q:
results.update({"q": q})
return results

17
docs_src/query_params_str_validations/tutorial004_regex_an_py310.py
View File

@@ -1,17 +0,0 @@
from typing import Annotated
from fastapi import FastAPI, Query
app = FastAPI()
@app.get("/items/")
async def read_items(
q: Annotated[
str | None, Query(min_length=3, max_length=50, regex="^fixedquery$")
] = None,
):
results = {"items": [{"item_id": "Foo"}, {"item_id": "Bar"}]}
if q:
results.update({"q": q})
return results

4
docs_src/query_params_str_validations/tutorial002_py39.py → docs_src/query_params_str_validations/tutorial005_an_py310.py
View File

@@ -1,4 +1,4 @@
from typing import Union
from typing import Annotated
from fastapi import FastAPI, Query
@@ -6,7 +6,7 @@ app = FastAPI()
@app.get("/items/")
async def read_items(q: Union[str, None] = Query(default=None, max_length=50)):
async def read_items(q: Annotated[str, Query(min_length=3)] = "fixedquery"):
results = {"items": [{"item_id": "Foo"}, {"item_id": "Bar"}]}
if q:
results.update({"q": q})

4
docs_src/query_params_str_validations/tutorial009_py39.py → docs_src/query_params_str_validations/tutorial005_py310.py
View File

@@ -1,12 +1,10 @@
from typing import Union
from fastapi import FastAPI, Query
app = FastAPI()
@app.get("/items/")
async def read_items(q: Union[str, None] = Query(default=None, alias="item-query")):
async def read_items(q: str = Query(default="fixedquery", min_length=3)):
results = {"items": [{"item_id": "Foo"}, {"item_id": "Bar"}]}
if q:
results.update({"q": q})

4
docs_src/query_params_str_validations/tutorial006c_py39.py → docs_src/query_params_str_validations/tutorial006_an_py310.py
View File

@@ -1,4 +1,4 @@
from typing import Union
from typing import Annotated
from fastapi import FastAPI, Query
@@ -6,7 +6,7 @@ app = FastAPI()
@app.get("/items/")
async def read_items(q: Union[str, None] = Query(min_length=3)):
async def read_items(q: Annotated[str, Query(min_length=3)]):
results = {"items": [{"item_id": "Foo"}, {"item_id": "Bar"}]}
if q:
results.update({"q": q})

4
docs_src/query_params_str_validations/tutorial006c_an_py39.py → docs_src/query_params_str_validations/tutorial006_py310.py
View File

@@ -1,12 +1,10 @@
from typing import Annotated, Union
from fastapi import FastAPI, Query
app = FastAPI()
@app.get("/items/")
async def read_items(q: Annotated[Union[str, None], Query(min_length=3)]):
async def read_items(q: str = Query(min_length=3)):
results = {"items": [{"item_id": "Foo"}, {"item_id": "Bar"}]}
if q:
results.update({"q": q})

15
docs_src/query_params_str_validations/tutorial007_an_py39.py
View File

@@ -1,15 +0,0 @@
from typing import Annotated, Union
from fastapi import FastAPI, Query
app = FastAPI()
@app.get("/items/")
async def read_items(
q: Annotated[Union[str, None], Query(title="Query string", min_length=3)] = None,
):
results = {"items": [{"item_id": "Foo"}, {"item_id": "Bar"}]}
if q:
results.update({"q": q})
return results

15
docs_src/query_params_str_validations/tutorial007_py39.py
View File

@@ -1,15 +0,0 @@
from typing import Union
from fastapi import FastAPI, Query
app = FastAPI()
@app.get("/items/")
async def read_items(
q: Union[str, None] = Query(default=None, title="Query string", min_length=3),
):
results = {"items": [{"item_id": "Foo"}, {"item_id": "Bar"}]}
if q:
results.update({"q": q})
return results

22
docs_src/query_params_str_validations/tutorial008_an_py39.py
View File

@@ -1,22 +0,0 @@
from typing import Annotated, Union
from fastapi import FastAPI, Query
app = FastAPI()
@app.get("/items/")
async def read_items(
q: Annotated[
Union[str, None],
Query(
title="Query string",
description="Query string for the items to search in the database that have a good match",
min_length=3,
),
] = None,
):
results = {"items": [{"item_id": "Foo"}, {"item_id": "Bar"}]}
if q:
results.update({"q": q})
return results

20
docs_src/query_params_str_validations/tutorial008_py39.py
View File

@@ -1,20 +0,0 @@
from typing import Union
from fastapi import FastAPI, Query
app = FastAPI()
@app.get("/items/")
async def read_items(
q: Union[str, None] = Query(
default=None,
title="Query string",
description="Query string for the items to search in the database that have a good match",
min_length=3,
),
):
results = {"items": [{"item_id": "Foo"}, {"item_id": "Bar"}]}
if q:
results.update({"q": q})
return results

13
docs_src/query_params_str_validations/tutorial009_an_py39.py
View File

@@ -1,13 +0,0 @@
from typing import Annotated, Union
from fastapi import FastAPI, Query
app = FastAPI()
@app.get("/items/")
async def read_items(q: Annotated[Union[str, None], Query(alias="item-query")] = None):
results = {"items": [{"item_id": "Foo"}, {"item_id": "Bar"}]}
if q:
results.update({"q": q})
return results

26
docs_src/query_params_str_validations/tutorial010_an_py39.py
View File

@@ -1,26 +0,0 @@
from typing import Annotated, Union
from fastapi import FastAPI, Query
app = FastAPI()
@app.get("/items/")
async def read_items(
q: Annotated[
Union[str, None],
Query(
alias="item-query",
title="Query string",
description="Query string for the items to search in the database that have a good match",
min_length=3,
max_length=50,
pattern="^fixedquery$",
deprecated=True,
),
] = None,
):
results = {"items": [{"item_id": "Foo"}, {"item_id": "Bar"}]}
if q:
results.update({"q": q})
return results

24
docs_src/query_params_str_validations/tutorial010_py39.py
View File

@@ -1,24 +0,0 @@
from typing import Union
from fastapi import FastAPI, Query
app = FastAPI()
@app.get("/items/")
async def read_items(
q: Union[str, None] = Query(
default=None,
alias="item-query",
title="Query string",
description="Query string for the items to search in the database that have a good match",
min_length=3,
max_length=50,
pattern="^fixedquery$",
deprecated=True,
),
):
results = {"items": [{"item_id": "Foo"}, {"item_id": "Bar"}]}
if q:
results.update({"q": q})
return results

4
docs_src/query_params_str_validations/tutorial011_an_py39.py → docs_src/query_params_str_validations/tutorial012_an_py310.py
View File

@@ -1,4 +1,4 @@
from typing import Annotated, Union
from typing import Annotated
from fastapi import FastAPI, Query
@@ -6,6 +6,6 @@ app = FastAPI()
@app.get("/items/")
async def read_items(q: Annotated[Union[list[str], None], Query()] = None):
async def read_items(q: Annotated[list[str], Query()] = ["foo", "bar"]):
query_items = {"q": q}
return query_items

9
docs_src/query_params_str_validations/tutorial012_py310.py Normal file
View File

@@ -0,0 +1,9 @@
from fastapi import FastAPI, Query
app = FastAPI()
@app.get("/items/")
async def read_items(q: list[str] = Query(default=["foo", "bar"])):
query_items = {"q": q}
return query_items

4
docs_src/query_params_str_validations/tutorial011_py39.py → docs_src/query_params_str_validations/tutorial013_an_py310.py
View File

@@ -1,4 +1,4 @@
from typing import Union
from typing import Annotated
from fastapi import FastAPI, Query
@@ -6,6 +6,6 @@ app = FastAPI()
@app.get("/items/")
async def read_items(q: Union[list[str], None] = Query(default=None)):
async def read_items(q: Annotated[list, Query()] = []):
query_items = {"q": q}
return query_items

9
docs_src/query_params_str_validations/tutorial013_py310.py Normal file
View File

@@ -0,0 +1,9 @@
from fastapi import FastAPI, Query
app = FastAPI()
@app.get("/items/")
async def read_items(q: list = Query(default=[])):
query_items = {"q": q}
return query_items

15
docs_src/query_params_str_validations/tutorial014_an_py39.py
View File

@@ -1,15 +0,0 @@
from typing import Annotated, Union
from fastapi import FastAPI, Query
app = FastAPI()
@app.get("/items/")
async def read_items(
hidden_query: Annotated[Union[str, None], Query(include_in_schema=False)] = None,
):
if hidden_query:
return {"hidden_query": hidden_query}
else:
return {"hidden_query": "Not found"}

15
docs_src/query_params_str_validations/tutorial014_py39.py
View File

@@ -1,15 +0,0 @@
from typing import Union
from fastapi import FastAPI, Query
app = FastAPI()
@app.get("/items/")
async def read_items(
hidden_query: Union[str, None] = Query(default=None, include_in_schema=False),
):
if hidden_query:
return {"hidden_query": hidden_query}
else:
return {"hidden_query": "Not found"}

30
docs_src/query_params_str_validations/tutorial015_an_py39.py
View File

@@ -1,30 +0,0 @@
import random
from typing import Annotated, Union
from fastapi import FastAPI
from pydantic import AfterValidator
app = FastAPI()
data = {
"isbn-9781529046137": "The Hitchhiker's Guide to the Galaxy",
"imdb-tt0371724": "The Hitchhiker's Guide to the Galaxy",
"isbn-9781439512982": "Isaac Asimov: The Complete Stories, Vol. 2",
}
def check_valid_id(id: str):
if not id.startswith(("isbn-", "imdb-")):
raise ValueError('Invalid ID format, it must start with "isbn-" or "imdb-"')
return id
@app.get("/items/")
async def read_items(
id: Annotated[Union[str, None], AfterValidator(check_valid_id)] = None,
):
if id:
item = data.get(id)
else:
id, item = random.choice(list(data.items()))
return {"id": id, "name": item}